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 il lingua predefinita dell'agente è supportato da questa integrazione.

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 relativa alla configurazione dell'app Facebook per:

    • Aggiungi la piattaforma Messenger all'app di 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 non testare l'integrazione.

  3. Configura l'integrazione dalla console Dialogflow:

    1. Vai alla console di 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 questa opzione a meno che non venga richiesto dall'assistenza Dialogflow. Dopo aver aggiornato tutti gli agenti, questa opzione verrà rimossa.
      • URL di callback: copia questo valore. Verrà utilizzato per configurare il webhook di Facebook Messenger.
      • Verifica token: Puoi inserire il token privato che desideri. Copia questo valore. Verrà utilizzato per configurare il webhook di Facebook Messenger.
      • Page Access Token (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 il webhook di Facebook per la tua app. Utilizza i valori Callback URL (URL di callback) e Verify Token (Verifica token) che hai copiato in precedenza. Assicurati di attivare messages e messaging_postbacks.
    • Testa la tua app.

Eventi

I seguenti eventi sono 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 messaggi di risposta avanzata messaggi a Tipi di messaggi della piattaforma Facebook Messenger

Risposte immagine

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

  • jpg
  • png
  • gif statica
  • GIF animata

Risposte delle schede

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

Risposte rapide

Risposte rapide vengono inviati 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 è 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"
      }
    }
  }
}
  • 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"
      }
    }
  }
}