WhatsApp-fout 2593107: synchronisatielimiet overschreden

Wat is de synchronisatie waarnaar dit verwijst?

Dit is de stap die de bestaande contacten en gespreksgeschiedenis van een Coexistence-nummer overzet naar de API-kant, zodat software niet zonder context begint op een nummer dat een bedrijf al jaren gebruikt.

Dit bestaat alleen dankzij Coexistence. Een nummer dat op de gewone manier wordt aangemeld, heeft geen eerdere appgeschiedenis om over te zetten en er valt niets te synchroniseren. Een Coexistence-nummer heeft beide, en Meta biedt een eenmalige overdracht op het moment dat het nummer wordt verbonden.

Daarom is deze fout zelfs onbekend voor mensen die al lang met de Cloud API werken. De fout hoort bij een onboardingmodus die zij nooit hebben gebruikt.

Waarom kan dit maar één keer worden uitgevoerd?

Omdat dit onderdeel is van onboarding en geen doorlopende functie, en Meta het behandelt als een eenmalige keuze bij het verbinden.

Tijdens Embedded Signup wordt de bedrijfseigenaar gevraagd of bestaande chatgeschiedenis mag worden gedeeld. Ja antwoorden maakt de synchronisatie mogelijk. Er is geen instelling om dit later opnieuw in te schakelen en geen endpoint dat dit herhaalt. Daarom geeft een tweede aanroep deze fout terug in plaats van een limiet die vanzelf verdwijnt.

De praktische consequentie is dat de keuze belangrijker is dan ze op dat moment lijkt. Wie snel door de onboarding klikt en geschiedenis weigert omdat dat veiliger voelt, neemt een beslissing die alleen via volledig ontkoppelen en opnieuw verbinden kan worden herzien.

Wat als je dit echt opnieuw nodig hebt?

Het nummer moet worden ontkoppeld en opnieuw verbonden. Dat is een echte handeling en geen instelling.

Opnieuw verbinden start Embedded Signup vanaf het begin, inclusief het scannen van de code op de telefoon, en biedt een nieuwe mogelijkheid om geschiedenis te accepteren. De WhatsApp Business-app blijft ondertussen onaangetast, dus het bedrijf verliest niets. Het is echter geen stille achtergrondhandeling: iemand moet bij de telefoon zijn.

Er is één gevolg om rekening mee te houden. Bij ontkoppelen wordt de webhook-bestemming verwijderd, omdat die bestemming als override op een app-abonnement staat en niet op het nummer. Opnieuw verbinden herstelt verzenden en monitoren, maar niet de aflevering aan je eigen server tenzij iemand de bestemming terugplaatst.

Veelgemaakte fouten

• De synchronisatieaanroep opnieuw proberen. Dit is een eenmalige gebeurtenis, dus de poging geeft dezelfde fout terug in plaats van uiteindelijk te slagen.
• Chatgeschiedenis tijdens onboarding uit voorzichtigheid weigeren. Die keuze kan alleen worden herzien door het nummer opnieuw te verbinden.
• Opnieuw verbinden zonder te plannen de webhook-bestemming terug te plaatsen. Die wordt samen met de app verwijderd.

Veelgestelde vragen

Lees verder