Esegui un flusso Typebot su WhatsApp con Coexistence
Il canale WhatsApp di Typebot richiede un token, l'id del WhatsApp Business Account e l'id del numero di telefono, poi ti dà un callback URL e un verify token. Compila i primi tre con i dati del numero connesso, lascia vuoto l'app secret facoltativo di Typebot e imposta il suo callback URL e il suo verify token come destinazione webhook del numero.
Typebot indica l'integrazione WhatsApp come funzione del piano Pro, non dei piani Free e Starter.
Typebot controlla la firma del webhook solo se insieme alle credenziali è salvato un app secret.
Il wizard di Typebot rifiuta un token la cui scadenza non è impostata su mai.
Throughput fisso per un numero usato sia con l'app WhatsApp Business sia con la Cloud API.
Quali campi di Typebot prendono i valori dal numero connesso?
Il wizard WhatsApp di Typebot, nella scheda Share di un bot, chiede quattro cose: un app secret, un System User Token, un WhatsApp Business Account ID e un Phone number ID.
Tre di questi arrivano direttamente dalla connessione. La dashboard mostra l'id del WABA, l'id del numero di telefono e il token di accesso del numero, e lo strumento get_api_credentials restituisce gli stessi valori se a recuperarli per te è un assistente. Incollali nei campi corrispondenti.
L'app secret è l'unico da lasciare vuoto. Typebot lo usa per una sola cosa sul traffico in ingresso: controllare l'header X-Hub-Signature-256 che Meta aggiunge a ogni consegna. Per un numero connesso tramite un Tech Provider, Meta firma con l'app secret del provider, che non viene mai condiviso, quindi qualsiasi valore inserito lì fa sì che Typebot rifiuti ogni messaggio autentico. Con il campo vuoto, Typebot salta il controllo e accetta la consegna.
Dove vanno il callback URL e il verify token di Typebot?
Nella destinazione webhook del numero, non nella dashboard di un'app Meta.
Il wizard di Typebot ti dice di incollare il suo Callback URL e il suo Verify Token nelle impostazioni WhatsApp della tua app Meta. Con Coexistence tramite EasyCoexistence non c'è nessuna app tua coinvolta: Meta instrada gli eventi del numero verso la destinazione impostata sulla connessione. Quindi copia entrambi i valori dall'ultimo passaggio di Typebot e impostali come destinazione, nella dashboard o con set_webhook_destination.
Meta invia poi la sua richiesta GET di verifica a Typebot, Typebot risponde con il challenge e da quel momento ogni messaggio al numero arriva al bot. Il verify token di Typebot è monouso: viene eliminato dal database di Typebot nel momento in cui una verifica va a buon fine. Se in seguito imposti di nuovo la destinazione, genera prima un token nuovo eseguendo ancora il wizard.
Che cosa fa il bot con la finestra di 24 ore?
Typebot risponde a persone che gli hanno scritto, e questo mantiene quasi tutti i messaggi dentro la finestra del servizio clienti. Meta apre una finestra di 24 ore ogni volta che un cliente scrive, e al suo interno qualsiasi tipo di messaggio di servizio si può inviare senza template. Un bot che si limita a rispondere è quindi il caso facile.
Il limite è un flusso che aspetta. Un blocco Wait, o una sessione che riprende dopo che il cliente è rimasto in silenzio per più di un giorno, proverà a inviare un testo libero fuori dalla finestra, e Meta lo rifiuta con l'errore 131047. Il timeout di scadenza della sessione di Typebot, 4 ore per impostazione predefinita e configurabile fino a 48, decide quando un cliente che torna avvia una nuova chat, non se Meta accetta il messaggio.
Poiché si tratta di Coexistence, il team vede comunque ogni conversazione nell'app WhatsApp Business e può intervenire dal telefono ogni volta che il bot non deve rispondere.
Errori comuni
- Incollare in Typebot l'app secret di un'app Meta. Le consegne sono firmate con il secret del Tech Provider, quindi Typebot rifiuta ogni messaggio come firma non valida.
- Riutilizzare un vecchio verify token di Typebot. Viene eliminato dopo una verifica riuscita, quindi per impostare di nuovo la destinazione ne serve uno nuovo dal wizard.
- Condividere il callback URL. Con il controllo della firma disattivato, conoscere l'URL è ciò che permette a una richiesta di entrare, quindi trattalo come una password.
Connetti il numero su easycoexistence.com, copia token, id del WABA e id del numero di telefono in Typebot e imposta il callback URL di Typebot come destinazione webhook. Da US$ 9 per numero al mese, fino a US$ 1 man mano che aggiungi numeri, con i primi 3 giorni gratuiti.
Domande frequenti
Mi serve una mia app Meta per Typebot?
No. La guida di Typebot ne presuppone una perché la maggior parte delle persone connette un numero da sola. Con Coexistence tramite un Tech Provider, token e id arrivano dalla connessione e Meta instrada il webhook verso Typebot.
Il team vedrà comunque i messaggi del bot sul telefono?
Sì. I messaggi inviati tramite la Cloud API compaiono nell'app WhatsApp Business sullo stesso numero, quindi una persona può leggere la conversazione e subentrare.
Typebot e n8n possono ricevere entrambi i messaggi dello stesso numero?
No. Un numero ha una sola destinazione webhook. Se servono gli eventi a entrambi, punta la destinazione su n8n e fai inoltrare al workflow il payload grezzo al callback URL di Typebot.
Typebot conserva le conversazioni?
Typebot mantiene i propri dati di sessione e di risultati, come su qualsiasi canale. EasyCoexistence non archivia mai il contenuto dei messaggi: Meta consegna direttamente alla destinazione che imposti.
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