Messenger di Facebook

Utilizzando l'integrazione Dialogflow Facebook Messenger, puoi creare un bot Facebook Messenger per interagire con gli 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 per utilizzare la piattaforma Facebook Messenger. Segui i passaggi descritti nella documentazione Configurazione dell'app Facebook per eseguire le seguenti operazioni:

    • Aggiungi la piattaforma Messenger alla tua app Facebook.
    • Iscrivi la 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 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 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 richiesto dall'assistenza 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.
      • Verifica token: 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 Configurazione dell'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 sopra. Assicurati di attivare messaggi e messaging_postbacks.
    • Testa la tua 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 Facebook Messenger. Il valore di message.attachment.type è impostato su image. Sono supportati i seguenti formati:

  • jpg
  • png
  • static gif
  • GIF animata

Risposte delle schede

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

Risposte rapide

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

Risposte di payload personalizzate

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 API di Facebook Messenger.

Ad esempio:

  • Inviare 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"
      }
    }
  }
}
  • Inviare un file: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}