Messenger di Meta

Utilizzando 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 piattaforma Meta Messenger.
• 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 dell'utente finale fungendo da webhook di 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 descritti nella documentazione Webhook Meta per la piattaforma Messenger per eseguire le seguenti operazioni:

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

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

   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 a sinistra.
   4. Fai clic sul pulsante Connetti nel riquadro Meta Messenger.

   5. Si apre una finestra di dialogo di configurazione:

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

      • Verifica token: puoi inserire qualsiasi token privato. Copia questo valore. Viene utilizzato per configurare il webhook di 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 Webhook di Meta per la piattaforma Messenger per eseguire le seguenti operazioni:

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

Eventi

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

Pulsante Inizia

Per configurare il pulsante Inizia di Meta Messenger:

1. Attiva/disattiva Attiva pulsante Inizia quando attivi questo servizio di integrazione.

   • Questo servizio di integrazione abilita il pulsante 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 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 di eventi personalizzato.

Puoi sempre chiamare l'API del profilo Messenger per gestire il pulsante Inizia. Questa opzione 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 Custom Payload in Fulfillment. Per il formato del messaggio, consulta Send API Parameters Message Object.

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 il 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.