Messenger di Facebook

L'integrazione di Dialogflow con Facebook Messenger ti consente di creare un bot di Facebook Messenger per interagire con gli utenti finali.

Nota: quando utilizzi un'integrazione di terze parti, le richieste e i dati degli utenti finali vengono inviati sia a Google sia alla terza parte. I termini di servizio, lo SLA, i prezzi e le quote per la tua edizione dell'agente sono applicabili alla gestione di queste richieste da parte di Google. I termini di servizio, lo SLA, i prezzi e le quote della terza parte sono applicabili alla gestione di queste richieste da parte della terza parte.

Limitazioni

Questa integrazione supporta solo la lingua predefinita dell'agente.

Come funziona

L'integrazione funziona nel seguente modo:

1. Crea un'app Facebook che utilizzi la piattaforma Facebook Messenger.
2. Configura l'integrazione di Dialogflow e l'app Facebook in modo che comunichino tra loro.
3. L'integrazione di Dialogflow invia messaggi all'utente finale utilizzando l' API Facebook Messenger.
4. L'integrazione di Dialogflow riceve messaggi dall'utente finale fungendo da webhook di Facebook Messenger.

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 Dialogflow.
   • Non configurare ancora il webhook o testare l'integrazione.

3. Configura l'integrazione dalla console Dialogflow:

   1. Vai alla console Dialogflow ES.
   2. Fai clic su Integrazioni nel menu della barra laterale.
   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 viene 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:

• FACEBOOK_WELCOME: attivato quando un utente finale avvia una conversazione con il tuo bot.

Messaggi di risposta avanzati

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

Risposte con immagini

Le risposte con immagini vengono inviate a Facebook Messenger come messaggi di 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 la documentazione di 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"
        }
      }
    }
  }