Messenger di Facebook

Utilizzando l'integrazione di Dialogflow con Facebook Messenger, puoi creare un bot di Facebook Messenger per interagire con i tuoi utenti finali.

Limitazioni

Questa integrazione supporta solo la lingua predefinita dell'agente

Come funziona

Ecco come funziona l'integrazione:

Configurazione

Per configurare l'integrazione:

  1. Segui i passaggi per creare un'app Facebook: Sviluppo di app Facebook.

  2. Configura l'app Facebook in modo che utilizzi la piattaforma Facebook Messenger. Segui i passaggi descritti nella documentazione Configurare l'app Facebook per eseguire le seguenti operazioni:

    • Aggiungi la piattaforma Messenger alla tua app Facebook.
    • Abbonati alla tua app a una pagina Facebook. In questo passaggio ti viene fornito un token di accesso. Copia questo valore. Questo token viene utilizzato per configurare l'integrazione dalla console di Dialogflow.
    • Non configurare ancora il webhook o testare l'integrazione.

  3. Configura l'integrazione dalla console di Dialogflow:

    1. Vai alla console di Dialogflow ES.
    2. Fai clic su Integrazioni nel menu della barra laterale a sinistra.
    3. Fai clic su Facebook Messenger.

    4. Si apre una finestra di dialogo di configurazione:

      • Mostra il vecchio URL di callback: se questo pulsante di attivazione/disattivazione è visualizzato, è disattivato per impostazione predefinita. Si tratta di un'opzione temporanea per adattarsi a una recente modifica dell'API Facebook Messenger. Non modificare questo pulsante di attivazione/disattivazione, a meno che non ti venga indicato dall'assistenza di Dialogflow. Una volta aggiornati tutti gli agenti, questa opzione viene rimossa.
      • URL di callback: copia questo valore. Viene utilizzato per configurare il webhook di Facebook Messenger.
      • Token di verifica: puoi inserire qualsiasi token privato di cui hai bisogno. Copia questo valore. Viene utilizzato per configurare il webhook di Facebook Messenger.
      • Token di accesso alla pagina: Inserisci il token di accesso che hai copiato durante la creazione della pagina Facebook.
      • Avvia: fai clic per avviare questo servizio di integrazione per il tuo agente.

  4. Completa la configurazione dell'app Facebook e testala. Segui i passaggi descritti nella documentazione Configurare l'app Facebook per eseguire le seguenti operazioni:

    • Configura il webhook di Facebook per la tua app. Utilizza i valori URL di callback e Token di verifica che hai copiato in precedenza. Assicurati di attivare messaggi e messaging_postbacks.
    • Testa l'app.

Eventi

I seguenti eventi vengono richiamati da questa integrazione:

Evento Descrizione
FACEBOOK_WELCOME Si attiva quando un utente finale avvia una conversazione con il tuo bot.

Messaggi di risposta avanzati

Questa integrazione traduce alcuni messaggi di risposta avanzati in tipi di messaggi della piattaforma Facebook Messenger.

Risposte con immagini

Le risposte con immagini vengono inviate a Facebook Messenger come messaggi con allegati di file di Facebook Messenger. Il valore message.attachment.type è impostato su image. Sono supportati i seguenti formati:

  • jpg
  • png
  • gif statica
  • gif animata

Risposte con schede

Le risposte con schede vengono inviate a Facebook Messenger come modelli generici di Facebook Messenger.

Risposte con risposte rapide

Le risposte con risposte rapide vengono inviate a Facebook Messenger come risposte rapide di Facebook Messenger.

Risposte con payload personalizzati

Per inviare altri tipi di messaggi di Facebook Messenger, puoi utilizzare un payload personalizzato.

Il formato generale del payload personalizzato è il seguente:

{
  "facebook": {
    message
  }
}

Al posto di message, fornisci l'oggetto message di Facebook Messenger. Per i dettagli dell'oggetto message, consulta il riferimento dell'API Facebook Messenger.

Ad esempio:

  • Invia un link audio: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • Invia un video riproducibile: 
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • Invia un file: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}