Glossario di WhatsApp Coexistence
I termini di WhatsApp Coexistence si confondono facilmente. Spesso due persone usano la stessa parola per cose diverse. Qui trovi le definizioni adottate da questo sito, con il link alla pagina che tratta ogni termine in modo completo.
EasyCoexistence collega un numero tramite il flusso di Meta e ne monitora la connessione.
- Coexistence
La modalità ufficiale di Meta per usare l'app WhatsApp Business e la Cloud API sullo stesso numero contemporaneamente. Non è un'API separata: è la stessa Cloud API, configurata in modo che l'app continui a funzionare.
WhatsApp Coexistence- Cloud API
L'API della WhatsApp Business Platform ospitata da Meta. Ogni invio, template e webhook di questo sito passa da lì.
Cloud API o Coexistence- App WhatsApp BusinessWhatsApp Business app
L'app che un'azienda usa sul telefono. È diversa dall'app WhatsApp per i privati, e il numero deve essere su di essa prima che Coexistence possa collegarlo.
- WhatsApp Business AccountWABA
L'oggetto di Meta che contiene numeri di telefono e template. Si trova dentro un Business Portfolio. Gli override del webhook si applicano a questo livello, non al singolo numero.
- Business Portfolio
Il contenitore a livello aziendale in Meta Business Manager. Contiene uno o più WhatsApp Business Account. Il numero di un cliente resta nel suo portfolio, non in quello di un fornitore.
Meta Tech Provider- Phone number id
L'identificativo di Meta per un numero collegato. Gli invii puntano a questo, non al numero in sé, e compare in ogni payload webhook in entrata.
- Embedded Signup
Il popup di configurazione iniziale di Meta. Sceglie il portfolio, l'account e il numero e, per Coexistence, include un codice da scansionare nell'app WhatsApp Business.
Come si collega un numero- Tech Provider
Uno status di Meta che consente a un'azienda di collegare i numeri di altre aziende tramite la propria app approvata. È gratuito e richiede la verifica aziendale e l'App Review. Non è un'approvazione da parte di Meta.
Cosa significa- BSPBusiness Solution Provider
Un'azienda che vende una piattaforma di messaggistica, di solito una casella condivisa. Si sovrappone a Tech Provider, ma descrive il prodotto e non lo status presso Meta.
Coexistence o un BSP- Destinazione del webhookwebhook override
Il punto in cui Meta consegna gli eventi di un WhatsApp Business Account. Si imposta come override sull'iscrizione di un'app, ed è per questo che rimuovere una connessione la disinstalla.
Webhook di WhatsApp- hub.challenge
Un valore che Meta invia nella sua richiesta GET di verifica. L'endpoint deve restituirlo come body grezzo. Restituire JSON al suo posto è il motivo più comune per cui un webhook non riceve mai nulla.
Verifica del webhook- messages
Il campo webhook che trasporta ciò che inviano i clienti. Fa parte del percorso dei messaggi, cioè ciò che un override del webhook devia da un fornitore.
- smb_message_echoes
Il campo webhook che trasporta ciò che un team invia dall'app WhatsApp Business. Esiste solo sui numeri in Coexistence, ed è il modo in cui un software vede le risposte di una persona.
- Finestra del servizio clientila finestra di 24 ore
Ventiquattro ore dall'ultimo messaggio del cliente, durante le quali il testo libero viene consegnato. Fuori da questa finestra viene consegnato solo un template approvato.
Errore 131047- Template
Un messaggio inviato in anticipo a Meta per la revisione. È l'unica cosa che viene consegnata fuori dalla finestra del servizio clienti e, su un numero in Coexistence, può essere inviato solo tramite API.
Errore 132001- Valutazione della qualitàQuality rating
Verde, gialla o rossa, assegnata da Meta in base a come reagiscono i destinatari. Scende prima che costi qualcosa, e nulla segnala il calo.
Errore 131048- Livello di messaggisticaMessaging tier
Con quanti clienti unici un numero può avviare conversazioni al giorno. Si muove in entrambe le direzioni. È diverso dal throughput, che è una velocità.
- Throughput
Messaggi al secondo che un numero può inviare. Su un numero in Coexistence è fissato da Meta, invece di crescere con la qualità e il livello.
Errore 130429- Dispositivo collegatoLinked device
Il client WhatsApp per privati connesso altrove, come fa WhatsApp Web. È ciò che automatizzano gli strumenti non ufficiali, ciò che i termini di WhatsApp vietano e ciò che fa bannare i numeri.
Rischi delle API non ufficiali- MCPModel Context Protocol
Il modo in cui un assistente AI raggiunge uno strumento che non gli appartiene. Solo richiesta e risposta: un server MCP non può essere attivato da un messaggio in arrivo.
Server MCP per WhatsApp
Perché il lessico crea così tanti problemi?
Perché diversi termini indicano elementi a livelli differenti, anche se sembrano appartenere allo stesso livello.
Un Business Portfolio contiene un WhatsApp Business Account, che contiene numeri di telefono, ognuno con un phone number id. Nelle conversazioni, tutti e quattro vengono chiamati account. Una frase come controlla se l'account funziona può quindi indicare quattro verifiche diverse. Lo stesso accade con le due finestre di ventiquattro ore di questa piattaforma: misurano cose non correlate e vengono continuamente scambiate.
L'altra metà del problema è che Meta e i fornitori usano parole diverse per la stessa cosa, e nemmeno i fornitori concordano tra loro. Questa pagina usa il lessico di Meta quando esiste e dichiara chiaramente quando un termine è nostro.
Quali distinzioni contano davvero nella pratica?
Tre, e ciascuna è già costata una giornata di lavoro a qualcuno.
La finestra del servizio clienti e la finestra di sincronizzazione durano entrambe ventiquattro ore, ma non hanno nulla in comune. La prima stabilisce se il testo libero viene consegnato, a partire dall'ultimo messaggio del cliente. La seconda stabilisce se la cronologia della chat può ancora essere trasferita, a partire dalla configurazione iniziale.
Un dispositivo collegato non è un'API. È il client WhatsApp per utenti, connesso altrove. È ciò che automatizzano gli strumenti non ufficiali e che può far bannare i numeri.
Una destinazione del webhook non è un'impostazione del numero. È una sovrascrittura della sottoscrizione di un'app a un account. Per questo scompare quando viene rimossa una connessione e deve essere ripristinata alla riconnessione.
Domande frequenti
Coexistence è un'API diversa dalla Cloud API?
No. Coexistence è un modo per configurare un numero sulla Cloud API lasciando attiva l'app WhatsApp Business. Gli endpoint, il formato del messaggio e le regole sono identici.
Qual è la differenza tra un Business Portfolio e un WABA?
Il Business Portfolio è il contenitore dell'azienda a livello Meta Business Manager. Un WhatsApp Business Account si trova al suo interno e contiene i numeri di telefono. Un portfolio può contenere diversi WABA.
Un BSP è la stessa cosa di un Tech Provider?
Si sovrappongono, ma indicano cose diverse. Tech Provider è uno stato Meta che consente a un'azienda di collegare i numeri di altre aziende tramite la propria app. BSP indica di solito un'azienda che vende una piattaforma di messaggistica, ma che può avere o meno quello stato.
Cosa c'entra MCP con WhatsApp?
Nulla di intrinseco. MCP è un protocollo che permette a un assistente AI di accedere a uno strumento, mentre un server MCP di WhatsApp espone un numero come uno di questi strumenti. Non può ricevere messaggi: può agire solo quando gli viene richiesto.
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaNessun addebito per 3 giorni. Annulla quando vuoi.