Messenger di Meta

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

Come funziona

Ecco come funziona l'integrazione:

• Crea un'app Meta che utilizza la Meta Messenger Platform.
• Configura l'integrazione di Conversational Agents (Dialogflow CX) e l'app Meta in modo che comunichino tra loro.
• L'integrazione di Conversational Agents (Dialogflow CX) invia messaggi all'utente finale utilizzando l'API Meta Messenger.
• L'integrazione di Conversational Agents (Dialogflow CX) riceve i messaggi dall'utente finale fungendo da webhook Meta per la piattaforma Messenger.

Configurazione

Per configurare l'integrazione:

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

2. Configura l'app Meta per utilizzare la piattaforma Meta Messenger. Segui i passaggi indicati nella documentazione relativa ai webhook Meta per la piattaforma Messenger per eseguire le seguenti operazioni:

   • Aggiungi la piattaforma Messenger alla tua app Meta.
   • Abbonati alla tua app a una pagina Meta. Assicurati che messages e messaging_postbacks siano attivati nell'abbonamento alla pagina.
   • In questo passaggio ti viene fornito un token di accesso. Copia questo valore. Questo token viene utilizzato per configurare l'integrazione dalla console di Conversational Agents (Dialogflow CX).
   • Non configurare ancora il webhook o testare l'integrazione.

3. Configura l'integrazione dalla console di Conversational Agents (Dialogflow CX):

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

   5. Si apre una finestra di dialogo di configurazione:

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

      • Token di verifica: puoi inserire qualsiasi token privato. Copia questo valore. Viene utilizzato per configurare l'webhook Meta Messenger.

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

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

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

      • Avvia: fai clic per avviare questo servizio di integrazione per il tuo agente.

4. Completa la configurazione dell'app Meta e testala. Segui i passaggi descritti nella documentazione relativa ai webhook Meta per la piattaforma Messenger per eseguire le seguenti operazioni:

   • Configura il webhook Meta per la tua app. Utilizza i valori URL webhook e Verifica token che hai copiato sopra. Assicurati di attivare messages e messaging_postbacks nell'abbonamento alla pagina.
   • Testa la tua app.

Eventi

Questa integrazione richiama i seguenti eventi. Puoi creare gestori di eventi personalizzati per definire cosa fare quando vengono attivati gli eventi.

Pulsante Inizia

Per configurare il pulsante Inizia di Meta Messenger:

1. Attiva/disattiva l'opzione Attiva il pulsante Inizia quando attivi questo servizio di integrazione.

   • Questo servizio di integrazione attiva il pulsante chiamando l'API Profilo di Messenger.

     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 provarlo:

1. Elimina la conversazione precedente con la tua pagina Meta (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 del gestore eventi personalizzato.

Puoi sempre chiamare l'API Profilo di Messenger per gestire il pulsante Inizia. Questa opzione può 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 Custom Payload in Fulfillment. Per il formato del messaggio, consulta Oggetto messaggio per l'invio di parametri API.

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

{
  "text": "Hello, world"
}

Il seguente payload personalizzato fornisce un messaggio con immagine:

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

Risposte specifiche per canale

Dopo aver configurato le risposte specifiche per canale, il canale DF_CX_FB_MESSENGER viene utilizzato automaticamente quando l'agente risponde ai messaggi di Meta Messenger.