Messenger di Facebook

Grazie all'integrazione di Dialogflow Facebook Messenger, puoi creare un bot Facebook Messenger per interagire con gli utenti finali.

Limitazioni

Solo la lingua predefinita dell'agente è supportata da questa integrazione.

Come funziona

Ecco come funziona l'integrazione:

Configurazione

Per configurare l'integrazione:

  1. Segui i passaggi per creare un'app Facebook: Facebook App Development.

  2. Configura l'app Facebook per l'utilizzo della piattaforma Facebook Messenger. Segui i passaggi nella documentazione relativa alla configurazione dell'app Facebook per eseguire le seguenti operazioni:

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

  3. Configura l'integrazione dalla console di Dialogflow:

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

    4. Si apre una finestra di dialogo di configurazione:

      • Mostra vecchio URL di callback: se viene mostrata, l'opzione è disattivata per impostazione predefinita. Si tratta di un'opzione temporanea per consentire una recente modifica all'API Facebook Messenger. Non modificare questa opzione a meno che non venga richiesto dall'assistenza Dialogflow. Dopo aver aggiornato tutti gli agenti, questa opzione verrà rimossa.
      • Callback URL (URL di callback): copia questo valore. che verrà utilizzato per configurare il webhook di Facebook Messenger.
      • Verifica token: puoi inserire il token privato che preferisci. Copia questo valore. che verrà utilizzato per configurare il webhook di Facebook Messenger.
      • Page Access Token: inserisci il token di accesso che hai copiato durante la creazione della pagina Facebook.
      • Avvia: fai clic per avviare il servizio di integrazione per l'agente.

  4. Completa la configurazione dell'app di Facebook e testala. Segui i passaggi nella documentazione relativa alla configurazione dell'app Facebook per eseguire le seguenti operazioni:

    • Configura il webhook Facebook per la tua app. Utilizza i valori URL di callback e Verifica token che hai copiato in precedenza. Assicurati di attivare messages 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 converte alcuni messaggi di risposta avanzata in tipi di messaggi di Facebook Messenger Platform.

Risposte immagine

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

  • jpg
  • png
  • GIF statica
  • GIF animata

Risposte scheda

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

Risposte rapide

Le risposte di risposta rapida vengono inviate a Facebook Messenger come risposte rapide di Facebook Messenger.

Risposte payload personalizzate

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

Il formato generale del payload personalizzato è simile al 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 sull'API Facebook Messenger.

Ad esempio:

  • Invia un link audio: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • Inviare 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"
      }
    }
  }
}