Un numéro ne fonctionne plus : comment trouver pourquoi
Lorsqu’un numéro connecté cesse de fonctionner, la cause ne vient presque jamais du code. Vérifiez les causes par fréquence : token expiré, remplacement du webhook perdu après une reconnexion, déconnexion après quatorze jours d’inactivité, baisse de qualité, puis restriction du compte.
Les causes représentent presque tous les échecs silencieux.
L’erreur renvoyée par un token expiré ressemble à un numéro manquant.
L’événement qui signale officiellement une déconnexion.
Pourquoi rien ne semble anormal sur le téléphone ?
Parce que l’application WhatsApp Business et l’API sont deux interfaces distinctes sur le même numéro, et que presque chaque incident n’en affecte qu’une seule.
Un token expire et l’application reste intacte. Un remplacement du webhook est désinstallé et l’application reste intacte. La qualité baisse et l’application reste intacte. Dans tous les cas, l’entreprise continue de répondre aux clients, observe un comportement normal et n’a aucune raison de signaler quoi que ce soit.
C’est tout l’argument en faveur de la surveillance plutôt que d’un dashboard que quelqu’un doit consulter. Les incidents sont réels, silencieux, et les personnes les plus proches du numéro sont les moins susceptibles de les remarquer.
Dans quel ordre devez-vous vérifier ?
Commencez par le token, car c’est la cause la plus fréquente et la moins coûteuse à corriger. Un identifiant expiré ou invalidé fait échouer chaque appel de la même façon, ce qui donne exactement l’impression que le numéro a été supprimé. Conserver un second identifiant sur le même compte permet de distinguer les deux situations.
Vérifiez ensuite le remplacement du webhook. Si une reconnexion a eu lieu, la destination a été désinstallée avec l’application : l’envoi et la surveillance fonctionnent, mais la livraison à votre serveur échoue silencieusement.
Puis vérifiez une déconnexion : un événement account_update avec PARTNER_REMOVED et une raison, où PRIMARY_INACTIVITY signifie que l’application est restée inutilisée pendant environ quatorze jours et qu’une reconnexion suffit à corriger le problème.
Ensuite, vérifiez la qualité, qui est interrogée plutôt qu’envoyée, puis une restriction, qui correspond à une mesure appliquée au niveau du compte qu’aucun fournisseur ne peut lever.
Quelle cause est presque toujours à écarter ?
Votre code, s’il fonctionnait hier et qu’aucun déploiement n’a eu lieu.
La Cloud API est stable et ses formats de requête ne changent pas sans prévenir. Lorsqu’une intégration qui fonctionnait depuis des mois s’arrête, la probabilité la plus forte concerne un identifiant, une modification du routage ou un événement au niveau du compte, autant de situations qui surviennent sans que personne ne touche au dépôt.
L’exception à retenir est un template modifié. Changer le nombre de variables d’un template modifie le contrat pour chaque expéditeur, silencieusement. Cela ressemble à un défaut du code, alors qu’il s’agit d’une modification de contenu effectuée dans WhatsApp Manager par quelqu’un d’autre.
Erreurs courantes
- Reconnecter le numéro en premier. Si un token a expiré, cela impose au responsable de l’entreprise une tâche qui n’était pas nécessaire.
- Supposer que le code a cessé de fonctionner. Une API stable et l’absence de déploiement orientent vers une autre cause.
- Chercher des symptômes sur le téléphone. L’application continue de fonctionner dans presque tous ces cas.
EasyCoexistence vérifie les cinq causes en continu et les enregistre dans la chronologie de la connexion. Le dépannage commence ainsi par un événement daté plutôt que par une supposition.
Questions fréquemment posées
Le numéro fonctionne sur le téléphone, mais rien ne part. Par où commencer ?
Le token d’accès. C’est la cause la plus fréquente et celle qui ressemble le plus à un numéro supprimé.
Je me suis reconnecté, mais les messages n’atteignent toujours pas mon serveur.
Le remplacement du webhook a été désinstallé avec l’application. Il faut le réappliquer ; nous le faisons automatiquement.
Comment savoir s’il s’agissait de la règle des quatorze jours ?
La déconnexion arrive avec la raison PRIMARY_INACTIVITY dans l’événement account_update.
Une modification de template peut-elle empêcher mes envois ?
Oui, c’est la seule cause qui ressemble à un défaut du code. Modifier le nombre de variables modifie le contrat pour chaque expéditeur.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le