Messenger di Meta

Utilizzando l'integrazione di Meta Messenger, puoi creare un bot di Meta Messenger per interagire con i tuoi utenti.

Come funziona

Ecco come funziona l'integrazione:

Configurazione

Assicurati che la fatturazione sia abilitata per il tuo progetto prima di testare l'integrazione.

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 abilitati nell'iscrizione alla pagina.
    • Copia il token di accesso fornito in questo passaggio. Questo token viene utilizzato per configurare l'integrazione dalla console Dialogflow CX.
    • Non configurare ancora il webhook e non testare l'integrazione.
  3. Configura l'integrazione dalla console Dialogflow CX:
    1. Vai alla console Dialogflow CX.
    2. Seleziona la scheda Gestisci nel menu di navigazione.
    3. Seleziona Integrations (Integrazioni).
    4. Fai clic sul pulsante Connetti nel riquadro Meta Messenger.
    5. Compila i campi della finestra di dialogo di configurazione:
      • App secret (Secret dell'app):inserisci il secret dell'app da App Dashboard Basic Settings (Impostazioni di base della dashboard dell'app).
      • Verifica token: inserisci un token privato di cui hai bisogno. 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.
      • Attiva il pulsante Inizia:seleziona questa casella di controllo per attivare il pulsante Inizia.
      • URL webhook:copia questo valore. Viene utilizzato per configurare il webhook di Meta Messenger.
      • Avvia: seleziona questa casella di controllo per avviare il 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 in precedenza. Assicurati di attivare messages e messaging_postbacks nell'iscrizione 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 vengono attivati gli eventi.

Evento Descrizione
FACEBOOK_WELCOME Attivato quando un utente finale fa clic sul pulsante Inizia di Meta Messenger.
FACEBOOK_MEDIA Attivato quando il messaggio di un utente finale contiene allegati (ad esempio audio, immagini o video).

Pulsante Inizia

Configura il pulsante Inizia di Meta Messenger:

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

    • Questo servizio di integrazione ti consente di attivare 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 eseguire il test:

  1. Se applicabile, elimina la conversazione precedente con la tua pagina Meta.
    • 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 chiamare l'API Messenger Profile per gestire il pulsante Inizia. Questo può essere utile per i test.

Per controllare lo stato del pulsante Inizia, utilizza la seguente richiesta:

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

Puoi utilizzare la seguente richiesta per disattivare 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 avanzata sono supportati utilizzando il payload personalizzato nel fulfillment. Per saperne di più, consulta la documentazione relativa all'oggetto messaggio dei parametri dell'API Send per il formato del messaggio.

Ad esempio, il seguente payload personalizzato fornisce un 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 il canale

Dopo aver configurato le risposte specifiche per il canale, l'agente utilizza automaticamente il canale DF_CX_FB_MESSENGER per rispondere ai messaggi di Meta Messenger.