Alcuni prodotti e funzionalità sono in fase di rinominazione. Anche le funzionalità di playbook e flusso generativi sono in fase di migrazione a un'unica console consolidata. Consulta i dettagli.

Messenger di Meta

Utilizzando l'integrazione di Meta Messenger, puoi creare un bot di 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 Dialogflow CX e l'app Meta in modo che comunichino tra loro.
L'integrazione di Dialogflow CX invia messaggi all'utente finale utilizzando l' API Meta Messenger.
L'integrazione di Dialogflow CX riceve i messaggi dell'utente finale fungendo da webhook Meta per la piattaforma Messenger.

Configurazione

Per configurare l'integrazione:

Segui i passaggi per creare un'app Meta: Sviluppo di app Meta.
Configura l'app Meta in modo che utilizzi la piattaforma Meta Messenger. Segui i passaggi descritti nella documentazione dei 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 abilitati 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 Dialogflow CX.
- Non configurare ancora il webhook o testare l'integrazione.
Configura l'integrazione dalla console di Dialogflow CX:
1. Vai alla console di 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 sul 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 che preferisci. 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.
  - Abilita pulsante Inizia: consulta la sezione Pulsante Inizia.
  - URL webhook: copia questo valore. Viene utilizzato per configurare il webhook di Meta Messenger.
  - Start: fai clic per avviare questo servizio di integrazione per il tuo agente.
Completa la configurazione dell'app Meta e testala. Segui i passaggi descritti nella documentazione dei 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 Verify token che hai copiato sopra. Assicurati di abilitare messages e messaging_postbacks nell'abbonamento alla 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 di un utente finale contiene allegati (ad es. audio, immagine, video e così via).

Pulsante Inizia

Per configurare il pulsante Inizia di Meta Messenger:

Attiva/disattiva Enable get started button (Abilita pulsante Inizia) quando abiliti questo servizio di integrazione.
- Questo servizio di integrazione abilita 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}"
```
Crea un gestore di eventi personalizzato per FACEBOOK_WELCOME evento.

Per testarlo:

Elimina la conversazione precedente con la tua pagina Meta (se applicabile).
- Il pulsante Inizia viene visualizzato solo nelle nuove conversazioni.
Avvia una nuova conversazione con la tua pagina Meta.
Fai clic sul pulsante Inizia e verifica la risposta del gestore di eventi personalizzato.

Puoi sempre chiamare l'API Messenger Profile per gestire il pulsante Inizia. Questo potrebbe essere utile per i 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 (Payload personalizzato) in Fulfillment. Per il formato del messaggio, consulta Oggetto messaggio dei parametri dell'API Send.

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 del canale

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