Collega un bot Botpress a WhatsApp con Coexistence
Usa l'integrazione WhatsApp di Botpress in Manual Configuration. Incolla l'access token e il phone number id del numero connesso, scegli un verify token e lascia vuoti App ID e Client Secret. Poi imposta l'URL del webhook di Botpress e quel verify token come destinazione del webhook del numero: Meta consegna ogni messaggio al bot.
Il campo Client Secret di Botpress: se resta vuoto, la verifica della firma del webhook viene saltata.
I campi webhook a cui si iscrive la guida di Botpress, inclusi i messaggi e gli aggiornamenti di stato dei template.
La finestra di assistenza clienti che si apre con un messaggio del cliente, entro cui puoi inviare qualsiasi messaggio di servizio.
Quale configurazione di Botpress funziona con un numero Coexistence?
Manual Configuration. Le altre opzioni collegano un numero tramite l'app Meta di Botpress, che è una registrazione separata del numero e non un modo per usarne uno già connesso.
Nell'integrazione WhatsApp apri il menu a tendina Configuration e scegli Manual Configuration. Richiede un Verify Token, un Access Token, un Default Bot Phone Number ID e, in modo facoltativo, un App ID, un Client Secret e un WABA ID.
L'access token, il phone number id e il WABA id vengono dalla connessione: la dashboard li mostra e get_api_credentials li restituisce a un assistente. Il verify token è una stringa qualsiasi a tua scelta. App ID e Client Secret restano vuoti. La guida di Botpress presenta il secret come un campo da compilare, ma la definizione della sua integrazione lo segna come facoltativo e dice che, senza, la verifica della firma viene saltata. Conta, perché Meta firma ogni consegna con l'app secret del Tech Provider, che nessun cliente possiede.
Come riceve Botpress i messaggi da Meta tramite il webhook?
Attraverso la destinazione del webhook del numero. La guida di Botpress ti fa incollare il suo URL del webhook e il tuo verify token nella configurazione WhatsApp di un'app Meta. Qui non c'è nessuna app Meta tua: Meta instrada gli eventi del numero verso la destinazione indicata nella connessione. Quindi copia l'URL del webhook che Botpress mostra per l'integrazione e impostalo, con lo stesso verify token, come destinazione nella dashboard o con set_webhook_destination.
Meta invia un GET di verifica, Botpress risponde e la consegna parte. Quando Botpress salva una configurazione manuale controlla anche il token, chiedendo a Graph quale app lo ha emesso: un token non valido o revocato fallisce al salvataggio e non al primo messaggio.
Il gestore di Botpress elabora anche smb_message_echoes, l'evento che Meta invia quando qualcuno risponde dall'app WhatsApp Business. Così una risposta dal telefono è visibile al bot e non gli resta nascosta.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
Cosa deve sapere il bot su Coexistence?
Che una persona potrebbe già essere nella conversazione. L'app WhatsApp Business continua a funzionare sul numero, quindi un cliente può ricevere una risposta dal telefono e una dal bot nello stesso minuto. Decidi nel flusso cosa succede quando arriva un echo: la maggior parte dei team mette in pausa il bot per quel contatto per un po', così chi è intervenuto non viene scavalcato.
La seconda cosa è il tempo. Un bot che risponde ai messaggi in arrivo lavora dentro la finestra di assistenza clienti di 24 ore, dove il testo libero è consentito. Un flusso che invia qualcosa un giorno dopo, un follow-up o un promemoria, richiede un template approvato, e il testo libero in quel caso restituisce l'errore 131047. La guida di Botpress si iscrive ai campi di stato dei template proprio per questo tipo di messaggio proattivo.
Infine, la velocità massima è fissa a 20 messaggi al secondo per un numero Coexistence, molto più di quanto invia un bot conversazionale.
Errori comuni
- Compilare Client Secret con il secret della tua app Meta. La firma non corrisponde mai e Botpress risponde a ogni consegna con 401.
- Scegliere l'opzione OAuth o sandbox al posto di Manual Configuration. Collegano un numero tramite l'app di Botpress, non quello già connesso.
- Ignorare gli echo. Senza una regola per le risposte inviate dal telefono, il bot risponde sopra una persona già intervenuta.
Connetti il numero su easycoexistence.com, incolla il suo token e il phone number id nella Manual Configuration di Botpress e imposta l'URL del webhook di Botpress come destinazione. Da US$ 9 per numero al mese, fino a US$ 1 man mano che si aggiungono numeri, con i primi 3 giorni gratuiti.
Domande frequenti
Saltare il controllo della firma è sicuro?
Sposta la protezione sull'URL. Botpress genera l'URL del webhook per ogni integrazione, quindi tienilo riservato. I contenuti multimediali vanno comunque scaricati da Meta con il token, cosa che un evento falsificato non può imitare.
Lo stesso numero può alimentare anche n8n?
Un numero ha una sola destinazione del webhook. Puntala verso un sistema e inoltra da lì gli eventi se ne serve un secondo.
Botpress ha bisogno del mio WABA id?
La sua definizione lo segna come facoltativo per ora e dice che diventerà obbligatorio in una futura versione major, quindi compilalo con i dati della connessione.
I messaggi passano da EasyCoexistence?
No. Meta consegna direttamente all'URL del webhook di Botpress e il contenuto non viene mai memorizzato da noi.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il