InloggenGratis proefperiode starten
Meta Tech Provider

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.

Start je gratis proefperiode3 dagen gratis. Er wordt niets in rekening gebracht tot de proefperiode afloopt.
+1 415 555 0188
WhatsApp Business-appHet team antwoordt vanaf de telefoon, zoals altijd
Cloud APIJe eigen systemen, of een AI-assistent, op dezelfde lijn
Beide kanalen zien hetzelfde gesprek. Wat de API verstuurt verschijnt in de app, en wat het team in de app typt komt binnen als een smb_message_echoes-event, zodat software nooit antwoordt over een mens heen die al heeft geantwoord.
Standaard geen berichtopslagBusiness-app + Cloud APIMCP voor Claude en ChatGPTLive in 2 minuten

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.

VroegerEén nummer, één keuze
De app houden

Het team antwoordt vanaf de telefoon. Niets kan worden geautomatiseerd, gekoppeld of gemeten.

Geen API
Migreren naar de API

Software kan het nummer bereiken. De Business-app werkt er niet meer op en het team stapt over op een ander hulpmiddel.

Geen app
NuEén nummer, allebei
Eén nummer
WhatsApp Business-appCloud API

Meta 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.

Houdt de telefoonEen bedrijf met één nummer

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 nummers, één accountEen bureau, adviesbureau of developer

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.

  1. 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.

    Nodig
    Een HTTPS-endpoint dat hub.challenge terugstuurt op de GET van Meta
    Tijd
    Ongeveer een minuut
    U krijgt
    Een bestemming die Meta kan verifiëren op het moment dat het nummer gekoppeld wordt
    Er is nog niets gekoppeld. Hier wordt bepaald waar berichten terechtkomen.
    Provider op het padOpgeslagen op hun servers
    Meta
    Hun platformOntvangt en bewaart berichten
    JijEen kopie, op hun tijdschema
    EasyCoexistenceAlleen configuratie
    Meta
    Je endpointNog niet geverifieerd
    WijWe zetten de route uit, we zitten er niet op
  2. Doorloop 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.

    Nodig
    Toegang tot het Business Portfolio, en de telefoon met het nummer
    Tijd
    Twee tot drie minuten
    U krijgt
    Cloud API gekoppeld aan een nummer dat de app nog gebruikt
    Het tweede kanaal verschijnt. Het eerste wordt niet weggehaald.
    Na een migratieEén kanaal
    Het nummer
    Alleen Cloud APIBusiness-app werkt niet meer op dit nummer
    Na CoexistenceTwee kanalen
    Het nummer
    WhatsApp Business-appDezelfde chats en geschiedenis
    Cloud APIOp dezelfde lijn
  3. Stuur 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.

    Nodig
    Het endpoint uit stap één, nu geverifieerd door Meta
    Tijd
    Toegepast zodra de onboarding klaar is
    U krijgt
    Berichten die van Meta rechtstreeks naar jou gaan, zonder ons op het berichtenpad
    Welke events waarheen gaan zodra de override actief is.
    Operationele eventsAfgeleverd bij ons
    account_updateWijzigingen in de verbindingsstatus
    phone_number_quality_updateKwaliteit en throughput
    account_review_updateUitkomsten van beoordelingen
    BerichtenpadAfgeleverd bij jou
    messagesAlles wat een klant stuurt
    smb_message_echoesWat het team vanuit de app verstuurt
    Je serverRechtstreeks, nooit via ons
  4. Houd 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.

    Nodig
    De app af en toe geopend op het hoofdapparaat
    Tijd
    Doorlopend
    U krijgt
    Een verbinding die bewaakt wordt, en een route die een nieuwe koppeling overleeft
    Wat een nieuwe koppeling vanzelf herstelt, en wat teruggezet moet worden.
    Hersteld door MetaAutomatisch
    VerzendenCloud API werkt weer
    Operationele eventsMonitoring gaat verder
    Verloren met de appMoet opnieuw worden gezet
    Je webhook-overrideVerwijderd met de app
    Aflevering van berichten aan jouStopt ongemerkt
    Wij 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.
Vrije tekst0 tot 24 uur na hun laatste berichtAlleen templatesdaarna, tot ze opnieuw schrijven
De klok begint opnieuw telkens als de klant iets stuurt. Dit is de regel die integraties in productie breekt, omdat testen altijd seconden na een bericht gebeurt, wanneer vrije tekst nog werkt.

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.

Direct afgeleverd op je endpointHet berichtenpad. Standaard loopt het nooit via ons.
  • messagesAlles wat een klant naar het nummer stuurt
  • smb_message_echoesWat je team vanuit de WhatsApp Business-app verstuurt
Afgeleverd bij onsHet operationele pad. Hier bestaat de monitoring uit.
  • account_updateVerbindingsstatus: verwijderd, afgemeld, opnieuw gekoppeld, beperkt
  • phone_number_quality_updateWijzigingen in kwaliteitsbeoordeling en throughput
  • account_alertsWaarschuwingen die Meta voor het account afgeeft
  • account_review_updateUitkomsten van een beoordeling door Meta
  • business_capability_updateWijzigingen in berichtlimiet en mogelijkheden
  • phone_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.

Het nummer is ontkoppeldWebhook, gezaghebbend

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.

De verbinding was veertien dagen stilEigen status

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.

Je webhookroute verdween bij een nieuwe koppelingAutomatisch opnieuw gezet

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.

Het toegangstoken werkt niet meerTwee tokens, één antwoord

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.

De kwaliteit is gedaaldOpgevraagd

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.

2 minutes

Gebruikelijke tijd om een nummer te koppelen door een code in de WhatsApp Business-app te scannen.

24 hours

Hoe lang een antwoord van een klant de sessie openhoudt voor vrije tekstberichten.

20 msg/s

Verzendcapaciteit voor een Coexistence-nummer, door Meta vastgesteld en niet te verhogen.

6 months

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.

Lees verder