Usa un numero Coexistence come inbox WhatsApp Cloud di Chatwoot
L'inbox WhatsApp Cloud di Chatwoot chiede tre valori: l'ID dell'account WhatsApp Business, l'ID del numero di telefono e un token di accesso. Un numero Coexistence li espone tutti e tre. Crea l'inbox con questi valori, poi imposta come destinazione del webhook del numero l'URL del webhook di Chatwoot, con lo stesso token di verifica: il team potrà rispondere sia da Chatwoot sia dal telefono.
ID WABA, ID del numero di telefono e un token di accesso: è ciò che chiede la configurazione manuale di WhatsApp Cloud in Chatwoot.
Chatwoot gestisce questo evento di Coexistence, quindi le risposte inviate dall'app WhatsApp Business compaiono nella conversazione.
Meta permette a un numero di telefono aziendale di avere un proprio URL di callback del webhook, che sostituisce quello predefinito dell'app.
Come si collega un numero Coexistence a Chatwoot?
In due posti, in quest'ordine.
In Chatwoot, aggiungi un'inbox, scegli WhatsApp e seleziona il provider WhatsApp Cloud con la configurazione manuale. Inserisci il numero, l'ID del numero di telefono, l'ID dell'account WhatsApp Business e il token di accesso: la dashboard di EasyCoexistence mostra tutti questi valori per la connessione, oppure get_api_credentials li restituisce a un assistente. Chatwoot mostra poi un URL del webhook e un token di verifica del webhook per l'inbox.
In EasyCoexistence, imposta come destinazione del webhook del numero quell'URL e inserisci lo stesso token di verifica. Meta invia la richiesta di verifica a Chatwoot, Chatwoot risponde e da quel momento ogni messaggio verso il numero arriva nell'inbox. Non c'è nulla in mezzo, quindi nessun workflow da tenere in vita.
Le risposte inviate dal telefono compaiono in Chatwoot?
Sì. Su un numero Coexistence, una risposta scritta nell'app WhatsApp Business viene segnalata da Meta come evento smb_message_echoes. Il job del webhook di Chatwoot riconosce quel campo e registra il messaggio come in uscita nella conversazione giusta. Il suo codice sorgente descrive il caso in modo diretto: aziende che rispondono sia da Chatwoot sia dall'app, con i messaggi sincronizzati su Chatwoot.
È questo che fa funzionare la divisione nella pratica. Il titolare può continuare a rispondere ai clienti abituali dal telefono, il team può lavorare l'inbox condivisa dalla scrivania, e ognuno vede ciò che ha inviato l'altro senza che nessuno inoltri screenshot.
I messaggi inviati da Chatwoot partono tramite la Cloud API sullo stesso numero, quindi compaiono anche sul telefono.
Perché l'inbox di Chatwoot non deve avere un app secret?
Perché le consegne sono firmate con un secret che non hai. Meta firma ogni webhook con l'app secret dell'app che possiede la sottoscrizione, cioè l'app di EasyCoexistence, e quel secret non viene mai condiviso.
Nel codice attuale di Chatwoot, l'intestazione X-Hub-Signature-256 su un canale WhatsApp Cloud configurato manualmente viene controllata solo se sul canale è stato salvato un app secret, oppure se il canale è stato creato con l'embedded signup di Chatwoot. Un'inbox manuale senza app secret accetta le consegne; una con un app secret qualsiasi le rifiuta tutte come non autorizzate.
La protezione che vale qui è il token di verifica. Scegli un valore lungo e casuale, perché è ciò che permette a Chatwoot di distinguere la richiesta di verifica di Meta da quelle di chiunque altro.
Cosa non può fare Chatwoot su questo numero?
Ricevere i webhook in un secondo posto nello stesso momento. Meta instrada i webhook di un numero verso una sola destinazione, quindi finché Chatwoot la occupa, un workflow n8n non riceverà gli stessi eventi. Se ti servono entrambi, punta la destinazione a un piccolo relay tuo che inoltra ogni consegna a Chatwoot e al workflow.
I limiti di Coexistence valgono come ovunque: l'API invia fino a 20 messaggi al secondo, il testo libero parte solo entro 24 ore dall'ultimo messaggio del cliente, e i template coprono tutto ciò che viene dopo.
L'app WhatsApp Business va comunque aperta almeno una volta ogni 14 giorni, e EasyCoexistence lo monitora.
Errori comuni
- Inserire un app secret nell'inbox di Chatwoot. Le consegne sono firmate con il secret dell'app EasyCoexistence, quindi Chatwoot le rifiuta tutte come non autorizzate.
- Usare in EasyCoexistence un token di verifica diverso da quello mostrato da Chatwoot. La verifica di Meta fallisce e l'inbox non riceve mai un messaggio.
- Scegliere l'embedded signup di Chatwoot invece del flusso manuale. Così il numero si collega tramite l'app Meta di Chatwoot, una connessione separata.
Collega il numero su easycoexistence.com, copia le sue credenziali in un'inbox WhatsApp Cloud di Chatwoot e imposta la destinazione del webhook su Chatwoot. Da US$ 9 per numero al mese, fino a US$ 1 man mano che aggiungi numeri, con 3 giorni di prova gratuita.
Domande frequenti
Funziona con Chatwoot self-hosted?
Sì. L'URL del webhook usa il tuo dominio Chatwoot al posto di app.chatwoot.com, e il resto della configurazione è identico.
Mi serve una mia app Meta per Chatwoot?
No. Il numero si collega tramite EasyCoexistence, che fornisce le credenziali e instrada i webhook. La guida di Chatwoot descrive la creazione di un'app Meta solo perché dà per scontato che tu non ne abbia una.
Posso collegare più numeri a Chatwoot?
Sì. Crea un'inbox WhatsApp Cloud per ogni numero e imposta come destinazione del webhook di ciascun numero l'URL e il token di verifica della sua inbox.
EasyCoexistence vede le conversazioni?
No. Meta consegna i webhook direttamente a Chatwoot, ed EasyCoexistence non memorizza mai il contenuto delle conversazioni.
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