Un numero.L’app e l’API, nello stesso momento.
La Coexistence è la modalità ufficiale di Meta per usare contemporaneamente l’app WhatsApp Business e la Cloud API sullo stesso numero. Il team continua a rispondere dal telefono, con le stesse chat e la stessa cronologia, mentre il software invia e riceve sulla stessa linea.
EasyCoexistence collega il numero e poi monitora la connessione.
La scelta che prima esisteva, e ora non più
La Coexistence non è una nuova API. È la scomparsa di un bivio che impediva a quasi ogni piccola azienda di automatizzare qualsiasi cosa.
Il team risponde dal telefono. Niente si può automatizzare, collegare o misurare.
Niente APIIl software raggiunge il numero. L’app Business smette di funzionare su quel numero e il team cambia strumento.
Niente appMeta collega la Cloud API a un numero che l’app WhatsApp Business continua a usare. Entrambe le superfici sono attive sulla stessa linea, e ognuna vede ciò che l’altra invia.
Chi usa un numero in questo modo
Due gruppi che vogliono cose opposte dalla stessa funzione, ed è per questo che la connessione conta più di qualsiasi dashboard costruita sopra.
Un team piccolo, un numero stampato su un furgone o su una vetrina, e serate passate a rispondere alle stesse quattro domande. Non vogliono sostituire nessuno. Vogliono che conferme, promemoria e la prima risposta fuori orario avvengano senza una persona, mentre il telefono continua a servire per tutto il resto.
Molti clienti, ognuno con un numero che nessuno può migrare o toccare. Hanno bisogno che quei numeri siano raggiungibili dai sistemi che costruiscono, e di aggiungere il successivo senza una call commerciale. La Coexistence è l’unica via ufficiale verso un numero a cui il personale del cliente risponde ancora a mano.
Come un numero finisce su entrambi, e dove vanno gli eventi dei messaggi
Quattro passaggi. L’unico che tocca il telefono è una scansione, e quello che decide la tua architettura è il primo.
Prepara l’endpoint prima che inizi l’onboarding
Meta verifica una destinazione prima di consegnarle qualcosa. Chiama il tuo URL con una richiesta GET che contiene hub.mode=subscribe, il tuo hub.verify_token e un hub.challenge, e il tuo endpoint deve restituire l’hub.challenge così come l’ha ricevuto.
La destinazione deve essere HTTPS, e il token di verifica è obbligatorio. Li controlliamo entrambi prima che la chiamata parta, così un URL malformato fallisce alla nostra porta invece di sembrare collegato e non consegnare nulla.
Non c’è ancora nulla di collegato. Questo decide dove arriveranno i messaggi. Fornitore nel percorsoSalvati sui loro serverLa loro piattaformaRiceve e salva i messaggiTuUna copia, con i loro tempiEasyCoexistenceSolo configurazioneIl tuo endpointNon ancora verificatoNoiImpostiamo il percorso, ma non ci stiamo sopraAvvia l’Embedded Signup di Meta e scansiona nell’app
Si apre il popup di Meta. Scegli il Business Portfolio, il WhatsApp Business Account e il numero già registrato nell’app WhatsApp Business, poi approvi la connessione sul telefono scansionando un codice.
È qui che scegli anche se condividere la cronologia delle chat esistente. È una decisione presa una sola volta durante l’onboarding e non si può cambiare in seguito. L’app Business continua a funzionare non appena la scansione è completata.
Compare la seconda superficie. La prima non viene rimossa. Dopo una migrazioneUna superficieSolo Cloud APIApp Business morta su questo numeroDopo la CoexistenceDue superficiApp WhatsApp BusinessStesse chat e stessa cronologiaCloud APISulla stessa lineaIndirizza gli eventi dei messaggi al tuo sistema
Meta consente a un’app di sovrascrivere la destinazione a cui vengono consegnati i webhook di un determinato WhatsApp Business Account. Impostiamo quell’override sul tuo URL, e così i due campi del percorso dei messaggi, messages e smb_message_echoes, vanno direttamente da Meta a te.
Noi teniamo i campi operativi, perché è di questi che è fatto il monitoraggio: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update e phone_number_name_update. Così la dashboard resta utile mentre il contenuto delle conversazioni non passa mai da noi.
Quali eventi vanno dove, una volta attivo l’override. Eventi operativiConsegnati a noiPercorso dei messaggiConsegnati a temessagesTutto ciò che invia un clientesmb_message_echoesCiò che il team invia dall’appIl tuo serverDirettamente, mai attraverso di noiTienilo attivo, e sopravvivi a una riconnessione
Meta disconnette un numero in Coexistence dopo circa quattordici giorni senza attività sul dispositivo principale. Quella disconnessione si risolve ricollegando il numero, e la registriamo come uno stato a sé invece di trattarla come un cliente che se ne va.
La parte che coglie tutti di sorpresa è cosa fa una disconnessione al percorso. Meta salva la destinazione come override sulla sottoscrizione della nostra app all’account, quindi un PARTNER_REMOVED disinstalla l’app e si porta via anche l’override. Ricollegare ripristina l’invio e il monitoraggio, ma non la tua destinazione. La reimpostiamo automaticamente, perché il primo numero che ha incontrato questa regola si è ricollegato senza problemi e ha smesso, in silenzio, di consegnare al server del cliente.
Cosa ripristina da sola una riconnessione, e cosa va rimesso a posto. Ripristinato da MetaAutomaticoInvioLa Cloud API torna a funzionareEventi operativiIl monitoraggio riprendePerso con l’appVa riapplicatoIl tuo override del webhookDisinstallato con l’appConsegna dei messaggi a teSi ferma in silenzioLo riapplichiamo noiA ogni riconnessione
Perché i team usano un numero in questo modo
- Tenere il numero già stampato su furgoni, ricevute e sito web, e il flusso di lavoro da mobile che ci gira intorno.
- Aggiungere l’invio tramite API, l’elaborazione dei webhook e i template senza spostare nessuno su un nuovo strumento.
- Tenere il traffico dei messaggi fuori dalla casella condivisa di un fornitore, così le conversazioni non restano sulla piattaforma di qualcun altro.
- Dare a un’agenzia un modo per gestire i numeri di molti clienti in un solo account, ognuno collegato nel Business Portfolio del cliente stesso.
Requisiti e limiti pratici
- Il numero deve essere già attivo nell’app WhatsApp Business. Un numero sull’app WhatsApp per uso personale deve prima essere spostato lì.
- Condividere la cronologia delle chat esistente è una scelta che si fa una sola volta durante l’onboarding e non si può cambiare in seguito.
- Le chat di gruppo sono escluse dall’API sui numeri in Coexistence, con qualsiasi fornitore.
- Il dispositivo principale ha bisogno di attività periodica. Meta disconnette la connessione dopo circa quattordici giorni senza.
- I percorsi di verifica e di badge di Meta sono diversi per i numeri in Coexistence, e la disponibilità per regione cambia con le policy di Meta.
Cosa instradiamo a te, e cosa teniamo noi
Meta permette a un’app di sovrascrivere la destinazione a cui un WhatsApp Business Account consegna i suoi webhook. Impostiamo quell’override sul tuo URL, e così gli eventi si dividono in due.
messagesTutto ciò che un cliente invia al numerosmb_message_echoesCiò che il tuo team invia dall’app WhatsApp Business
account_updateStato della connessione: rimossa, dismessa, ricollegata, limitataphone_number_quality_updateVariazioni di valutazione della qualità e di throughputaccount_alertsAvvisi che Meta solleva sull’accountaccount_review_updateEsiti di una revisione di Metabusiness_capability_updateVariazioni del limite di messaggi e delle funzionalitàphone_number_name_updateApprovazioni e rifiuti del nome visualizzato
Se un numero non ha un override impostato, i suoi eventi di messaggio ricadono sul nostro callback predefinito, dove l’handler li scarta senza salvarli. È imposto nel codice, non promesso in una policy: non esiste un percorso di archiviazione che il contenuto delle conversazioni possa seguire.
La regola dei quattordici giorni, e ciò che rompe senza che nessuno lo dica
Meta disconnette una connessione Coexistence dopo circa quattordici giorni senza attività sul dispositivo principale. Si può ricollegare, quindi la registriamo come stato a sé invece di contarla come un cliente che se ne è andato.
La conseguenza che costa cara arriva dopo. La destinazione dei tuoi messaggi non è un’impostazione del numero, è un override sulla sottoscrizione della nostra app al WhatsApp Business Account. Una disconnessione disinstalla l’app, e l’override se ne va con lei. Ricolleghi, l’invio funziona, il monitoraggio funziona, e i messaggi smettono di arrivare al tuo server senza che nulla segnali un errore.
Riapplichiamo l’override a ogni ricollegamento. Questo comportamento esiste perché è successo: un numero ha incontrato questa regola, si è ricollegato senza problemi e ha smesso di consegnare in silenzio.
Se l’handshake fallisce in quel momento, perché il tuo server era giù o il token è cambiato, viene registrato nella cronologia della connessione e la destinazione viene conservata invece che scartata, quindi basta salvarla di nuovo per risolvere.
Cosa si rompe in silenzio, e come ce ne accorgiamo
L’app WhatsApp Business continua a funzionare in quasi tutti i guasti qui sotto, ed è per questo che nessuno se ne accorge. Questi sono quelli che controlliamo, e come.
Rilevato dal webhook account_update di Meta, nello specifico PARTNER_REMOVED, invece che dedotto da un campo che diventa false. Di proposito non leggiamo is_on_biz_app per questo, perché è legittimamente false sui numeri che non sono in Coexistence e causava false disconnessioni.
La regola di inattività del dispositivo principale di Meta. Si può ricollegare, quindi viene registrata come stato a sé e non come un cliente che se ne è andato, e il ricollegamento ripristina invio e monitoraggio.
La destinazione esiste come override sulla sottoscrizione della nostra app all’account, quindi una disconnessione la disinstalla. L’invio torna al ricollegamento, la consegna al tuo server no. Riapplichiamo l’override ogni volta, perché un numero a cui è successo si è ricollegato senza problemi e ha smesso di consegnare in silenzio.
Teniamo il token del cliente e il nostro System User token sullo stesso account. Quando uno viene rifiutato, l’altro legge l’account e stabilisce quale dei due si è davvero rotto, così un token revocato non sembra più un numero perso.
Interrogata da Meta a intervalli regolari. Una valutazione RED segna la connessione come degradata, e qualità, livello di messaggistica e livello di throughput vengono salvati a ogni controllo, così un calo è visibile prima che costi un invio.
Collegare un numero e sorvegliare un numero sono prodotti diversi. Il secondo è il motivo per cui questo esiste.
Tempo tipico per collegare un numero, scansionando un codice dall’app WhatsApp Business.
Per quanto tempo la risposta di un cliente mantiene aperta la sessione per le risposte in testo libero.
Volume di invio per un numero in Coexistence, fissato da Meta e non aumentabile.
Quanta cronologia delle chat Meta sincronizza con l’API quando un numero viene collegato per la prima volta.
Domande frequenti
Il mio team deve smettere di usare il telefono?
No. È proprio questo il senso della Coexistence. L’app WhatsApp Business continua a funzionare sullo stesso numero, con le stesse conversazioni, mentre l’API opera insieme ad essa.
Perderò le conversazioni esistenti?
No. Restano nell’app e, quando il numero viene collegato, Meta sincronizza circa sei mesi di cronologia con l’API, così il software dispone del contesto invece di partire da zero.
Posso annullare il collegamento?
Sì. Un numero può essere scollegato e l’app continua a funzionare come prima. Il collegamento non modifica permanentemente il numero.
È la stessa cosa delle API WhatsApp non ufficiali?
No, e la differenza determina se il numero resterà attivo. La Coexistence è una funzionalità ufficiale di Meta sulla Cloud API. I gateway non ufficiali usano WhatsApp Web come dispositivo collegato, violano i termini e fanno bannare i numeri.
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuita3 giorni gratis. Non paghi nulla fino alla fine della prova.