Coexistence loskoppelen en terug naar alleen de app

Hoe zet ik Coexistence uit?

Op de telefoon waarop het nummer staat. Meta beschrijft één route voor een bedrijf om de Cloud API te verlaten als het nummer wordt gedeeld met de WhatsApp Business app, en die loopt via de app, niet via een dashboard of endpoint. Wie de primaire telefoon heeft, beslist, dus een bureau of ontwikkelaar vraagt het bedrijf om dit te doen.

• Open de WhatsApp Business app op het primaire apparaat.
• Ga naar Instellingen, dan Account, dan Business Platform.
• Tik op Account ontkoppelen en bevestig.
• Verwacht aan de API-kant een account_update-webhook met het event PARTNER_REMOVED.

Waarom weigert de Deregister-API het nummer?

Omdat Meta Coexistence-nummers er bewust van uitsluit. De documentatie over registratie vermeldt dat het Deregister-endpoint geen zakelijk telefoonnummer kan deregistreren dat met zowel de Cloud API als de WhatsApp Business app in gebruik is.

Deregistreren is de bewerking die een nummer onbruikbaar maakt voor de Cloud API, en bij een nummer dat alleen de API gebruikt haal je zo een lijn van het platform. Bij een gedeeld nummer is de app de primaire eigenaar van de lijn, dus legt Meta de beslissing terug bij degene die de telefoon heeft. Software die het endpoint eerst probeert, krijgt een fout en geen ontkoppeling, en het nummer blijft verbonden tot iemand in de app op de knop tikt.

Wat gebeurt er met de app, de geschiedenis en het nummer?

Ontkoppelen is niet hetzelfde als het account verwijderen, en dat verschil is het hele antwoord.

De waarschuwing van Meta over het verlies van berichtgeschiedenis geldt voor het verwijderen van het account in de WhatsApp Business app en het registreren van het nummer op de Cloud API. Ontkoppelen doet geen van beide. De app blijft geïnstalleerd en geregistreerd, het nummer blijft erop staan en het team blijft klanten beantwoorden vanaf dezelfde telefoon.

Wat eindigt is de API-kant. De app van de provider wordt van het nummer verwijderd, dus verzenden via de Cloud API en het afleveren van webhooks stoppen. De functies die Coexistence uitzette, zoals broadcastlijsten, staan op de pagina over uitgeschakelde functies.

Kan het nummer later opnieuw worden verbonden?

Ja, door de onboarding opnieuw vanaf het begin te doorlopen. In de eigen documentatie van Meta zijn offboarden en de flow opnieuw voltooien de normale manier om een verbinding te resetten, bijvoorbeeld als het venster van 24 uur om contacten en geschiedenis te synchroniseren is gemist.

Opnieuw verbinden is een nieuwe onboarding, dus de vragen van de eerste keer worden opnieuw gesteld, ook of je de chatgeschiedenis wilt delen. Alles wat op de oude verbinding was ingesteld, zoals een webhook-override, moet je opnieuw toepassen. Een nummer dat naar een andere provider moet, volgt hetzelfde pad: hier ontkoppelen en daarna onboarden bij de nieuwe.

Veelgemaakte fouten

• Het Deregister-endpoint aanroepen op een Coexistence-nummer. Meta weigert dat; het ontkoppelen gebeurt in de app.
• Het account in de WhatsApp Business app verwijderen om eruit te komen. Via die route ga je de chatgeschiedenis kwijt.
• PARTNER_REMOVED behandelen als een storing en opnieuw proberen. Het is een bewuste ontkoppeling door het bedrijf.

Veelgestelde vragen

Lees verder