Les messages WhatsApp n'apparaissent pas dans les Canaux ouverts Bitrix24 ? Déroulez cette checklist

Hier, nous avons passé une matinée entière sur un message qui « n'était pas arrivé ». Il était bel et bien arrivé — il trônait dans le widget CRM, en pleine lumière. Il n'était simplement jamais apparu dans les Canaux ouverts Bitrix24, et la raison s'est révélée d'une simplicité embarrassante une fois trouvée.

Cette matinée a accouché d'un runbook interne. En voici la version publique : sept causes réelles pour des messages WhatsApp absents des Canaux ouverts, dans l'ordre où nous les vérifions désormais en production.

À comprendre d'abord : il y a deux pipelines, pas un

La plupart des intégrations WhatsApp–Bitrix24 font remonter les messages à deux endroits distincts :

1. Le widget CRM — le panneau de chat WhatsApp intégré sur un prospect ou une affaire. Il lit depuis le stockage de messages propre à l'intégration.
2. Les Canaux ouverts (Open Lines) — la file de messagerie native de Bitrix24, avec distribution aux opérateurs, création automatique de contacts CRM et boîte de réception du Centre de contact. Les messages n'y arrivent que si l'intégration les transmet via un connecteur rattaché à un canal ouvert précis.

Ces pipelines tombent en panne indépendamment l'un de l'autre. Un message peut être livré, stocké et visible dans le widget pendant que les Canaux ouverts restent complètement muets — exactement l'état déroutant que nous avons débogué. Si votre widget affiche les messages, le versant WhatsApp de votre intégration fonctionne ; le problème se loge dans l'étape de transmission ou dans le rattachement au canal ouvert. Ça réduit énormément le périmètre de recherche.

La checklist

1. Un canal ouvert est-il réellement rattaché à ce numéro ?

La cause n° 1, et celle qui nous a eus. Chaque connexion WhatsApp a besoin d'un lien explicite vers un canal ouvert — et selon la façon dont la connexion a été créée, ce lien peut n'avoir jamais été posé. Le détail vicieux : certaines interfaces d'administration affichent un nom de canal factice même quand rien n'est rattaché, si bien que ça peut sembler connecté tout en n'étant connecté à rien.

Vérifiez des deux côtés : les réglages de votre intégration doivent nommer le canal ouvert exact que chaque numéro alimente, et ce canal doit exister dans Bitrix24 → Centre de contact. Si vous n'arrivez pas à déterminer quel canal un numéro alimente, partez du principe que c'est aucun.

2. Le connecteur est-il actif sur ce canal ?

Un canal peut exister et être rattaché, mais son connecteur peut être inactif — le plus souvent après que le canal a été modifié ou recréé. Dans le Centre de contact, ouvrez le canal et confirmez que votre connecteur WhatsApp y est listé et activé. Les bonnes intégrations le réactivent automatiquement au premier message ; les installations plus anciennes peuvent nécessiter un basculement manuel.

3. Le canal ouvert a-t-il été supprimé ou archivé ?

Les canaux se font « ranger » par des admins bien intentionnés plus souvent qu'on ne le croit. Si le canal rattaché n'existe plus, les messages n'ont nulle part où atterrir — et la plupart des intégrations échouent en silence plutôt que de planter. Rattachez à un canal vivant.

4. L'abonnement webhook est-il toujours intact ?

Tout ce qui circule entre WhatsApp et Bitrix24 commence par un webhook. Sur les numéros API officiels (Cloud API), votre application doit être abonnée au compte WhatsApp Business — un abonnement qui peut se perdre après un changement de token, un passage en révision de l'application ou une migration de numéro. Symptôme : rien n'arrive nulle part, widget compris. Si les deux pipelines sont morts, cherchez ici d'abord, pas dans Bitrix.

5. L'expéditeur est-il bloqué ? (La cause silencieuse)

Un contact bloqué sur l'API WhatsApp Business ne produit aucun webhook. Pas d'erreur, pas de ligne de log — le silence. Si exactement un client a « arrêté d'écrire » alors que tous les autres circulent normalement, vérifiez la liste de blocage avant de toucher au moindre réglage. Quelqu'un de votre équipe l'a peut-être bloqué il y a des mois. Nous avons documenté les règles de blocage et leurs surprises séparément.

6. Le message dort-il dans une file non assignée ?

Parfois, le message est dans les Canaux ouverts — juste pas là où vous regardez. Si la file du canal n'a aucun opérateur disponible, ou route vers un département que personne ne consulte, les conversations s'empilent sans assignation. Ouvrez les réglages de file du canal et vérifiez qui est censé recevoir les nouveaux dialogues, et si les opérateurs « hors ligne » sont bien sautés.

7. Sur les numéros API : respectez-vous les règles de messagerie ?

Les numéros sur l'API officielle sont soumis aux règles de conversation de Meta : les clients peuvent toujours vous écrire, mais si vos envois sortants échouent soudainement — ou qu'une automatisation a cessé de répondre — vérifiez la fenêtre de service client de 24 heures et le statut de qualité de vos modèles dans WhatsApp Manager. Les problèmes entrants viennent rarement de là ; les problèmes sortants, presque toujours.

Comment notre propre session de débogage s'est vraiment déroulée

Pour les curieux — la séquence réelle de notre incident : message visible dans le widget (donc l'entrant fonctionnait), rien dans les Canaux ouverts (donc la transmission, non), une interface affichant un nom de canal qui s'est avéré n'être qu'un placeholder (la cause n° 1 déguisée), et un détour par la liste de blocage (cause n° 5) provoqué par un test de blocage antérieur sur le même numéro. Temps total : une matinée. Avec cette checklist : une dizaine de minutes.

Deux changements en sont sortis. WASync crée et rattache désormais un canal ouvert automatiquement dès qu'un numéro WhatsApp Business API se connecte — la cause n° 1 ne peut donc plus toucher les nouvelles connexions — et le connecteur s'auto-active au premier message, ce qui couvre la cause n° 2.

Le triage en cinq minutes

---

Vous partez de zéro au lieu de déboguer ? Notre guide pas à pas pour connecter WhatsApp à Bitrix24 couvre la voie QR comme la voie API officielle — avec le câblage du canal ouvert fait pour vous.