Messenger di Meta

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

Come funziona

Ecco come funziona l'integrazione:

  • Crei un'app di meta che utilizza Piattaforma Meta Messenger.
  • Configura l'integrazione degli agenti conversazionali (Dialogflow CX) e l'app Meta in modo che comunichino tra loro.
  • L'integrazione degli agenti conversazionali (Dialogflow CX) invia messaggi all'utente finale utilizzando l'API Meta Messenger.
  • L'integrazione degli agenti conversazionali (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 le passaggi nella Webhook di Meta per la piattaforma Messenger documentazione necessaria per:

    • 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 Agent di conversazione (Dialogflow CX).
    • Non configurare ancora il webhook o non testare l'integrazione.

  3. Configura l'integrazione dalla console degli agenti conversazionali (Dialogflow CX):

    1. Vai alla console Dialogflow CX.
    2. Fai clic sulla scheda Gestisci nel riquadro di sinistra.
    3. Fai clic su Integrations (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 segreto dell'app da Impostazioni di base della dashboard dell'app.

      • Verifica token: puoi inserire il token privato che desideri. Copia questo valore. Utilizzato per configurare Meta Messenger Webhook.

      • Token di accesso alla pagina. Inserisci il token di accesso che hai copiato durante la Configurazione della meta-app in alto.

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

      • URL webhook: copia questo valore. Viene utilizzato per configurare 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 descritti nella documentazione di Meta Webhooks 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.

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 di un utente finale contiene allegati (ad es. audio, immagini, video e così via).

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 personalizzati per evento FACEBOOK_WELCOME.

Per testarlo:

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

    • Il pulsante Inizia viene visualizzato solo per le nuove conversazioni.

  2. Avvia una nuova conversazione con la tua pagina di meta.

  3. Fai clic sul pulsante Inizia e verifica la risposta dal prompt di gestione degli eventi.

Puoi sempre chiamare API Messenger Profile 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 Payload personalizzato in Completamento. 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 immagine:

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

Risposte specifiche per canale

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