Een nummer werkt niet meer: zo ontdek je waarom
Als een verbonden nummer niet meer werkt, ligt dat bijna nooit aan de code. Controleer alles in volgorde van waarschijnlijkheid: een verlopen token, een webhook-override die na opnieuw verbinden verloren ging, een verbreking na veertien dagen inactiviteit, een kwaliteitsdaling en daarna een accountbeperking.
Oorzaken die vrijwel elke stille storing verklaren.
De fout die een verlopen token terugstuurt en eruitziet alsof het nummer ontbreekt.
De gebeurtenis die een verbreking officieel meldt.
Waarom lijkt er niets mis op de telefoon?
Omdat de WhatsApp Business-app en de API afzonderlijke oppervlakken op hetzelfde nummer zijn, en vrijwel elke storing maar één daarvan beïnvloedt.
Een token verloopt en de app blijft onaangeroerd. Een webhook-override wordt verwijderd en de app blijft onaangeroerd. De kwaliteit daalt en de app blijft onaangeroerd. In elk geval blijft het bedrijf klanten normaal beantwoorden, ziet het normaal gedrag en heeft niemand reden om iets te melden.
Dit is precies waarom monitoring nodig is, in plaats van een dashboard dat iemand af en toe controleert. De storingen zijn echt en stil, en de mensen die het dichtst bij het nummer staan, merken ze het minst snel op.
In welke volgorde moet je controleren?
Begin met het token, omdat dit de meest voorkomende oorzaak is en het goedkoopst te herstellen. Door een verlopen of ongeldig gemaakte aanmeldingsgegeven mislukt elk verzoek op dezelfde manier. Dat ziet er precies uit alsof het nummer is verwijderd. Een tweede aanmeldingsgegeven voor hetzelfde account laat zien welke van de twee oorzaken speelt.
Controleer daarna de webhook-override. Als er opnieuw verbinding is gemaakt, werd de bestemming samen met de app verwijderd. Verzenden en monitoring werken dan wel, maar bezorging naar je server stilletjes niet.
Daarna controleer je een verbreking: een account_update-gebeurtenis met PARTNER_REMOVED en een reden. PRIMARY_INACTIVITY betekent dat de app ongeveer veertien dagen niet is geopend; opnieuw verbinden lost dit op.
Controleer daarna de kwaliteit, die wordt opgevraagd in plaats van doorgestuurd. Tot slot controleer je een beperking, een accountbrede maatregel die geen enkele provider kan opheffen.
Wat is bijna nooit de oorzaak?
Je code, als die gisteren nog werkte en er niets is uitgerold.
De Cloud API is stabiel en de vorm van verzoeken verandert niet ongemerkt onder je. Wanneer een integratie maandenlang werkte en plots stopt, is de kans veruit het grootst dat het om een aanmeldingsgegeven, een wijziging in de routering of een accountbrede gebeurtenis gaat. Dat kan gebeuren zonder dat iemand een repository aanraakt.
De uitzondering die je moet kennen, is een aangepast template. Een wijziging in het aantal variabelen verandert de afspraak voor elke afzender, stilletjes. Dat lijkt op een codefout, maar is in werkelijkheid een inhoudelijke wijziging die iemand anders in WhatsApp Manager heeft gemaakt.
Veelgemaakte fouten
- Het nummer meteen opnieuw verbinden. Als een token was verlopen, laat je de eigenaar werk doen dat niet nodig was.
- Aannemen dat de code stuk is. Een stabiele API zonder nieuwe uitrol wijst ergens anders op.
- De telefoon controleren op symptomen. De app blijft bij bijna al deze oorzaken gewoon werken.
EasyCoexistence controleert alle vijf oorzaken voortdurend en legt ze vast op de verbindingstijdlijn. Zo begint het onderzoek met een gebeurtenis met datum, niet met een gok.
Veelgestelde vragen
Het nummer werkt op de telefoon, maar er wordt niets verzonden. Waar begin ik?
Bij het toegangstoken. Dit is de meest voorkomende oorzaak en lijkt het meest op een verwijderd nummer.
Ik heb opnieuw verbonden, maar berichten komen nog steeds niet op mijn server aan.
De webhook-override is samen met de app verwijderd. Die moet opnieuw worden toegepast; wij doen dat automatisch.
Hoe weet ik of het de regel van veertien dagen was?
De verbreking komt met de reden PRIMARY_INACTIVITY in de account_update-gebeurtenis.
Kan een aangepast template ervoor zorgen dat mijn verzendingen mislukken?
Ja. Dit is de enige oorzaak die op een codefout lijkt. Een wijziging in het aantal variabelen verandert de afspraak voor elke afzender.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op