Vai alla navigazione

Strumenti WhatsApp

Consenti al tuo agente di inviare messaggi su WhatsApp con gli strumenti

Panoramica

Puoi fornire al tuo agente uno strumento per inviare messaggi su WhatsApp, anche durante le conversazioni su un altro canale, ad esempio il telefono.

L’integrazione WhatsApp offre tre strumenti:

  • Invia messaggio — invia un messaggio modello a qualsiasi utente WhatsApp. Funziona da qualsiasi canale, quindi un agente telefonico può, ad esempio, inviare una conferma al WhatsApp del chiamante. Questa pagina tratta questo strumento.
  • Invia pulsanti interattivi e Invia elenco interattivo — offrono all’utente di una conversazione WhatsApp attiva opzioni selezionabili con un tocco. Funzionano solo all’interno delle conversazioni di messaggistica WhatsApp: consulta i messaggi interattivi.

Configurazione

1

Importa il tuo account

Segui le istruzioni qui per importare il tuo account WhatsApp Business.

2

Aggiungi un'integrazione

Vai alla pagina Integrazioni, fai clic sul pulsante _Aggiungi integrazione _, seleziona WhatsApp e collega il tuo account:

Integrazione WhatsApp
3

Aggiungi uno strumento

Vai alla pagina Strumenti, fai clic sul pulsante _Aggiungi strumento di integrazione _, seleziona l’integrazione WhatsApp e lo strumento _ Invia messaggio _:

Strumento WhatsApp

Usare lo strumento

1

Crea un modello di messaggio

Vai a WhatsApp Manager, apri la pagina Gestisci modelli e crea un modello di messaggio:

Modello di messaggio WhatsApp
Al momento lo strumento supporta solo i parametri nel corpo del messaggio.
2

Configura il tuo agente

Vai alla configurazione del tuo agente e aggiungi lo strumento:

Configurazione dell'agente: strumenti

Nel system prompt, indica all’agente:

  • quando usare lo strumento
  • quale nome del modello e codice lingua usare
  • quali parametri passare
Configurazione dell'agente: prompt
3

Test

Testa la configurazione dello strumento:

Conversazione di test
Messaggio di test ricevuto

Parametri e codici lingua

Lo strumento compila solo i parametri del corpo del modello: i modelli con intestazioni o pulsanti parametrizzati non sono supportati da questo strumento. Il destinatario è un ID utente WhatsApp: solo cifre, con prefisso internazionale e senza + (ad esempio 14155552671). Consulta le regole sul formato del numero del destinatario per le particolarità specifiche dei vari Paesi.

Il codice lingua del modello deve corrispondere alla lingua con cui il modello è stato creato in WhatsApp Manager: consulta i codici lingua supportati. Un errore comune è passare en per un modello creato come en_US (o viceversa); Meta li considera modelli diversi.

Risoluzione dei problemi

  • Modello non trovato: il nome del modello o il codice lingua non corrisponde esattamente a quello in WhatsApp Manager, oppure il modello appartiene a un account WhatsApp Business diverso da quello collegato.
  • Messaggio accettato ma non consegnato: il modello non è approvato, manca un parametro del corpo oppure l’account ha problemi di pagamento. Consulta Risoluzione dei problemi e domande frequenti.
  • L’agente passa parametri errati: indica nel system prompt i nomi esatti dei parametri del modello e i valori previsti, e fornisci un esempio di invocazione.