Eén nummer.De app en de API, tegelijk.
Coexistence is Meta's officiële modus om de WhatsApp Business-app en Cloud API tegelijk op één nummer te gebruiken. Het team blijft antwoorden vanaf de telefoon, met dezelfde chats en dezelfde geschiedenis, terwijl software via diezelfde lijn verzendt en ontvangt.
EasyCoexistence koppelt het nummer en bewaakt daarna de verbinding.
De keuze die vroeger bestond, en nu niet meer
Coexistence is geen nieuwe API. Het is het verdwijnen van een splitsing die bijna elk klein bedrijf ervan weerhield om ook maar iets te automatiseren.
Het team antwoordt vanaf de telefoon. Niets kan worden geautomatiseerd, gekoppeld of gemeten.
Geen APISoftware kan het nummer bereiken. De Business-app werkt er niet meer op en het team stapt over op een ander hulpmiddel.
Geen appMeta koppelt Cloud API aan een nummer dat de WhatsApp Business-app nog gebruikt. Beide kanalen zijn actief op dezelfde lijn, en elk ziet wat de ander verstuurt.
Wie een nummer zo gebruikt
Twee groepen die het tegenovergestelde willen van dezelfde functie. Daarom is de verbinding belangrijker dan welk dashboard erbovenop ook.
Een klein team, een nummer op een bestelbus of een etalage, en avonden vol met dezelfde vier vragen beantwoorden. Ze willen niemand vervangen. Ze willen dat bevestigingen, herinneringen en het eerste antwoord na sluitingstijd zonder mens gebeuren, terwijl de telefoon voor al het andere blijft werken.
Veel klanten, elk met een nummer dat niemand mag migreren of aanraken. Ze hebben die nummers nodig voor de systemen die ze bouwen, en willen het volgende toevoegen zonder salesgesprek. Coexistence is de enige officiële route naar een nummer dat het personeel van de klant nog met de hand beantwoordt.
Hoe een nummer op allebei terechtkomt, en waar de berichtevents naartoe gaan
Vier stappen. De enige die de telefoon raakt is een scan, en de stap die je architectuur bepaalt is de eerste.
Zorg dat het endpoint klaarstaat voordat de onboarding begint
Meta verifieert een bestemming voordat het daar iets aflevert. Meta roept je URL aan met een GET met hub.mode=subscribe, je hub.verify_token en een hub.challenge, en je endpoint moet de ruwe challenge ongewijzigd terugsturen.
De bestemming moet HTTPS zijn, en een verify-token is verplicht. We controleren beide voordat de aanroep plaatsvindt, zodat een ongeldige URL al bij ons strandt in plaats van gekoppeld te lijken en niets af te leveren.
Er is nog niets gekoppeld. Hier wordt bepaald waar berichten terechtkomen. Provider op het padOpgeslagen op hun serversHun platformOntvangt en bewaart berichtenJijEen kopie, op hun tijdschemaEasyCoexistenceAlleen configuratieJe endpointNog niet geverifieerdWijWe zetten de route uit, we zitten er niet opDoorloop Meta's Embedded Signup en scan in de app
Meta's eigen pop-up opent. Je kiest het Business Portfolio, het WhatsApp Business Account en het nummer dat al geregistreerd is in de WhatsApp Business-app, en keurt daarna de koppeling goed op de telefoon door een code te scannen.
Hier kies je ook of je de bestaande chatgeschiedenis deelt. Dat is een eenmalige keuze tijdens de onboarding en kan daarna niet meer worden gewijzigd. De Business-app blijft gewoon werken zodra de scan klaar is.
Het tweede kanaal verschijnt. Het eerste wordt niet weggehaald. Na een migratieEén kanaalAlleen Cloud APIBusiness-app werkt niet meer op dit nummerNa CoexistenceTwee kanalenWhatsApp Business-appDezelfde chats en geschiedenisCloud APIOp dezelfde lijnStuur de berichtevents naar je eigen systeem
Meta laat een app overschrijven waar de webhooks van een bepaald WhatsApp Business Account worden afgeleverd. Wij zetten die override op jouw URL, waardoor de twee velden van het berichtenpad, messages en smb_message_echoes, rechtstreeks van Meta naar jou gaan.
De operationele velden houden we zelf, want daar bestaat de monitoring uit: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update en phone_number_name_update. Zo blijft het dashboard bruikbaar, terwijl gespreksinhoud ons nooit raakt.
Welke events waarheen gaan zodra de override actief is. Operationele eventsAfgeleverd bij onsBerichtenpadAfgeleverd bij joumessagesAlles wat een klant stuurtsmb_message_echoesWat het team vanuit de app verstuurtJe serverRechtstreeks, nooit via onsHoud de verbinding actief, en overleef een nieuwe koppeling
Meta ontkoppelt een Coexistence-nummer na ongeveer veertien dagen zonder activiteit op het hoofdapparaat. Die ontkoppeling is opnieuw te koppelen, en we leggen haar vast als een eigen status in plaats van haar te behandelen als een klant die vertrekt.
Waar mensen tegenaan lopen, is wat een ontkoppeling met de route doet. Meta slaat de bestemming op als override op het abonnement van onze app op het account, dus een PARTNER_REMOVED verwijdert de app en neemt de override mee. Opnieuw koppelen herstelt verzenden en monitoring, maar niet je bestemming. Die zetten we automatisch terug, omdat het eerste nummer dat tegen deze regel aanliep netjes opnieuw koppelde en ongemerkt stopte met afleveren op de server van de klant.
Wat een nieuwe koppeling vanzelf herstelt, en wat teruggezet moet worden. Hersteld door MetaAutomatischVerzendenCloud API werkt weerOperationele eventsMonitoring gaat verderVerloren met de appMoet opnieuw worden gezetJe webhook-overrideVerwijderd met de appAflevering van berichten aan jouStopt ongemerktWij zetten hem opnieuwBij elke nieuwe koppeling
Waarom teams een nummer zo gebruiken
- Het nummer houden dat al op bestelbussen, bonnetjes en de website staat, met de mobiele werkwijze eromheen.
- Verzenden via de API, webhookverwerking en templates toevoegen zonder iemand naar een nieuw hulpmiddel te verhuizen.
- Het berichtenverkeer buiten de gedeelde inbox van een provider houden, zodat gesprekken niet op het platform van een ander staan.
- Een bureau de mogelijkheid geven om de nummers van veel klanten in één account te beheren, elk gekoppeld in het eigen Business Portfolio van de klant.
Voorwaarden en praktische grenzen
- Het nummer moet al actief zijn in de WhatsApp Business-app. Een nummer in de gewone WhatsApp-app moet daar eerst naartoe worden verplaatst.
- Het delen van de bestaande chatgeschiedenis is een eenmalige keuze tijdens de onboarding en kan daarna niet meer worden gewijzigd.
- Groepschats zijn bij Coexistence-nummers uitgesloten van de API, bij elke provider.
- Het hoofdapparaat heeft regelmatig activiteit nodig. Meta verbreekt de verbinding na ongeveer veertien dagen zonder.
- De verificatie- en badgeroutes van Meta verschillen voor Coexistence-nummers, en de beschikbaarheid per regio verandert met het beleid van Meta.
Wat we naar jou doorsturen, en wat we zelf houden
Meta laat een app overschrijven waar een WhatsApp Business Account zijn webhooks aflevert. Wij zetten die override op jouw URL, waardoor de events in tweeën worden gesplitst.
messagesAlles wat een klant naar het nummer stuurtsmb_message_echoesWat je team vanuit de WhatsApp Business-app verstuurt
account_updateVerbindingsstatus: verwijderd, afgemeld, opnieuw gekoppeld, beperktphone_number_quality_updateWijzigingen in kwaliteitsbeoordeling en throughputaccount_alertsWaarschuwingen die Meta voor het account afgeeftaccount_review_updateUitkomsten van een beoordeling door Metabusiness_capability_updateWijzigingen in berichtlimiet en mogelijkhedenphone_number_name_updateGoedkeuringen en afwijzingen van de weergavenaam
Heeft een nummer geen override, dan vallen de berichtevents terug op onze standaard-callback, waar de handler ze weggooit zonder ze op te slaan. Dat is in de code afgedwongen en niet in een beleid beloofd: er bestaat geen opslagpad dat gespreksinhoud kan volgen.
De veertiendagenregel, en wat die breekt zonder dat iemand het noemt
Meta verbreekt een Coexistence-verbinding na ongeveer veertien dagen zonder activiteit op het hoofdapparaat. Ze is opnieuw te koppelen, dus slaan we het op als een eigen status in plaats van het te tellen als een klant die is vertrokken.
Het gevolg dat geld kost, komt daarna. De bestemming van je berichten is geen instelling van het nummer, maar een override op het abonnement van onze app op het WhatsApp Business Account. Een ontkoppeling verwijdert de app, en de override verdwijnt mee. Je koppelt opnieuw, verzenden werkt, monitoring werkt, en berichten komen niet meer aan op je server zonder dat iets een fout meldt.
We zetten de override bij elke nieuwe koppeling opnieuw. Dat gedrag bestaat omdat het is gebeurd: een nummer liep tegen deze regel aan, koppelde netjes opnieuw en stopte ongemerkt met afleveren.
Mislukt de handshake op dat moment, omdat je server plat lag of het token veranderd was, dan wordt dat vastgelegd in de tijdlijn van de verbinding en blijft de bestemming bewaard in plaats van weggegooid. Opnieuw opslaan is dan genoeg om het op te lossen.
Wat ongemerkt kapotgaat, en hoe we het merken
De WhatsApp Business-app blijft bij bijna elke storing hieronder werken, en daarom merkt niemand het. Dit zijn de storingen die we controleren, en hoe.
Gedetecteerd via Meta's account_update-webhook, specifiek PARTNER_REMOVED, in plaats van afgeleid uit een veld dat op false springt. We lezen hiervoor bewust geen is_on_biz_app, omdat dat terecht false is bij nummers die geen Coexistence gebruiken en valse ontkoppelingen veroorzaakte.
Meta's inactiviteitsregel voor het hoofdapparaat. De verbinding is opnieuw te koppelen, dus wordt ze vastgelegd als eigen status en niet als een klant die is vertrokken, en opnieuw koppelen herstelt verzenden en monitoring.
De bestemming bestaat als override op het abonnement van onze app op het account, dus een ontkoppeling verwijdert haar. Verzenden komt terug bij opnieuw koppelen, aflevering op je server niet. We zetten de override elke keer opnieuw, omdat een nummer waarbij dit gebeurde netjes opnieuw koppelde en ongemerkt stopte met afleveren.
We houden het token van de klant en ons eigen System User token voor hetzelfde account. Wordt het ene geweigerd, dan leest het andere het account en stelt vast welke van de twee echt kapot is, zodat een ingetrokken token niet meer op een verloren nummer lijkt.
Volgens schema bij Meta opgevraagd. Een RED-beoordeling markeert de verbinding als verminderd, en kwaliteit, berichtenniveau en throughputniveau worden bij elke controle opgeslagen, zodat een daling zichtbaar is voordat die een verzending kost.
Een nummer koppelen en een nummer bewaken zijn verschillende producten. Het tweede is de reden dat dit bestaat.
Gebruikelijke tijd om een nummer te koppelen door een code in de WhatsApp Business-app te scannen.
Hoe lang een antwoord van een klant de sessie openhoudt voor vrije tekstberichten.
Verzendcapaciteit voor een Coexistence-nummer, door Meta vastgesteld en niet te verhogen.
Hoeveel chatgeschiedenis Meta naar de API synchroniseert wanneer een nummer voor het eerst wordt gekoppeld.
Veelgestelde vragen
Moet mijn team stoppen met de telefoon?
Nee. Dat is precies het doel van Coexistence. De WhatsApp Business-app blijft op hetzelfde nummer werken, met dezelfde gesprekken, terwijl de API ernaast draait.
Raak ik mijn bestaande gesprekken kwijt?
Nee. Ze blijven in de app en Meta synchroniseert ongeveer zes maanden geschiedenis naar de API wanneer het nummer wordt gekoppeld, zodat software context heeft in plaats van leeg te beginnen.
Kan ik dit ongedaan maken?
Ja. Een nummer kan worden losgekoppeld en de app gaat verder zoals altijd. Door het nummer te koppelen wordt er niets permanent gewijzigd.
Is dit hetzelfde als de onofficiële WhatsApp API's?
Nee, en dat verschil bepaalt of het nummer behouden blijft. Coexistence is Meta's officiële functie op de Cloud API. Onofficiële gateways gebruiken WhatsApp Web als gekoppeld apparaat, wat in strijd is met de voorwaarden en ertoe leidt dat nummers worden geblokkeerd.
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiode3 dagen gratis. Er wordt niets in rekening gebracht tot de proefperiode afloopt.