WhatsApp-Nachrichten erscheinen nicht in den Bitrix24 Offenen Kanälen? Diese Checkliste hilft

Gestern haben wir einen ganzen Vormittag mit einer Nachricht verbracht, die „nicht angekommen“ war. Sie war angekommen — sie stand deutlich sichtbar im CRM-Widget. Sie tauchte nur nie in den Bitrix24 Offenen Kanälen (Open Lines) auf, und der Grund war, als wir ihn fanden, fast schon peinlich simpel.

Aus diesem Vormittag entstand ein internes Runbook. Das hier ist die öffentliche Fassung: sieben echte Ursachen für WhatsApp-Nachrichten, die in den Offenen Kanälen fehlen — in der Reihenfolge, in der wir sie inzwischen in Produktion prüfen.

Erst das verstehen: Es gibt zwei Pipelines, nicht eine

Die meisten WhatsApp–Bitrix24-Integrationen zeigen Nachrichten an zwei getrennten Stellen an:

1. Das CRM-Widget — das WhatsApp-Chatpanel direkt am Lead oder Deal. Es liest aus dem eigenen Nachrichtenspeicher der Integration.
2. Die Offenen Kanäle — Bitrix24s native Messaging-Warteschlange mit Operator-Verteilung, automatischer CRM-Kontaktanlage und dem Contact-Center-Posteingang. Hierhin gelangen Nachrichten nur, wenn die Integration sie über einen Konnektor weiterleitet, der an einen konkreten Offenen Kanal gebunden ist.

Diese Pipelines fallen unabhängig voneinander aus. Eine Nachricht kann zugestellt, gespeichert und im Widget sichtbar sein, während die Offenen Kanäle vollkommen stumm bleiben — exakt der verwirrende Zustand, den wir debuggt haben. Zeigt Ihr Widget Nachrichten an, funktioniert die WhatsApp-Seite Ihrer Integration; das Problem sitzt in der Weiterleitung oder der Kanal-Bindung. Das grenzt die Suche enorm ein.

Die Checkliste

1. Ist überhaupt ein Offener Kanal an diese Nummer gebunden?

Ursache Nummer eins — und die, die uns erwischt hat. Jede WhatsApp-Verbindung braucht eine explizite Verknüpfung mit einem Offenen Kanal, und je nachdem, wie die Verbindung angelegt wurde, wurde diese Verknüpfung womöglich nie gesetzt. Das Fiese daran: Manche Admin-Oberflächen zeigen einen Platzhalter-Kanalnamen an, obwohl nichts gebunden ist — es kann also verbunden aussehen und mit nichts verbunden sein.

Prüfen Sie es von beiden Enden: Die Einstellungen Ihrer Integration sollten für jede Nummer den exakten Offenen Kanal nennen, und dieser Kanal sollte in Bitrix24 → Contact Center existieren. Wenn Sie nicht sagen können, welchen Kanal eine Nummer speist, gehen Sie davon aus: keinen.

2. Ist der Konnektor auf dieser Linie aktiv?

Ein Kanal kann existieren und gebunden sein — und der Konnektor darauf trotzdem inaktiv, typischerweise nachdem die Linie bearbeitet oder neu angelegt wurde. Öffnen Sie den Kanal im Contact Center und prüfen Sie, dass Ihr WhatsApp-Konnektor gelistet und aktiviert ist. Gute Integrationen reaktivieren ihn bei der ersten Nachricht automatisch; ältere Setups brauchen manchmal einen manuellen Schalter.

3. Wurde der Offene Kanal gelöscht oder archiviert?

Kanäle werden von gut meinenden Admins häufiger „aufgeräumt“, als man denkt. Existiert die gebundene Linie nicht mehr, haben Nachrichten kein Ziel — und die meisten Integrationen scheitern still, statt zu crashen. An eine lebende Linie neu binden.

4. Ist die Webhook-Subscription noch intakt?

Alles zwischen WhatsApp und Bitrix24 beginnt mit einem Webhook. Bei Nummern auf der offiziellen API (Cloud API) muss Ihre App auf das WhatsApp Business Account abonniert sein — eine Subscription, die nach Token-Wechseln, App-Review-Ereignissen oder Nummern-Migrationen verloren gehen kann. Symptom: Es kommt nirgendwo etwas an, auch nicht im Widget. Sind beide Pipelines tot, suchen Sie zuerst hier — nicht bei Bitrix.

5. Ist der Absender blockiert? (Die stille Ursache)

Ein über die WhatsApp Business API blockierter Kontakt erzeugt überhaupt keinen Webhook. Kein Fehler, keine Logzeile — Stille. Wenn genau ein Kunde „nicht mehr schreibt“, während alle anderen normal durchlaufen, prüfen Sie die Sperrliste, bevor Sie irgendeine Einstellung anfassen. Vielleicht hat jemand aus Ihrem Team ihn vor Monaten blockiert. Die Blockier-Regeln und ihre Überraschungen haben wir separat aufgeschrieben.

6. Liegt die Nachricht in einer nicht zugewiesenen Warteschlange?

Manchmal ist die Nachricht in den Offenen Kanälen — nur nicht dort, wo Sie hinschauen. Wenn die Warteschlange der Linie keine verfügbaren Operatoren hat oder an eine Abteilung routet, in die niemand schaut, stapeln sich Dialoge unzugewiesen. Öffnen Sie die Warteschlangen-Einstellungen der Linie und prüfen Sie, wer neue Dialoge erhalten soll — und ob „offline“ gemeldete Operatoren übersprungen werden.

7. Bei API-Nummern: Bewegen Sie sich innerhalb der Messaging-Regeln?

Nummern auf der offiziellen API unterliegen Metas Konversationsregeln: Kunden können jederzeit schreiben — aber wenn Ihr ausgehender Verkehr plötzlich scheitert oder eine Automation nicht mehr antwortet, prüfen Sie das 24-Stunden-Kundenservice-Fenster und den Qualitätsstatus Ihrer Templates im WhatsApp Manager. Eingehende Probleme haben hier selten ihre Ursache; ausgehende meistens.

Wie unsere eigene Debugging-Session wirklich lief

Für die Neugierigen — der echte Ablauf unseres Vorfalls: Nachricht im Widget sichtbar (eingehend funktionierte also), nichts in den Offenen Kanälen (die Weiterleitung also nicht), eine UI, die einen Kanalnamen anzeigte, der sich als Platzhalter entpuppte (Ursache Nr. 1 in Verkleidung) — und ein Umweg über die Sperrliste (Ursache Nr. 5), ausgelöst durch einen früheren Blockier-Test mit derselben Nummer. Gesamtdauer: ein Vormittag. Mit dieser Checkliste: etwa zehn Minuten.

Zwei Änderungen sind daraus entstanden. WASync erstellt und bindet jetzt automatisch einen Offenen Kanal, sobald sich eine Nummer der WhatsApp Business API verbindet — Ursache Nr. 1 kann neuen Verbindungen also nicht mehr passieren — und der Konnektor aktiviert sich bei der ersten Nachricht selbst, was Ursache Nr. 2 abdeckt.

Die Fünf-Minuten-Triage

---

Sie richten gerade neu ein, statt zu debuggen? Unsere Schritt-für-Schritt-Anleitung zum Verbinden von WhatsApp mit Bitrix24 deckt den QR-Weg und die offizielle API ab — die Verkabelung der Offenen Kanäle inklusive.