Messenger di Facebook

Con l'integrazione di Dialogflow con Facebook Messenger, puoi creare un bot di Facebook Messenger per interagire con i tuoi 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 la procedura per creare un'app Facebook: Sviluppo di app per Facebook.

  2. Configura l'app Facebook per utilizzare la piattaforma Facebook Messenger. Segui i passaggi descritti nella documentazione relativa alla configurazione dell'app Facebook per:

    • 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 verrà 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 Integrations (Integrazioni) nel menu della barra laterale a sinistra.
    3. Fai clic su Facebook Messenger.

    4. Si apre una finestra di dialogo di configurazione:

      • Mostra l'URL di callback precedente: se questo pulsante di attivazione/disattivazione è visualizzato, il valore predefinito è Off. Si tratta di un'opzione temporanea per supportare una recente modifica all'API Facebook Messenger. Non modificare questo pulsante di attivazione/disattivazione, a meno che non ti venga indicato dall'assistenza Dialogflow. Dopo l'aggiornamento di tutti gli agenti, questa opzione verrà rimossa.
      • URL di callback: copia questo valore. Verrà utilizzato per configurare l'webhook di Facebook Messenger.
      • Token di verifica: puoi inserire qualsiasi token privato. Copia questo valore. Verrà utilizzato per configurare l'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 relativa alla configurazione dell'app Facebook per:

    • Configura l'webhook di Facebook per la tua app. Utilizza i valori URL di callback e Token di verifica che hai copiato sopra. Assicurati di attivare messages 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 avanzata in tipi di messaggi della piattaforma Facebook Messenger.

Risposte con immagini

Le risposte con immagini vengono inviate a Facebook Messenger come messaggi con allegato 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 alle 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 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 informazioni dettagliate sull'oggetto message, consulta il riferimento all'API 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"
      }
    }
  }
}
  • Invia un file: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}