Messenger di Meta

Utilizzando l'integrazione di Dialogflow Meta Messenger, puoi creare un bot di Meta Messenger per interagire con gli utenti finali.

Come funziona

Ecco come funziona l'integrazione:

Configurazione

Per configurare l'integrazione:

  1. Segui i passaggi per creare un'app Meta: Sviluppo di meta app.

  2. Configura l'app Meta per l'utilizzo della piattaforma Meta Messenger. Segui i passaggi nella documentazione su Meta Webhooks for Messenger Platform per eseguire le seguenti operazioni:

    • Aggiungi Messenger Platform alla tua app Meta.
    • Iscrivere la tua app a una pagina Meta. Assicurati che messages e messaging_postbacks siano abilitati nell'abbonamento alla pagina.
    • 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 il webhook o non testare l'integrazione.

  3. Configura l'integrazione dalla console di Dialogflow:

    1. Vai alla console Dialogflow CX.
    2. Fai clic sulla scheda Gestisci nel riquadro a sinistra.
    3. Fai clic su Integrazioni nel menu della barra laterale sinistra.
    4. Fai clic sul pulsante Connetti nel riquadro Meta Messenger.

    5. Si apre una finestra di dialogo di configurazione:

      • App secret: inserisci il secret dell'app dalle Impostazioni di base della dashboard dell'app.

      • Verifica token: puoi inserire il token privato che preferisci. Copia questo valore. Verrà utilizzato per configurare il webhook Meta Messenger.

      • Token di accesso alla pagina: inserisci il token di accesso che hai copiato durante la configurazione dell'app Meta in alto.

      • Attiva il pulsante Inizia: consulta la sezione Pulsante Inizia.

      • URL webhook: copia questo valore. Verrà utilizzato per configurare il webhook di Meta Messenger.

      • Avvia: fai clic per avviare il servizio di integrazione per l'agente.

  4. Completa la configurazione dell'app Meta e testala. Segui i passaggi nella documentazione relativa a Meta Webhooks for Messenger Platform per eseguire quanto segue:

    • Configura il webhook di meta per l'app. Utilizza i valori URL webhook e Verifica token che hai copiato in precedenza. Assicurati di abilitare messages e messaging_postbacks nell'abbonamento della pagina.
    • Testa l'app.

Eventi

I seguenti eventi vengono richiamati da questa integrazione. Puoi creare gestori di eventi personalizzati per definire cosa fare quando vengono attivati gli eventi.

Evento Descrizione
FACEBOOK_WELCOME Si attiva quando un utente finale fa clic sul pulsante Inizia di Meta Messenger.
FACEBOOK_MEDIA Si attiva quando il messaggio inviato da un utente finale contiene allegati (ad esempio audio, immagini, video e così via).

Pulsante Inizia

Per configurare il pulsante Inizia di Meta Messenger:

  1. Attiva/disattiva il pulsante Abilita Inizia quando abiliti questo servizio di integrazione.

    • Questo servizio di integrazione attiverà il pulsante per te chiamando l'API Messenger Profile.

      curl -X POST \
-H "Content-Type: application/json" \
-d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

  2. Crea un gestore di eventi personalizzato per l'evento FACEBOOK_WELCOME.

Per verificarlo:

  1. Elimina la conversazione precedente con la tua Meta page (se applicabile).

    • Il pulsante Inizia viene visualizzato solo nelle nuove conversazioni.

  2. Avvia una nuova conversazione con la tua pagina Meta.

  3. Fai clic sul pulsante Inizia e verifica la risposta dal gestore di eventi personalizzato.

Puoi sempre chiamare l'API Messenger Profile per gestire il pulsante Inizia. Potrebbe essere utile per il test.

Ad esempio, la seguente richiesta controlla lo stato del pulsante Inizia:

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

La seguente richiesta disattiva il pulsante Inizia:

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

Messaggi di risposta avanzati

I messaggi di risposta avanzati sono supportati tramite Payload personalizzato in Fulfillment. Per il formato del messaggio, consulta Send API Parameters Message Object per il formato del messaggio.

Ad esempio, il seguente payload personalizzato fornisce un semplice messaggio di testo:

{
  "text": "Hello, world"
}

Il seguente payload personalizzato fornisce un messaggio immagine:

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

Risposte specifiche per i canali

Se configurato, risposte specifiche per il canale con il canale DF_CX_FB_MESSENGER verranno utilizzate automaticamente quando l'agente risponde ai messaggi di Meta Messenger.