Von Sojan and harishmita
Von Sojan and harishmita
Ihr vollständiger Leitfaden zu WhatsApp in Chatwoot: Verbinden Sie Ihre Nummer, nutzen Sie Vorlagen, Kampagnen, CSAT-Umfragen und Anrufe, halten Sie Ihre Nummer in gutem Zustand und beheben Sie häufig
WhatsApp in Chatwoot
Verbinden Sie Ihre WhatsApp Business-Nummer mit Chatwoot und Ihr Team kann WhatsApp-Chats aus einer gemeinsamen Inbox beantworten – zusammen mit Ihren anderen Kanälen. Sie können auch genehmigte Vorlagen-Nachrichten versenden, Broadcast-Kampagnen durchführen, CSAT-Bewertungen sammeln und WhatsApp-Anrufe entgegennehmen. Was Sie auf WhatsApp tun können Funktion Was sie macht Mehr erfahren Gemeinsame WhatsApp-Inbox Kunden-Nachrichten kommen als Konversationen an, die Ihr Team zuweisen, labeln, beantworten und abschließen kann Wählen Sie, wie Sie WhatsApp verbinden Vorlagen-Nachrichten Starten Sie eine Konversation oder antworten Sie nach 24 Stunden mit einer von Meta genehmigten Nachricht Vorlagen und das 24-Stunden-Fenster Kampagnen Senden Sie eine genehmigte Vorlage an alle Kontakte mit ausgewählten Labels. Business-Plan und höher. WhatsApp-Kampagnen CSAT-Umfragen Bitten Sie um eine Bewertung, wenn eine Konversation abgeschlossen ist, auch nach Ablauf des 24-Stunden-Fensters CSAT-Umfragen auf WhatsApp Anrufe Kunden rufen Ihr Unternehmen über WhatsApp an und Agenten beantworten im Browser WhatsApp-Anrufe Account-Status Sehen Sie Status, Nachrichtenlimit, Überprüfung des Anzeigenamens und Unternehmensprofil in Chatwoot Ihre WhatsApp-Nummer verwalten WhatsApp-Inboxen funktionieren auch mit Funktionen, die jedem Kanal gemeinsam sind, wie Automatisierung, Textbausteine, Captain und Berichte. Wie Chatwoot mit WhatsApp-Benutzernamen und unternehmensbezogenen Benutzer-IDs umgeht, erfahren Sie unter WhatsApp Usernames and Business-Scoped User IDs in Chatwoot. Plan & Zugriff Chatwoot Cloud Self-hosted WhatsApp-Inbox (jede Verbindungsart) Startups-Plan und höher sowie die kostenlose Testversion. Nicht im kostenlosen Hacker-Plan verfügbar. Inklusive Schnelle Einrichtung mit Meta (der schnellste Weg zur Verbindung) Ab dem Startups-Plan enthalten. Während der Testphase klicken Sie im Einrichtungsbildschirm auf Zugang anfordern und reichen Ihren Anwendungsfall ein, um es zu aktivieren. Verfügbar, wenn der Super-Admin Ihrer Installation die WhatsApp App ID , WhatsApp Configuration ID und WhatsApp App Secret Ihrer eigenen Meta-App in Super Admin › Einstellungen › WhatsApp Embedded hinzugefügt hat. Andernfalls manuelle Einrichtung verwenden. WhatsApp-Kampagnen: Versand Business-Plan und höher. Automatisch verfügbar, keine Anfrage nötig. Kein Premium-Feature. Funktioniert in der Community Edition und ist standardmäßig aktiviert. Kampagnenanalyse Business-Plan und höher Benötigt einen kostenpflichtigen Self-hosted-Plan. Der Super-Admin Ihrer Installation aktiviert Kampagnenanalyse unter Super Admin › Accounts › Account öffnen › Bearbeiten , unter Premium-Features , und klickt dann auf Änderungen speichern . Anrufe Business-Plan und höher Benötigt kostenpflichtigen Self-hosted-Plan mit Enterprise Edition ab v4.15.0. Nur die Installation des Enterprise Edition Builds allein aktiviert es nicht. Vorlagen, CSAT-Umfragen, Account-Status Jeder Plan, der WhatsApp enthält Inklusive Wer was tun kann: - Administratoren verbinden Inboxen und ändern Inbox-Einstellungen. - Agenten, die zur Inbox hinzugefügt wurden, beantworten Konversationen und senden Vorlagen. Siehe Preise & Pläne für die jeweiligen Plan-Umfänge. Anbieterkosten sind von Ihrem Chatwoot-Abo getrennt. Meta berechnet Gebühren für einige WhatsApp-Nachrichten und -Anrufe und Twilio erhebt eigene Gebühren, wenn Sie über Twilio verbinden. Zur Kostenschätzung verwenden Sie den WhatsApp-Preisrechner oder sehen Sie Metas WhatsApp-Preise und Twilios WhatsApp-Preise. Ihre Verbindungsmethode entscheidet, was Sie nutzen können Chatwoot verbindet sich auf drei Arten mit WhatsApp. Wählen Sie, bevor Sie verbinden, denn einige Funktionen funktionieren nur mit der WhatsApp Cloud API. Schnelle Einrichtung mit Meta (WhatsApp Cloud API) Manuelle Einrichtung (WhatsApp Cloud API) Twilio Einrichtungsaufwand Wenige Minuten im Meta-Fenster. Keine Entwickler-Einrichtung. Meta-App, System-User-Token und Webhook Twilio-Account, Zugangsdaten und Webhook WhatsApp Business-App auf dem Handy weiter nutzen ✅ (Koexistenz) ❌ ❌ Vorlagen-Nachrichten ✅ ✅ ✅ Twilio Content-Vorlagen Kampagnen ✅ ✅ ❌ CSAT-Umfragen nach 24 Stunden ✅ ✅ ✅ Anrufe ✅ ✅ ❌ Account-Status-Tab ✅ ✅ ❌ Verfügbar auf Chatwoot Cloud und Self-hosted-Installationen mit eigener Meta-App-Konfiguration Cloud und Self-hosted Cloud und Self-hosted Nutzen Sie 360dialog? 360dialog wird für neue Inboxen nicht mehr angeboten. Bestehende 360dialog-Inboxen funktionieren weiterhin für Konversationen, können aber keine Kampagnen, Anrufe oder CSAT-Vorlagen nutzen. So prüfen Sie, was Sie haben - Ihr Inbox-Typ: Gehen Sie zu Einstellungen › Postfächer und öffnen Sie Ihre WhatsApp-Inbox. Ein Account-Status-Tab bedeutet, es ist eine WhatsApp Cloud API-Inbox. - Schnelle Einrichtung: Im WhatsApp-Einrichtungsbildschirm bedeutet ein Zugang anfordern-Feld statt des Verbindungs-Buttons, dass die Schnelle Einrichtung für Ihr Konto noch nicht aktiviert ist. - Kampagnen: WhatsApp unter Kampagnen in der Seitenleiste bedeutet, Kampagnen sind für Ihr Konto verfügbar. - Anrufe: Ein Anrufe-Tab in den Inbox-Einstellungen bedeutet, Anrufe sind für Ihr Konto verfügbar. Ihr Pfad durch diese Anleitung - Verbinden: Wählen Sie, wie Sie WhatsApp verbinden, und folgen Sie dann der Einrichtungsanleitung für Ihre Verbindungsmethode. - Lernen Sie die eine Regel, die WhatsApp prägt: Vorlagen und das 24-Stunden-Fenster. - Fügen Sie alles hinzu, was Sie brauchen: WhatsApp-Kampagnen, CSAT-Umfragen oder WhatsApp-Anrufe. - Halten Sie alles gesund: Verwalten Sie Ihre WhatsApp-Nummer. - Wenn etwas nicht funktioniert: WhatsApp-Probleme beheben.
Wählen Sie aus, wie Sie WhatsApp verbinden möchten
Welche Methode ist die richtige für Sie? Ihre Situation Verwenden Sie Sie verbinden eine neue Nummer auf Chatwoot Cloud oder in einer selbst gehosteten Installation mit aktiviertem Schnellsetup Schnellsetup mit Meta Ihre Nummer ist in der WhatsApp Business App , und Sie möchten die App weiterhin auf Ihrem Telefon nutzen Schnellsetup mit Meta und wählen Sie die Verbindung Ihrer bestehenden App. Dies nennt sich Koexistenz. Ihre Nummer ist bereits auf der WhatsApp Business Platform (API) , Sie sind ein technischer Anbieter , der seine eigene Nummer integriert, oder Sie sind selbst gehostet ohne Schnellsetup Manuelles Setup Sie versenden bereits SMS oder WhatsApp über Twilio und möchten die Abrechnung dort beibehalten Twilio . Bitte beachten Sie, dass Kampagnen und Anrufe mit Twilio nicht verfügbar sind. Nicht sicher, welche Funktionen Sie benötigen? Prüfen Sie Ihre Verbindungsmethode entscheidet, was Sie nutzen können in WhatsApp in Chatwoot. Bevor Sie starten (alle Methoden) - Sie sind ein Administrator in Chatwoot. - Für WhatsApp Cloud API: Sie können sich bei Facebook mit einem Konto anmelden, das Admin des Meta Business-Portfolios ist, dem das WhatsApp Business-Konto gehört (oder gehören wird). - Ihre Nummer kann eine Verifizierungs-SMS oder einen Sprachanruf empfangen. Festnetznummern benötigen eine Sprachverifizierung. Nummern, die mit einem automatisierten Telefonmenü (IVR) antworten, werden von Meta nicht unterstützt. - Sie haben Ihre Unternehmensdaten bereit und einen Anzeigenamen, der den Richtlinien von Meta für Anzeigenamen entspricht. Siehe Anzeigename unter Verwalten Sie Ihre WhatsApp-Nummer. Kann ich später die Methode wechseln? - Schnellsetup zu manuellem Setup: In einigen Fällen möglich, ohne Konversationen zu verlieren. Der Chatwoot-Support prüft zunächst die Berechtigung. Dies ist nicht verfügbar für Nummern, die Koexistenz (die WhatsApp Business App) nutzen. Siehe Schnellsetup-Postfach auf manuelles Setup umstellen. - Manuelles Setup zu Schnellsetup: Nicht über das Dashboard verfügbar. - Zwischen Twilio und WhatsApp Cloud API: Dies bedeutet, dass ein neues Postfach erstellt wird. Konversationen bleiben im alten Postfach. Start Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp. Sie sehen zwei Auswahlmöglichkeiten: - WhatsApp Cloud: Schnellsetup mit Meta (oder manuelles Setup, über den Link unten auf diesem Bildschirm) - Twilio
Verbinden Sie sich mit der Schnellinstallation über Meta
Schnelle Einrichtung mit Meta (auch Embedded Signup genannt) verbindet Ihre Nummer über ein Meta-Fenster. Chatwoot richtet das Webhook, das Token und die Telefonnummer für Sie ein. Plan & Zugang - Chatwoot Cloud: Ab dem Startups-Plan enthalten. Während der kostenlosen Testphase klicken Sie auf Zugang anfordern, beschreiben Sie, wie Sie WhatsApp nutzen werden, und klicken Sie auf Absenden, um es zu aktivieren. WhatsApp ist im kostenlosen Hacker-Plan nicht verfügbar. Siehe Preise & Pläne. - Self-hosted: Nur verfügbar, wenn Ihre Installation eine eigene Meta-App für die Schnelleinrichtung konfiguriert hat (WhatsApp App ID, Konfigurations-ID und App Secret, durch den Administrator Ihrer Installation festgelegt). Wenn der Button Mit WhatsApp Business verbinden nicht angezeigt wird, nutzen Sie stattdessen die manuelle Einrichtung. Siehe WhatsApp Embedded Signup für Self-hosted. - Nur für Administratoren. Bevor Sie beginnen - Melden Sie sich bei Facebook mit einem Konto an, das Administrator des richtigen Meta-Geschäftsportfolios ist. - Erlauben Sie Pop-ups für Chatwoot und Facebook. - Weiterverwendung der WhatsApp Business App (Koexistenz): Aktualisieren Sie die App auf die neueste Version und halten Sie das Telefon online. Koexistenz funktioniert mit der WhatsApp Business App, nicht mit der privaten WhatsApp App. Meta entscheidet, welche Nummern berechtigt sind. - Löschen Sie Ihr WhatsApp Business App-Konto nicht, um Koexistenz zu verwenden. Wenn Meta angibt, dass Ihre Nummer nicht berechtigt ist oder mit einem anderen Anbieter verbunden ist, wenden Sie sich an den Support, bevor Sie etwas trennen oder ändern. - Kennen Sie die Koexistenz-Einschränkungen, bevor Sie verbinden: Wenn Sie verbinden, trennt Meta alle verbundenen Geräte (wie WhatsApp Web und Desktop), sodass Sie sie danach erneut verbinden müssen. WhatsApp für Windows und WhatsApp für Wear OS werden nicht unterstützt. Gruppenchats werden nicht synchronisiert und können in Chatwoot nicht genutzt werden. Meta schränkt auch andere App-Funktionen ein, wie Broadcast-Listen und verschwindende Nachrichten. Die vollständige Liste finden Sie bei Meta in Onboarding WhatsApp Business app users. - Wenn Sie im Meta-Fenster ein neues Geschäftskonto erstellen, halten Sie Ihre Unternehmensdaten bereit: Name, Adresse und Webseite. Verbinden Sie Ihre Nummer 1. Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie WhatsApp Cloud. 2. Klicken Sie auf Mit WhatsApp Business verbinden. Es öffnet sich ein Meta-Fenster. 3. Melden Sie sich im Meta-Fenster an und wählen bzw. erstellen Sie Ihr Geschäftskonto und das WhatsApp Business-Konto. 4. Wählen Sie Ihre Nummer: - Eine neue Nummer: Geben Sie sie ein und verifizieren Sie sie mit dem Code, den Meta per SMS oder Sprachanruf sendet. - Eine Nummer in der WhatsApp Business App (Koexistenz): Wählen Sie die Verbindung Ihrer bestehenden App, dann: 1. Kopieren Sie den im Meta-Fenster angezeigten Verifizierungscode. 2. Öffnen Sie auf Ihrem Telefon die Nachricht von Facebook Business, tippen Sie auf Verbinden, dann auf Mit der Business-Plattform verbinden. 3. Tippen Sie auf Bestätigen und wählen Sie aus, ob Sie Ihren Chatverlauf mit Meta teilen möchten. Dies importiert keine alten Chats in Chatwoot. 4. Geben Sie den kopierten Code in der App ein und schließen Sie die Schritte im Meta-Fenster ab. 5. Nach Abschluss der Einrichtung zeigt Chatwoot Sie können jetzt über Ihren neuen Kanal mit Ihren Kunden kommunizieren. Viel Erfolg beim Support! an und öffnet den Schritt Agenten. Wählen Sie die Agenten aus, die dieses Postfach bedienen sollen, und klicken Sie auf Agenten hinzufügen. Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Telefon an Ihre Geschäftsnummer. Sie sollte als neue Konversation erscheinen. Antworten Sie über Chatwoot und prüfen Sie, ob die Antwort ankommt. Prüfen Sie bei Koexistenz auch, ob die App auf Ihrem Telefon weiterhin funktioniert. Was passiert als Nächstes - Vorlagen, die in Ihrem WhatsApp Business-Konto genehmigt wurden, werden automatisch mit Chatwoot synchronisiert. Siehe Vorlagen und 24-Stunden-Fenster. - Anrufe: Wenn Anrufe in Ihrem Plan verfügbar sind, versucht Chatwoot während der Einrichtung, diese zu aktivieren. Wenn Ihre Nummer nicht für Metas Calling API registriert ist, wird das Postfach dennoch erstellt und Sie können Anrufe später aktivieren. Siehe WhatsApp-Anrufe. - Chatverlauf (Koexistenz): Chatwoot importiert keine Chats von vor der Verbindung. Ab dem Moment der Verbindung erscheinen neue Nachrichten von Kunden in Chatwoot, und Antworten, die Sie von der WhatsApp Business App auf Ihrem Telefon senden, erscheinen ebenfalls in der Konversation. - Meta-Prüfungen: Meta kann Sie bitten, Ihr Unternehmen zu verifizieren (Dokumente hochladen) und wird Ihren Anzeigenamen überprüfen. Verfolgen Sie beides unter Account Health. Siehe Verwalten Sie Ihre WhatsApp-Nummer. Wenn die Schnelleinrichtung nicht verfügbar ist Manchmal beschränkt Meta die Schnelleinrichtung für alle Anbieter. Chatwoot zeigt dann einen Hinweis auf dem Einrichtungsbildschirm an. In dieser Zeit gilt: - Nummern, die bereits in der WhatsApp Cloud API sind, können die manuelle Einrichtung nutzen. Siehe Verbindung mit WhatsApp Cloud API (manuelle Einrichtung). - Nummern mit Koexistenz können erst verbunden werden, wenn die Einschränkung aufgehoben ist. Etwas ist schiefgelaufen? Siehe Verbinden in WhatsApp Fehlerbehebung. Dort werden die häufigsten Fehler behandelt, die in diesem Ablauf auftreten können.
Mit der WhatsApp Cloud API verbinden (manuelle Einrichtung)
Verwenden Sie die manuelle Einrichtung, wenn Ihre Nummer bereits auf der WhatsApp Business Platform (API) ist, Sie als technischer Anbieter Ihre eigene Nummer einrichten, Sie selbst gehostet sind und die Schnellinstallation nicht konfiguriert ist oder die Schnellinstallation nicht verfügbar ist. Sie verbinden Chatwoot mit Ihrer eigenen Meta-App. Tarif & Zugriff - Jeder Tarif, der WhatsApp enthält (Startups und höher, sowie die kostenlose Testversion) auf Chatwoot Cloud und Selbst-Hosting. Siehe Preise & Tarife. - Nur Administratoren. - Die Koexistenz (die WhatsApp Business-App weiterhin verwenden) wird bei manueller Einrichtung nicht unterstützt. Wenn Ihre Nummer in der WhatsApp Business-App aktiv ist, registrieren Sie sie nicht über diesen Ablauf. Verwenden Sie Schnellinstallation mit Meta oder wenden Sie sich an den Support. Bevor Sie beginnen Sie benötigen drei Dinge von Meta. Der geführte Ablauf in Chatwoot führt Sie Schritt für Schritt durch jede Anforderung und verlinkt auf den richtigen Meta-Bereich: - Eine Meta-App mit dem WhatsApp-Anwendungsfall - Die Telefonnummern-ID Ihrer Nummer und die WhatsApp Business Account ID - Ein permanentes Zugriffstoken eines Meta-Systembenutzers Verbinden Sie Ihre Nummer 1. Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie WhatsApp Cloud. Klicken Sie auf dem Schnellinstallationsbildschirm ganz unten auf manueller Einrichtungsablauf. (Wenn Schnellinstallation nicht verfügbar ist, gelangen Sie direkt zur manuellen Einrichtung.) 2. Erstellen oder wählen Sie eine Meta-App aus. Erstellen Sie im Meta Developers Portal eine App (oder wählen Sie diejenige, die Sie bereits für diese Nummer verwenden), wählen Sie die Verbindung mit Kunden über WhatsApp und legen Sie das Geschäftsportfolio fest, das die Nummer besitzt. Klicken Sie auf Meine Meta-App ist bereit. 3. Fügen Sie Ihre Telefonnummer hinzu und holen Sie sich deren IDs. Öffnen Sie in Ihrer Meta-App den WhatsApp Anwendungsfall und wählen Sie API-Einrichtung (Anwendungsfälle › Mit Kunden über WhatsApp verbinden › Anpassen › API-Einrichtung). Bei neueren Apps gehen Sie zu Basis-Einrichtung › Produktiv-Einrichtung und öffnen Sie stattdessen Ihre WhatsApp-Telefonnummer registrieren. In Nachrichten senden und empfangen (oder Ihre WhatsApp-Telefonnummer registrieren) öffnen Sie den Von-Auswähler und wählen Sie Ihre Nummer, oder wählen Sie Telefonnummer hinzufügen, füllen Sie das Unternehmensprofil aus und verifizieren Sie sich mit dem Code, den Meta per SMS oder Telefonanruf sendet. Meta ändert diesen Bildschirm häufig. Die Telefonnummern-ID und die WhatsApp Business Account ID werden in der Regel in der Nähe der ausgewählten Von-Nummer angezeigt. Kopieren Sie beide, geben Sie sie in Chatwoot ein und klicken Sie auf Weiter. 4. Generieren Sie ein permanentes Zugriffstoken. Wählen Sie in den Meta Business-Einstellungen das Geschäftsportfolio aus, dem Ihr WhatsApp Business Account gehört, und gehen Sie zu Benutzer › Systembenutzer. Erstellen Sie einen Systembenutzer mit Adminrechten (oder wählen Sie einen bestehenden), weisen Sie ihm Ihre Meta-App und Ihren WhatsApp Business Account mit voller Kontrolle zu und klicken Sie dann auf Token generieren. Wählen Sie die erstellte Meta-App aus, stellen Sie das Ablaufdatum auf Nie, wählen Sie whatsapp_business_management und whatsapp_business_messaging aus, und kopieren Sie das Token. Meta zeigt es nur ein einziges Mal an. Fügen Sie es in Chatwoot als Permanentes Zugriffstoken ein und klicken Sie auf Details überprüfen. 5. Überprüfen Sie den Unternehmensnamen, die Nummer und die IDs, ändern Sie den Postfachnamen falls gewünscht, und klicken Sie auf Postfach erstellen. 6. Chatwoot prüft Zugriff auf Nummer, Vorlagenzugriff, Webhook-Callback und Webhook-Abonnement und richtet automatisch den Webhook in Meta für Sie ein. Sobald alle vier Punkte als Verifiziert angezeigt werden, klicken Sie auf Weiter, um Agenten hinzuzufügen. Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Telefon an Ihre Geschäftsnummer. Sie sollte in Chatwoot erscheinen. Antworten Sie und prüfen Sie, ob sie ankommt. Halten Sie Ihr Token geheim. Jeder mit Zugang kann Ihre WhatsApp-Verbindung nutzen. Wenn Sie es in Meta ersetzen oder widerrufen, aktualisieren Sie es im Reiter Konfiguration des Postfachs. Falls ein Verifizierungsschritt fehlschlägt Nachricht Was tun Dieses Zugriffstoken ist ungültig oder abgelaufen Generieren Sie ein neues permanentes Token (Ablauf Nie ) und versuchen Sie es erneut Vorlagenzugriff nicht verifiziert Dem Token fehlt whatsapp_business_management . Nachrichten funktionieren, aber Vorlagen werden nicht synchronisiert. Erstellen Sie ein Token mit beiden Berechtigungen. Webhook-Callback oder Webhook-Abonnement nicht verifiziert Klicken Sie auf Webhook-Einrichtung wiederholen . Falls es trotzdem fehlschlägt, prüfen Sie, ob der Systembenutzer volle Kontrolle über den WhatsApp Business Account hat. Wenn die Wiederholung weiterhin fehlschlägt, richten Sie den Webhook manuell ein: Kopieren Sie die Webhook-URL und das Webhook-Verifizierungstoken , die auf dem Abschlussbildschirm angezeigt werden (das Token steht auch im Tab Konfiguration des Postfachs). Gehen Sie in Ihrer Meta-App zu WhatsApp › Konfiguration , fügen Sie beides ein, klicken Sie auf Überprüfen und speichern und abonnieren Sie das Feld messages . Geben Sie die Telefonnummern-ID und WhatsApp Business Account ID ein Kopieren Sie beide aus API-Einrichtung in Ihrer Meta-App. Es sind unterschiedliche Nummern. Für alles Weitere siehe WhatsApp-Fehlerbehebung. Was passiert als Nächstes - Vorlagen in Ihrem WhatsApp Business Account werden automatisch synchronisiert. Siehe Vorlagen und das 24-Stunden-Fenster. - Anrufe funktionieren auch mit manueller Einrichtung, sobald Ihre Nummer bei Metas Calling API angemeldet ist. Siehe WhatsApp-Anrufe. Mehr als eine Nummer verbinden Ja, das geht. Erstellen Sie jeweils ein separates Chatwoot-Postfach für jede Nummer. Der geführte Ablauf konfiguriert das Webhook-Routing für jede Nummer, sodass Sie nichts manuell verkabeln müssen.
Verbinden Sie WhatsApp über Twilio
Verbinden Sie eine WhatsApp-Nummer, die Sie in Twilio verwalten. Gut, wenn Sie Twilio bereits für SMS oder WhatsApp nutzen und die Abrechnung dort beibehalten möchten. Plan & Zugriff - Jeder Plan, der WhatsApp enthält (Startups und höher sowie die kostenlose Testversion) auf Chatwoot Cloud und selbstgehostet. Siehe Preise & Pläne. - Nur Administratoren. - Mit Twilio können Sie Templates (Twilio-Inhaltstemplates) und CSAT-Umfragen senden. Sie können keine WhatsApp-Kampagnen oder WhatsApp-Anrufe nutzen. Siehe die Tabelle unter WhatsApp in Chatwoot. Bevor Sie beginnen - Ein Twilio-Konto mit einem in Twilio genehmigten WhatsApp-Absender (Nummer). - Ihre Twilio Account SID und Auth Token oder eine API Key SID und API Key Secret. - Optional: eine Messaging Service SID, wenn Sie über einen Twilio Messaging Service senden. Um eine zu erhalten, gehen Sie in der Twilio-Konsole zu Messaging › Services › Create Messaging Service, führen die Schritte aus und kopieren dann die SID des Dienstes. - Wenn Sie Twilio Studio nutzen, ersetzen Sie Ihren Webhook nicht durch die Callback-URL von Chatwoot. Dadurch wird Ihr Studio-Flow unterbrochen. Kontaktieren Sie zuerst den Support. Verbinden Sie Ihre Nummer 1. Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie Twilio. 2. Geben Sie einen Postfachnamen ein. 3. Geben Sie die Telefonnummer ein, beginnend mit + und ohne Leerzeichen. Wenn Sie über einen Messaging Service senden, aktivieren Sie stattdessen Einen Twilio Messaging Service verwenden und geben die Messaging Service SID ein. Das Feld Telefonnummer wird ausgeblendet, wenn dies aktiviert ist. Sie geben entweder das eine oder das andere ein, nicht beides. 4. Geben Sie Ihre Account SID und entweder Ihr Auth Token oder (nachdem Sie API-Key-Authentifizierung verwenden aktiviert haben) Ihre API Key SID und Ihr API Key Secret ein. 5. Klicken Sie auf Twilio-Kanal erstellen und fügen Sie anschließend Agenten hinzu. 6. Kopieren Sie die in Chatwoot angezeigte Callback-URL und setzen Sie diese als Webhook für eingehende Nachrichten in der Twilio-Konsole: - Für einen WhatsApp-Absender: gehen Sie zu Messaging › Senders › WhatsApp Senders und wählen Ihren Absender aus. Stellen Sie bei Endpoint-Konfiguration die Webhook-URL für eingehende Nachrichten auf die Callback-URL und speichern Sie. - Für einen Messaging Service: gehen Sie zu Messaging › Services, wählen Sie Ihren Service, dann Integration, und fügen Sie dort die URL ein. Um die Callback-URL später zu finden, gehen Sie zu Einstellungen › Postfächer, öffnen Sie Ihr Postfach und wählen die Registerkarte Konfiguration. Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Telefon an Ihre Nummer und prüfen Sie, ob sie in Chatwoot ankommt. Antworten Sie und überprüfen Sie, ob die Antwort auf dem Telefon ankommt. Was passiert als Nächstes - Templates: Genehmigte Twilio-Inhaltstemplates werden mit Chatwoot synchronisiert. Siehe Twilio-Inhaltstemplates unter Templates und das 24-Stunden-Fenster.
Verschieben Sie ein Schnellsetup-Postfach zur manuellen Einrichtung.
Verbinden Sie ein Postfach, das mit der Schnellstart-Einrichtung erstellt wurde, erneut, sodass stattdessen Ihre eigene Meta-App verwendet wird. Ihr Postfach, Ihre Unterhaltungen und Einstellungen bleiben erhalten. Wann Sie dies tun würden Chatwoot zeigt ein Banner mit der Empfehlung Manuelle Einrichtung empfohlen im Postfach an, wenn Meta-Beschränkungen der gemeinsam genutzten Schnellstart-App dieses beeinträchtigen könnten. Die Verbindung über Ihre eigene Meta-App schützt das Postfach vor diesen Einschränkungen. Plan & Zugriff - Verfügbar auf Chatwoot Cloud nur für Administratoren. Siehe Preise & Tarife. - Verfügbar, wenn das Banner Manuelle Einrichtung empfohlen in den Postfacheinstellungen erscheint. Das Banner ist keine Einstellung, die Sie aktivieren können: Es erscheint bei Schnellstart- (Embedded Signup) WhatsApp Cloud-Postfächern, sobald Ihr Konto berechtigt ist, die Nummer keine Koexistenz verwendet und keine Berechtigungsfehler in der Verbindung vorliegen. Kontaktieren Sie den Support, um Ihr Postfach überprüfen zu lassen. - Nicht für Koexistenz-Nummern. Wenn Ihre Nummer auch in der WhatsApp Business App genutzt wird, wenden Sie sich vorab an den Support. Was sich ändert und was bleibt Bleibt gleich Wird aktualisiert Unterhaltungen, Kontakte, Mitarbeitende, Routing, Geschäftszeiten, CSAT- und Bot-Einstellungen sowie die Kunden-Telefonnummer WhatsApp Business Account ID, Phone Number ID und Zugriffstoken Das Webhook für Ihre eigene Meta-App wird nicht automatisch eingerichtet. Kontaktieren Sie vorab den Support, damit das Webhook für Ihre Meta-App eingerichtet wird, bevor Sie das Postfach verschieben. Nach dem Umzug testen Sie es wie in Überprüfen Sie, ob es funktioniert hat beschrieben. Bevor Sie beginnen Kontaktieren Sie zuerst den Support. Der Support hilft Ihnen, das Webhook für Ihre eigene Meta-App einzurichten. Starten Sie den Umzug nicht, bevor der Support bestätigt hat, dass das Webhook bereit ist. Halten Sie Ihre Meta-App, Phone Number ID, WhatsApp Business Account ID und Ihren permanenten Zugriffstoken bereit. Folgen Sie der Anleitung für die manuelle Einrichtung bis zum Schritt Details überprüfen. Ihr Token muss whatsapp_business_messaging enthalten. Fügen Sie auch whatsapp_business_management hinzu, sonst werden Vorlagen nicht synchronisiert. Postfach verschieben 1. Gehen Sie zu Einstellungen › Postfächer und öffnen Sie das WhatsApp-Postfach. 2. Klicken Sie im Banner Manuelle Einrichtung empfohlen auf Manuelle Migration starten. 3. Bevor Sie starten: Lesen Sie, was erhalten bleibt und was aktualisiert wird und fahren Sie dann fort. 4. Geschäftsdaten: Geben Sie die WABA ID und Phone Number ID ein. Die Anzeigenummer wird zur Orientierung angezeigt und kann nicht geändert werden. 5. Zugriffstoken: Fügen Sie Ihren permanenten Zugriffstoken ein. 6. Migration überprüfen: Prüfen Sie die Angaben und klicken Sie auf WhatsApp-Postfach erneut verbinden. Chatwoot überprüft Ihren Token, Ihr Konto und Ihre Nummer bei Meta bevor etwas geändert wird. Falls eine Prüfung fehlschlägt, behält das Postfach seine aktuelle Verbindung. Überprüfen Sie, ob es funktioniert hat - Eine neue Kunden-Nachricht kommt im Postfach an - Eine Antwort von Chatwoot kommt auf dem Handy des Kunden an - Sie können eine Vorlage senden - Mit Vorlagen synchronisieren im Reiter Konfiguration werden Ihre Vorlagen übernommen
Vorlagen und das 24-Stunden-Zeitfenster
Das 24-Stunden-Fenster WhatsApp erlaubt es Ihnen, beliebige Nachrichten zu senden, und zwar 24 Stunden nach der letzten Nachricht des Kunden. Danach können Sie nur noch eine Vorlage senden: eine Nachricht, die Meta im Voraus genehmigt hat. - In Chatwoot wird nach Ablauf des Zeitfensters im Antwortfeld Folgendes angezeigt: You can only reply using a template message due to 24-hour message window restriction - Sobald der Kunde antwortet, beginnt ein neues 24-Stunden-Fenster, und Sie können wieder frei tippen. - Um eine Unterhaltung mit einem Kunden zu beginnen, der Ihnen noch nicht geschrieben hat, benötigen Sie ebenfalls eine Vorlage. Tarif und Zugriff - Jeder Tarif, der WhatsApp umfasst (Startups und höhere Tarife sowie die kostenlose Testversion). Funktioniert mit WhatsApp-Cloud-API-Postfächern (Schnelleinrichtung oder manuell) und Twilio-Postfächern. Siehe Preise und Tarife. - Agents im Postfach können Vorlagen senden. Administratoren können Vorlagen synchronisieren und Tokens verwalten. Woher Vorlagen stammen Vorlagen werden außerhalb von Chatwoot erstellt und genehmigt und anschließend synchronisiert. Postfachtyp Vorlagen erstellen in Mit Chatwoot synchronisieren WhatsApp Cloud API WhatsApp Manager ( Kontotools › Nachrichtenvorlagen ). Meta prüft sie in der Regel innerhalb von 24 Stunden. Automatisch nach einiger Zeit oder sofort über Vorlagen synchronisieren im Tab Konfiguration des Postfachs Twilio Twilio Console (Content Template Builder), anschließend zur Genehmigung an WhatsApp übermittelt Nur manuell: Ein Administrator klickt im Tab Konfiguration des Postfachs auf Vorlagen synchronisieren . Agents können keine Vorlagen synchronisieren. In Chatwoot werden nur genehmigte Vorlagen eines unterstützten Typs angezeigt. Eine Vorlage in einer Unterhaltung senden 1. Öffnen Sie die Unterhaltung und klicken Sie im Antwortfeld auf das Vorlagensymbol. 2. Die Auswahl Whatsapp Templates wird geöffnet. Suchen Sie nach einer Vorlage und wählen Sie sie aus. 3. Füllen Sie die Variablen aus, zum Beispiel den Namen des Kunden oder eine Bestellnummer. Fügen Sie bei Medienkopfzeilen eine öffentliche URL zum Bild, Video oder Dokument ein. Wenn die Vorlage eine Website-Link-Schaltfläche mit einer Variable oder eine Schaltfläche zum Kopieren eines Codes (Gutschein) enthält, füllen Sie auch das Feld Button Parameters aus. 4. Überprüfen Sie die Nachricht, die während der Eingabe der Variablen aktualisiert wird, und klicken Sie auf Send Message. Testen Sie es: Senden Sie zuerst eine Vorlage an Ihre eigene Nummer und prüfen Sie auf dem Telefon, wie sie aussieht. Eine neue Unterhaltung mit einer Vorlage beginnen Verwenden Sie diese Möglichkeit, um einem Kunden zu schreiben, der Ihnen noch nicht geschrieben hat. 1. Öffnen Sie das Formular für eine neue Unterhaltung: Klicken Sie oben in der Seitenleiste auf das Stiftsymbol, auf der Seite Kontakte auf Nachricht oder im Kontaktbereich einer Unterhaltung auf das Symbol Neue Nachricht. 2. Suchen Sie unter An: nach dem Kontakt anhand von Name, E-Mail-Adresse oder Telefonnummer. 3. Wählen Sie unter Über: Ihr WhatsApp-Postfach aus. Wenn Sie den Kontakt über die Suche gefunden haben, wird ein WhatsApp-Postfach nur aufgeführt, wenn der Kontakt eine Telefonnummer hat. Wenn Sie über die Seite des Kontakts oder den Kontaktbereich gestartet sind, werden auch Postfächer aufgeführt, über die der Kontakt Ihnen bereits geschrieben hat. 4. WhatsApp-Postfächer haben hier kein Freitext-Nachrichtenfeld. Klicken Sie auf Vorlage auswählen, suchen Sie nach einer Vorlage und wählen Sie sie aus. 5. Füllen Sie die erforderlichen Variablen, die Medien-URL und die Schaltflächenparameter der Vorlage aus und klicken Sie dann auf Nachricht senden. 6. Wenn The message was sent successfully! angezeigt wird, klicken Sie auf Anzeigen, um die neue Unterhaltung zu öffnen. Bestandteile einer Vorlage Vorlagen können eine Kopfzeile, einen Nachrichtentext, eine Fußzeile und Schaltflächen enthalten: - Kopfzeile: Text, Bild, Video oder Dokument - Nachrichtentext: Ihre Nachricht mit Variablen wie dem Namen des Kunden - Fußzeile: eine kurze Textzeile - Schaltflächen: Schnellantworten, Website-Links, Telefonnummern und Codes zum Kopieren Website-Schaltflächen mit einer Variable Eine Website-Schaltfläche (URL) kann mit einer Variable enden, zum Beispiel https://example.com/order/{{1}}. So erhält jeder Kunde seinen eigenen Link. - In einer Unterhaltung (oder einer neuen Unterhaltung) zeigt Chatwoot für diese Schaltfläche das Feld Button Parameters an. Geben Sie nur den Wert ein, der die Variable ersetzt, zum Beispiel 12345, nicht den vollständigen Link. Die Schaltfläche öffnet dann https://example.com/order/12345. - In einer WhatsApp-Kampagne kommt derselbe Wert in das Feld Buttons (Parameter für Schaltfläche 1 eingeben). Sie können dort wie in den Nachrichtenfeldern Kontaktvariablen verwenden, sodass jeder Empfänger seinen eigenen Link erhält. - Bei einer Schaltfläche zum Kopieren eines Codes wird dasselbe Feld für den Gutscheincode verwendet (bis zu 15 Zeichen). Einige WhatsApp-Vorlagentypen können in Chatwoot nicht verwendet werden: Authentifizierungsvorlagen (OTP), Listen-, Produkt- und Katalogvorlagen, Karussellvorlagen, Kopfzeilen mit Standortangaben, Vorlagen für Anrufberechtigungen sowie Formulare, Zahlungen und Flows. Medien in einer Vorlagenkopfzeile Die Datei muss über einen öffentlichen Link erreichbar sein, auf den WhatsApp (und bei Twilio-Postfächern Twilio) ohne Anmeldung zugreifen kann. Größenbeschränkungen für WhatsApp-Cloud-API-Postfächer (siehe Metas unterstützte Medientypen): Typ Formate Maximale Größe Bild JPEG, PNG 5 MB Video MP4, 3GPP (H.264-Video, AAC-Audio) 16 MB Dokument PDF 100 MB Andere Dokumenttypen wie Word-, Excel-, PowerPoint- und Textdateien können als normale Nachrichten innerhalb einer Unterhaltung gesendet werden, aber nicht in einer Vorlagenkopfzeile. Twilio-Postfächer unterliegen den Twilio-Regeln, die sich von der obigen Tabelle unterscheiden. Twilio akzeptiert Bilder im Format JPG, JPEG oder PNG (bis zu 5 MB), Videos im Format MP4 (H.264-Video, AAC-Audio) und Dokumente im Format PDF, DOC, DOCX, PPTX oder XLSX. Eine Twilio-Medienvorlage kann bis zu 16 MB groß sein, und jede genehmigte Medienvorlage ist auf einen Medientyp festgelegt (Bild, Video oder Dokument). Eine große PDF-Datei, die von einem Cloud-API-Postfach gesendet wird, kann in einem Twilio-Postfach fehlschlagen. Siehe Twilios Medien in Content Templates und WhatsApp-Mediennachrichten. Twilio-Content-Vorlagen (erstellt mit dem Content Template Builder der Twilio Console oder mit Twilios Content API) unterstützen Text (bis zu 100 Variablen), Medien-, Schnellantwort- und Call-to-Action-Vorlagen. Sie können nicht in Kampagnen verwendet werden. Vorlagen mit Listenauswahl, Kataloge und Karussells werden nicht unterstützt. - Twilio-Variablen sind nummerierte Platzhalter wie {{1}}, {{2}}, {{3}}, die der Reihe nach und ohne Lücken verwendet werden. Twilio sendet ihre Werte als Inhaltsvariablen (ContentVariables in der Content API). In Chatwoot geben Sie beim Senden für jede Variable einen Wert ein. Die Anzahl der eingegebenen Variablen muss mit der Vorlage übereinstimmen. - Überprüfen Sie den Genehmigungsstatus einer Vorlage in der Twilio Console, nicht im WhatsApp Manager. - Wenn die Synchronisierung fehlschlägt, prüfen Sie, ob die Account SID und der Auth Token (oder die API Key SID und das API Key Secret) des Postfachs in Twilio noch gültig sind, und synchronisieren Sie anschließend erneut. Bewährte Vorgehensweisen - Utility-Vorlagen (Bestellaktualisierungen, Erinnerungen) sind für Transaktionsnachrichten vorgesehen. Marketing-Vorlagen dienen Werbezwecken und unterliegen Metas Versandregeln. - Holen Sie zuerst die Einwilligung ein. Bevor Sie eine von Ihrem Unternehmen initiierte Nachricht (Vorlage) senden, muss der Kunde zugestimmt haben, Nachrichten Ihres Unternehmens über WhatsApp zu erhalten. Berücksichtigen Sie jeden Abmeldewunsch und senden Sie dem betreffenden Kunden keine weiteren Nachrichten. Siehe Metas Hinweise zur Einwilligung und die WhatsApp Business Messaging Policy. - Verwenden Sie eine kleine Auswahl gut benannter Vorlagen, mit denen Ihr Team vertraut ist. - Meta überwacht die Nachrichtenqualität. Zu viele blockierte oder ignorierte Nachrichten können Ihr Nachrichtenlimit senken. Siehe Nachrichtenlimit unter Ihre WhatsApp-Nummer verwalten. Wenn Vorlagen nicht synchronisiert werden (Postfächer mit Schnelleinrichtung) Manchmal funktionieren Nachrichten weiterhin, aber Vorlagen lassen sich nicht synchronisieren. Das passiert, wenn die bei der Schnelleinrichtung hergestellte Verbindung die Berechtigung zum Lesen Ihres WhatsApp Business Accounts verliert. Sie können das beheben, indem Sie Chatwoot ein Token für die Unternehmensverwaltung bereitstellen, das ausschließlich zur Synchronisierung von Vorlagen verwendet wird. Chatwoot verwendet es nicht zum Senden oder Empfangen von Nachrichten, zum Zustellen von Webhooks, zum Registrieren Ihrer Nummer oder zum Ändern Ihres WhatsApp Business Accounts. Tarif und Zugriff: Chatwoot Cloud, nur Postfächer mit Schnelleinrichtung (einschließlich Coexistence). Bei manuell eingerichteten Postfächern wird ein eigenes Token verwendet; prüfen Sie daher, ob dieses stattdessen über whatsapp_business_management verfügt. Sie müssen sowohl in Chatwoot als auch im Meta-Unternehmensportfolio Administrator sein und benötigen eine mit diesem WhatsApp Business Account verknüpfte Meta-App. 1. Gehen Sie in den Meta-Unternehmenseinstellungen zu Benutzer › Systembenutzer und wählen Sie einen Admin-Systembenutzer aus (oder erstellen Sie einen). Ein eigens dafür angelegter Benutzer wie Chatwoot template sync ist am einfachsten zu verwalten. 2. Klicken Sie auf Assets zuweisen, wählen Sie WhatsApp-Konten, wählen Sie den mit Chatwoot verbundenen WhatsApp Business Account aus und gewähren Sie vollständige Kontrolle. Weisen Sie nur dieses Konto zu. 3. Klicken Sie auf Token generieren, wählen Sie die mit diesem WhatsApp-Konto verknüpfte Meta-App aus und legen Sie ein Ablaufdatum fest (60 Tage sind sicherer; Nie erfordert weniger Wartungsaufwand). 4. Wählen Sie ausschließlich whatsapp_business_management aus und kopieren Sie das Token. Meta zeigt es möglicherweise nur einmal an. Wenn Sie whatsapp_business_management nicht auswählen können, überprüfen Sie, ob WhatsApp für die App eingerichtet ist, der Systembenutzer Zugriff auf die App hat, der WhatsApp Business Account dem Systembenutzer zugewiesen ist und Ihr Unternehmen Metas Anforderungen erfüllt. 5. Gehen Sie in Chatwoot zu Einstellungen › Postfächer, öffnen Sie das Postfach, wechseln Sie zum Tab Konfiguration und suchen Sie Token für die Unternehmensverwaltung hinzufügen. Fügen Sie das Token ein und klicken Sie auf „Hinzufügen“. Chatwoot prüft vor dem Speichern, ob das Token die Berechtigung whatsapp_business_management besitzt. 6. Klicken Sie auf Vorlagen synchronisieren. Behandeln Sie das Token wie ein Passwort. Wenn Sie es in Meta widerrufen, ersetzen Sie es in Chatwoot, andernfalls werden Vorlagen nicht mehr synchronisiert. - 60-Tage-Token: Die Vorlagensynchronisierung wird nach Ablauf des Tokens beendet. Generieren Sie ein neues Token und ersetzen Sie das alte. - Nie ablaufendes Token: Es kann dennoch seine Funktion verlieren, wenn sich der Systembenutzer, die App, die Berechtigung oder die Asset-Zuweisung ändert. - Token ersetzen: Sobald ein Token gespeichert ist, wird das Feld als Token für die Unternehmensverwaltung ersetzen angezeigt. Fügen Sie das neue Token ein und klicken Sie auf Ersetzen.
WhatsApp-Kampagnen
Senden Sie eine genehmigte Vorlage an jeden Kontakt mit den von Ihnen gewählten Labels, zu einem geplanten Zeitpunkt, und sehen Sie, wer sie erhalten und gelesen hat. Plan & Zugang - Chatwoot Cloud: WhatsApp-Kampagnen sind im Business-Plan und höher verfügbar. Sie sind automatisch aktiviert; Sie müssen diese nicht extra anfordern. - Self-hosted: Das Senden von Kampagnen ist keine kostenpflichtige Funktion. Es funktioniert in der Community Edition und ist standardmäßig aktiv. - Kampagnenanalyse: Business-Plan und höher in der Cloud. Bei Self-hosted ist ein kostenpflichtiger Self-hosted-Tarif nötig. Der Super-Admin Ihrer Installation schaltet Kampagnenanalyse unter Super Admin › Accounts › gewünschtes Konto öffnen › Bearbeiten, unter Premiumfunktionen, und klickt anschließend auf Änderungen speichern frei. - Posteingang: Nur WhatsApp Cloud API (Schnelleinrichtung oder manuell). Twilio- und 360dialog-Posteingänge können keine Kampagnen versenden. - Wer: Administratoren. Siehe Preise & Pläne. So prüfen Sie, ob Sie den Zugriff haben: Öffnen Sie Kampagnen in der Seitenleiste. Wenn WhatsApp darunter erscheint, sind Kampagnen für Ihr Konto verfügbar. Bevor Sie beginnen - Mindestens eine genehmigte Vorlage in Ihrem WhatsApp Cloud API-Posteingang. Siehe Vorlagen und das 24-Stunden-Fenster. - Die Kontakte, die Sie erreichen möchten, haben ein Label und entweder eine Telefonnummer oder eine WhatsApp Business-Scoped User ID (BSUID) aus einem früheren Chat in diesem Posteingang. Siehe Wie füge ich Labels hinzu?, Kontakt-Filter und Segmente sowie WhatsApp-Benutzernamen und Business-Scoped User IDs. - Jeder Kontakt, an den Sie senden, hat dem Empfang von WhatsApp-Nachrichten von Ihrem Unternehmen zugestimmt. Siehe Opt-in-Regeln von Meta. Kampagne erstellen 1. Gehen Sie zu Kampagnen › WhatsApp und klicken Sie auf Kampagne erstellen. 2. Grundeinstellungen: Geben Sie einen Titel ein und wählen Sie Ihren WhatsApp-Posteingang aus. Das Kontoinformations-Panel zeigt die Nachrichtenstufe der Nummer, den Kontostatus und die Qualitätsbewertung von Meta an. 3. Zielgruppe: Wählen Sie ein oder mehrere Labels aus. Kontakte mit einem beliebigen dieser Labels sind eingeschlossen. Klicken Sie auf Anzeigen, um genau zu sehen, wer enthalten ist. Das Panel zeigt, wie viele Kunden Ihr WhatsApp-Konto kontaktieren kann. Labels bestimmen nur, wer die Kampagne erhält. Sie erfassen keine Zustimmung, fügen Sie also nur Kontakte hinzu, die zugestimmt haben. 4. Vorlage: Wählen Sie eine genehmigte Vorlage aus und füllen Sie deren Header, Variablen und Buttons aus. Prüfen Sie die Nachrichtenvorschau. 5. Klicken Sie auf Kampagne planen, wählen Sie eine Zeit und klicken Sie auf Erstellen. Testen Sie es: Senden Sie die erste Kampagne an ein Test-Label, das nur Ihre eigene Nummer enthält. Der Live-Test-Button oben im Formular ist nicht verfügbar (sein Tooltip lautet Live-Test wird bald verfügbar sein). Was Sie erwartet - Die Kampagne wird einmal zum geplanten Zeitpunkt versendet. Ihr Status ändert sich von Geplant zu Wird verarbeitet zu Abgeschlossen. - Sie können sie bearbeiten, während sie Geplant ist. Sobald der Versand beginnt, kann sie nicht mehr geändert werden. - Chatwoot sendet an die Telefonnummer des Kontakts. Falls der Kontakt keine Telefonnummer hat, wird an die BSUID dieses Posteingangs gesendet. Ein Kontakt wird übersprungen, wenn: - Weder eine Telefonnummer noch eine BSUID für diesen Posteingang hinterlegt ist - Keine Telefonnummer und mehr als eine BSUID für diesen Posteingang vorhanden ist (Chatwoot trifft hier keine Auswahl) - Nur eine BSUID vorhanden ist und es sich um eine Authentifizierungs-Vorlage handelt, oder Chatwoot die Vorlage nicht unter den synchronisierten Vorlagen des Posteingangs findet, um deren Kategorie zu prüfen (Authentifizierungsvorlagen erfordern eine Telefonnummer) - Die Vorlagenvariablen für diesen Kontakt nicht befüllt werden können - Es können nur genehmigte Vorlagen versendet werden. Freitext-Rundmails sind auf WhatsApp nicht möglich. - Meta berechnet Gebühren für Vorlagennachrichten, einschließlich jeder zugestellten Kampagnen-Nachricht. Die Gebühr richtet sich nach der Vorlagenkategorie und dem Land des Empfängers. Meta stellt diese Gebühren Ihrem WhatsApp Business-Konto in Rechnung, getrennt von Ihrem Chatwoot-Abo. Schätzen Sie die Kosten mit dem WhatsApp Preisrechner und sehen Sie die aktuellen Preise von Meta. - Wie viele Kunden Sie pro Tag kontaktieren können, ist durch Metas Nachrichtenlimit festgelegt, das auf alle Nummern Ihres Unternehmensportfolios verteilt wird. Siehe Verwalten Sie Ihre WhatsApp-Nummer. - Wenn Kunden antworten, wird eine neue Konversation im Posteingang geöffnet und das 24-Stunden-Fenster startet. - An einen Kontakt gesendete Kampagnen-Nachrichten erscheinen in dessen WhatsApp-Chat mit dem Hinweis Kampagne. Ergebnisse ansehen Analytics ist im Business-Plan und höher auf Chatwoot Cloud oder einem kostenpflichtigen Self-hosted-Tarif verfügbar. Klicken Sie auf Analytics anzeigen bei der Kampagne, um zu sehen: - Zielgruppe, An WhatsApp übermittelt, Zugestellt, Gelesen, Fehlgeschlagen und Übersprungen - Die Zustellungen-Tabelle: Der Status jedes Kontakts und, bei Fehlern und Überspringen, der Grund. Filtern Sie nach Status. - Solange eine Kampagne noch gesendet wird, sind die Zahlen vorläufig. Analytics ist eventuell nicht für Kampagnen verfügbar, die vor der Einführung des Liefer-Trackings versendet wurden. Gute Praxis - Erstellen Sie für jede Kampagne ein eigenes Label, statt ein allgemeines mehrfach zu verwenden. - Verwenden Sie Utility-Vorlagen für Updates und Marketing-Vorlagen nur für Kontakte, die zugestimmt haben. - Überwachen Sie nach jeder Kampagne Ihre Qualitätsbewertung. Viele Blockierungen oder Meldungen können Ihr Nachrichtenlimit senken. Fehlerbehebung Symptom Wahrscheinliche Ursache Lösung Kein WhatsApp unter Kampagnen Ihr Plan beinhaltet keine Kampagnen, oder Sie sind kein Administrator Prüfen Sie auf Chatwoot Cloud, ob Sie den Business-Plan oder höher haben. Prüfen Sie, ob Sie als Administrator angemeldet sind. Sind beide Bedingungen erfüllt und der Tab fehlt dennoch, kontaktieren Sie den Chatwoot-Support. Mein Posteingang erscheint nicht in der Liste Es ist ein Twilio- oder 360dialog-Posteingang Kampagnen benötigen einen WhatsApp Cloud API-Posteingang. Siehe So verbinden Sie WhatsApp Dieser Posteingang hat keine genehmigten Vorlagen, die genutzt werden können Keine genehmigten Vorlagen, oder sie wurden nicht synchronisiert Klicken Sie auf Vorlagen synchronisieren . Siehe Vorlagen und das 24-Stunden-Fenster Einige Kontakte haben sie nicht erhalten Keine Telefonnummer oder BSUID, fehlendes Label oder von Meta abgelehnt Öffnen Sie Analytics anzeigen , filtern Sie nach Fehlgeschlagen oder Übersprungen und lesen Sie den Grund. Für Fehlercodes siehe Fehlerbehebung WhatsApp . Ich kann die Kampagne nicht bearbeiten Sie hat bereits mit dem Versand begonnen Erstellen Sie eine neue Kampagne.
CSAT-Umfragen auf WhatsApp
Bitten Sie die Kunden, Ihren Support zu bewerten, wenn ein Gespräch abgeschlossen wurde – auch wenn das 24-Stunden-Fenster bereits geschlossen ist. Chatwoot erstellt die WhatsApp-Vorlage für Sie, reicht sie bei Meta ein und sendet sie, sobald sie genehmigt ist. Plan & Zugriff - Jeder Tarif, der WhatsApp beinhaltet (Startups und höher sowie die kostenlose Testversion). Funktioniert mit WhatsApp Cloud API und Twilio-Posteingängen. Siehe Preise & Pläne. - Administratoren richten es ein. Einrichtung 1. Gehen Sie zu Einstellungen › Posteingänge, öffnen Sie Ihren WhatsApp-Posteingang und wechseln Sie auf den CSAT-Tab. 2. Aktivieren Sie CSAT aktivieren. 3. Füllen Sie die Felder Nachricht, Button-Text und Sprache aus. Die Vorschau zeigt, wie es in WhatsApp aussehen wird. 4. Speichern. Chatwoot erstellt die Vorlage und reicht sie zur Überprüfung bei Meta ein. 5. Warten Sie, bis der Status Von WhatsApp genehmigt angezeigt wird. Optional: Wenn Ihr Konto Captain hat, klicken Sie auf Dienstlichkeitsprüfung, um zu sehen, ob Meta Ihre Nachricht voraussichtlich als Utility behandelt, mit einem Vorschlag zur Überarbeitung. Das ist nur eine Orientierung und keine Garantie. Ohne Captain wird der Button nicht angezeigt. Optional: Wählen Sie aus, bei welchen Gesprächen eine Umfrage verschickt wird, indem Sie Label-Regeln verwenden. Im selben CSAT-Tab, unter Umfrage-Regel, wählen Sie enthält oder enthält nicht und wählen ein oder mehrere Labels aus. Bei enthält wird die Umfrage nur gesendet, wenn das Gespräch mindestens eines dieser Labels hat. Bei enthält nicht, nur wenn kein Label vorhanden ist. Siehe Wie aktiviere ich CSAT-Umfragen?. Testen Sie es: Lösen Sie ein Testgespräch mit Ihrer eigenen Nummer auf. Sie sollten die Umfrage mit einem Button erhalten, der die Bewertungsseite öffnet. Vorlagen-Status Status Bedeutung Ausstehende WhatsApp-Genehmigung Meta überprüft die Vorlage Von WhatsApp genehmigt Umfragen werden automatisch gesendet, wenn Gespräche gelöst werden Meta hat die Vorlage abgelehnt Meta hat abgelehnt. Ändern Sie die Nachricht und speichern Sie, um neu einzureichen. Was Sie erwarten können - Eine Umfrage pro Gespräch. - Bis die Vorlage genehmigt ist, wird die Umfrage nur als normale Nachricht gesendet, solange das 24-Stunden-Fenster offen ist. Ist das Fenster geschlossen, wird keine Umfrage gesendet und das Gespräch zeigt CSAT-Umfrage nicht gesendet wegen Einschränkungen bei ausgehenden Nachrichten. - Chatwoot bearbeitet die bestehende Vorlage nicht. Wenn Sie die Nachricht, den Button-Text oder die Sprache ändern, bittet Chatwoot Sie um Bestätigung (Neue Vorlage erstellen), löscht die aktuelle Vorlage und reicht eine neue zur Genehmigung ein. Bis Meta diese genehmigt, gilt die oben genannte Regel. Falls das Speichern fehlschlägt, speichern Sie erneut, da die vorherige Vorlage möglicherweise schon gelöscht ist. Gute Praxis - Halten Sie die Nachricht kurz und freundlich mit klar erkennbarem Button-Text wie „Jetzt bewerten“. - Nutzen Sie Label-Regeln, damit nur sinnvolle Gespräche eine Umfrage erhalten. - Ändern Sie die Vorlage selten. Jede Änderung pausiert die Umfragen, bis Meta die neue Vorlage genehmigt hat. Sehen Sie Bewertungen unter Wie lese ich CSAT-Berichte?.
WhatsApp-Anrufe
Kunden können Ihr Unternehmen über WhatsApp anrufen, und Agenten nehmen die Anrufe im Browser entgegen. Agenten können außerdem Kunden anrufen, die zugestimmt haben, Anrufe zu empfangen. Plan & Zugriff - Chatwoot Cloud: Business-Tarif und höher. Self-hosted: ein kostenpflichtiger Tarif mit Enterprise Edition ab v4.15.0. Nur die Installation der Enterprise Edition aktiviert diese Funktion nicht. Siehe Preise & Tarife. - Posteingang: Nur WhatsApp Cloud API. Beide Verbindungsarten funktionieren, Schnellsetup und manuelles Setup. Nicht verfügbar für Twilio oder 360dialog WhatsApp-Posteingänge. - Ihre Nummer muss bei der Meta WhatsApp Business Calling API registriert sein. Die aktuellen Anforderungen von Meta beinhalten ein tägliches Messaging-Limit von mindestens 2.000 eindeutigen Empfängern für Ihre Nummer. Prüfen Sie die vollständige, aktuelle Liste in Metas Calling API-Anforderungen, sowie Ihr aktuelles Limit im Meta-Messaging-Limits-Leitfaden. - Wo Anrufe funktionieren: Kunden können Sie aus jedem Land anrufen, in dem die WhatsApp Cloud API verfügbar ist. Anrufe, die Sie starten, sind nicht überall verfügbar: Meta schließt derzeit einige Länder aus, darunter die USA und Kanada, und die Ländervorwahl Ihrer Geschäftsnummer muss unterstützt werden. Siehe Metas Länderverfügbarkeit für Anrufe. - Gebühren für Anrufe: Meta, oder Ihr WhatsApp Business Solution Provider, falls dieser die Abrechnung übernimmt, berechnet Anrufe separat von Ihrem Chatwoot-Tarif. Meta berechnet keine Gebühren für Anrufe, die Kunden an Sie tätigen; Anrufe, die Sie starten, sind kostenpflichtig. Siehe Metas Calling API-Preise. - Administratoren schalten die Funktion ein. Agenten im Posteingang nehmen Anrufe an und tätigen sie. So prüfen Sie, ob Sie es haben: Öffnen Sie die Posteingangseinstellungen. Ein Anrufe-Tab bedeutet, dass Anrufe für Ihr Konto verfügbar sind. Anruf-Funktion aktivieren Neuer Posteingang: Gehen Sie zu Einstellungen › Posteingänge › Posteingang hinzufügen › WhatsApp-Anruf und schließen Sie das Schnellsetup ab. Chatwoot aktiviert Anrufe während des Setups. Bestehender Posteingang: 1. Gehen Sie zu Einstellungen › Posteingänge, öffnen Sie Ihren WhatsApp-Posteingang und wechseln Sie zum Anrufe-Tab. 2. Aktivieren Sie WhatsApp-Anrufe aktivieren. 3. Optional: Bearbeiten Sie die Anruf-Berechtigungsanfrage, die Kunden sehen, wenn Sie um Erlaubnis für einen Anruf bitten. 4. Optional: Setzen Sie die anderen Schalter im Anrufe-Tab: - Eingehende Anrufe erlauben: Wenn ausgeschaltet, werden eingehende Anrufe automatisch abgelehnt, Agenten werden nicht benachrichtigt und es wird keine Konversation erstellt. Ausgehende Anrufe funktionieren weiterhin. - Anrufe aufzeichnen: Hängt die Aufnahme jedes Anrufs an die Konversation an. - Aufzeichnungen transkribieren: Wird angezeigt, wenn Aufzeichnung aktiviert ist. Fügt ein Transkript mit Captain hinzu und benötigt, dass die Audio-Transkription für Ihr Konto freigeschaltet ist. Wenn Sie Sprachanrufe konnten für diese Nummer nicht aktiviert werden sehen, hat Meta die Aktivierung der Anrufe verweigert. Chatwoot zeigt diese Meldung unabhängig vom genauen Grund von Meta an, schließen Sie deshalb nicht, dass die Nummer nicht registriert ist. Prüfen Sie die Nummer auf die oben genannten Meta-Anforderungen (Registrierung, Messaging-Limit, Land). Wenn alles passt, wenden Sie sich mit dem Posteingangsnamen an den Support, damit das Team den genauen Fehler von Meta nachschauen kann. Vor Ihrem ersten Anruf: Jeder Agent muss Mikrofonzugriff für Chatwoot im Browser erlauben. Testen Sie es: Öffnen Sie auf einem anderen Handy WhatsApp, suchen Sie Ihr Unternehmen und tippen Sie auf Anrufen. Eine Anrufbenachrichtigung sollte in Chatwoot erscheinen. Anrufe entgegennehmen und tätigen - Eingehend: Ein Anruffester zeigt den Namen und die Nummer des Anrufers sowie Stadt und Land an, sofern von Chatwoot bekannt. Andernfalls wird der Posteingangsname angezeigt. Agenten können den Anruf Annehmen oder Ablehnen. Schließen (✕) blendet das Fenster nur für Sie aus. Der Anruf wird nicht abgelehnt, sodass andere Agenten weiterhin antworten können. - Ausgehend: In einer Unterhaltung klicken Sie auf WhatsApp-Anruf starten. Wenn der Kunde nicht zugestimmt hat, Anrufe zu empfangen, sendet Chatwoot stattdessen eine Anfrage: Eine Anruf-Berechtigungsanfrage an den Kontakt gesendet. Versuchen Sie es erneut, sobald der Kunde akzeptiert. Sobald der Kunde akzeptiert, rufen Sie erneut an. Siehe Anrufberechtigung unten. - Weitere Anrufmöglichkeiten: Klicken Sie auf Zurückrufen unter einem verpassten oder abgelehnten Anruf in der Unterhaltung oder auf Anrufen auf der Kontakt-Detailseite. - Anrufstatus in der Unterhaltung: Eingehender Anruf, Ausgehender Anruf, Anruf läuft, Anruf beendet, Verpasster Anruf, Keine Antwort. - Aufzeichnungen werden, wenn verfügbar, an die Unterhaltung angehängt. Transkripte werden hinzugefügt, falls Ihr Konto Captain Audio-Transkription aktiviert hat, und es werden Captain-Credits verwendet, bis diese aufgebraucht sind. Siehe Captain AI Credits und Nutzung. Anrufberechtigung Sie können einen Kunden nur anrufen, wenn dieser Ihrem Unternehmen dafür die Erlaubnis erteilt hat. Kunden, die Sie anrufen, benötigen keine Erlaubnis. - Wie Chatwoot fragt: Wenn Sie auf WhatsApp-Anruf starten klicken und keine Berechtigung besitzen, sendet Chatwoot eine WhatsApp-Nachricht mit Ihrer Anruf-Berechtigungsanfrage und einer Option zum Annehmen. Der Kunde nimmt in WhatsApp an oder lehnt ab. - Das 24-Stunden-Fenster muss offen sein: Diese Anfrage ist eine normale WhatsApp-Nachricht und erreicht den Kunden nur, wenn er Ihnen in den letzten 24 Stunden geschrieben hat. Chatwoot prüft das nicht und zeigt die Anfrage so oder so als gesendet an. Ist das Fenster geschlossen, senden Sie zuerst eine genehmigte Vorlage, warten auf die Kunden-Antwort und rufen dann an. - Limits und Ablauf: Meta limitiert, wie oft Sie denselben Kunden fragen können, und legt fest, wie lange seine Zustimmung gilt. Aktuelle Regeln siehe Metas Berechtigungsregeln für Anrufe. Wer den Anruf erhält - Zugewiesene Unterhaltung: Es klingelt nur beim aktuellen Bearbeiter, unabhängig vom Verfügbarkeitsstatus. - Nicht zugewiesene Unterhaltung: Posteingangs-Agenten, die auf Online stehen, klingeln. - Niemand online: Alle Posteingangs-Agenten und Administratoren klingeln. Der erste Agent, der beitritt, nimmt den Anruf an. Wenn die Unterhaltung keinem zugewiesen ist, wird sie dem beitretenden Agenten zugewiesen. Startet ein Agent den Anruf, wird die Unterhaltung ihm zugewiesen, falls sie noch keinem Agenten gehört. Gute Praxis - Fragen Sie frühzeitig nach einer Anrufberechtigung im Verlauf der Unterhaltung, nicht erst, wenn Sie anrufen müssen. - In nicht zugewiesenen Unterhaltungen klingeln nur Posteingangs-Agenten mit Status Online – halten Sie also aktive Agenten online. In zugewiesenen Unterhaltungen klingelt nur der Bearbeiter – weisen Sie die Unterhaltung neu zu, falls der aktuelle Bearbeiter abwesend ist. Fehlerbehebung Symptom Wahrscheinliche Ursache Was tun? Kein Anrufe -Tab Ihr Tarif enthält keine Anruffunktion (Business und höher) oder der Posteingang ist nicht WhatsApp Cloud API Prüfen Sie Ihren Tarif unter Preise & Tarife und Ihre Anbindung unter WhatsApp in Chatwoot Sprachanrufe konnten nicht aktiviert werden Meta hat die Aktivierung abgelehnt. Oft ist die Nummer nicht in der Calling API registriert, aber es kann auch am Messaging-Limit oder Land liegen Prüfen Sie die Meta-Anforderungen für Anrufe, lassen Sie die Nummer ggf. durch Meta oder Ihren Anbieter registrieren und versuchen Sie es erneut. Falls es weiterhin fehlschlägt, kontaktieren Sie den Support mit dem Posteingangsnamen Agent kann nicht hören oder gehört werden Keine Mikrofonberechtigung im Browser Aktivieren Sie Mikrofonzugriff für Chatwoot in den Browser-Einstellungen und prüfen Sie, dass das richtige Mikrofon ausgewählt ist Anrufberechtigungsanfrage wurde kürzlich schon gesendet Der Kunde hat die letzte Anfrage noch nicht beantwortet Warten Sie, bis der Kunde akzeptiert, bevor Sie es erneut versuchen Berechtigungsanfrage wird als gesendet angezeigt, Kunde erhält sie aber nie Das 24-Stunden-Fenster für den Kundendienst war geschlossen Senden Sie eine genehmigte Vorlage, warten auf die Kunden-Antwort, und rufen dann erneut an Für Meta-Fehlercodes und andere WhatsApp-Probleme siehe WhatsApp Fehlerbehebung.
Verwalten Sie Ihre WhatsApp-Nummer
Sehen Sie den Status Ihrer Nummer, das Messaging-Limit und das Unternehmensprofil, ohne Chatwoot zu verlassen. Plan & Zugriff - Jeder Plan, der WhatsApp beinhaltet (Startups und höher, sowie die kostenlose Testversion) für WhatsApp Cloud API-Posteingänge (Schnellinstallation oder manuell). Twilio-Posteingänge haben diesen Tab nicht. - Administratoren. - Prüfen Sie Preise & Pläne, um zu sehen, was jeder Plan umfasst. Account Health öffnen Gehen Sie zu Einstellungen › Posteingänge, öffnen Sie Ihren WhatsApp-Posteingang und wählen Sie den Tab Account Health. Klicken Sie auf Zu Meta Business Manager gehen, um alles zu ändern, was von Meta verwaltet wird. Was Sie sehen werden Abschnitt Was es Ihnen zeigt Unternehmensprofil Die Beschreibung, Adresse, E-Mail und Websites, die Kunden in Ihrem WhatsApp-Profil sehen. Diese Informationen sind hier nur lesbar: Änderungen nehmen Sie in Metas WhatsApp-Verwaltungstools vor. Telefonnummer Anzeigenummer, WhatsApp-Anzeigename und dessen Überprüfungsstatus, Telefonnummernstatus, ob Koexistenz aktiviert ist, und die Telefonnummern-ID Status und Kapazität Qualitätsbewertung (Grün, Gelb, Rot), Business Messaging-Limit , Account-Modus (Sandbox oder Live) und Durchsatz Business Account Name und ID des WhatsApp Business Accounts sowie das zugehörige Unternehmensportfolio Webhook-Konfiguration Ob die Callback-URL von Meta für diese Nummer auf diesen Chatwoot-Posteingang zeigt. Webhook erfolgreich konfiguriert bestätigt nur die Einstellung, nicht den Nachrichtenempfang. Falls Webhook nicht konfiguriert oder Webhook-URL stimmt nicht überein angezeigt wird, klicken Sie auf Webhook registrieren und senden Sie dann eine Testnachricht an Ihre Nummer und antworten Sie aus Chatwoot. Messaging-Limit Das Business Messaging-Limit wird von Meta festgelegt: wie viele einzigartige Kunden Sie außerhalb des 24-Stunden-Fensters (mit Vorlagen) in einem gleitenden Zeitraum von 24 Stunden anschreiben können. Es wird von allen Nummern in Ihrem Unternehmensportfolio gemeinsam genutzt. Meta erhöht das Limit, wenn Sie hochwertige Nachrichten verschicken, und kann es senken, wenn die Qualität sinkt. Anzeigename Ihr Anzeigename ist der Unternehmensname, den Kunden sehen. Meta überprüft ihn. Status in Chatwoot Bedeutung Genehmigt Oben im Chat angezeigt (es kann stattdessen auch ein Name erscheinen, den der Kunde gespeichert hat) Noch nicht geprüft Gespeichert, aber Kunden sehen möglicherweise Ihre Nummer, bis Meta ihn geprüft hat. Meta startet die Prüfung, sobald Sie ein höheres Messaging-Limit erreichen. In Prüfung Meta prüft den Namen. Ändern Sie ihn nicht erneut, bis die Prüfung abgeschlossen ist. Nicht genehmigt Meta hat ihn abgelehnt. Ändern Sie ihn im Meta Business Manager und reichen Sie ihn erneut ein. Damit der Anzeigename beim ersten Mal genehmigt wird: Verwenden Sie Ihren echten Unternehmens- oder Markennamen, der zu Ihrer Website und Ihrem Meta Business Manager passt. Vermeiden Sie allgemeine Begriffe ("Support", "Official"), Emojis, Symbole, Slogans und übermäßige Großschreibung. Nach einer Anzeigenamen-Änderung kann es sein, dass die Nummer von Meta erneut registriert werden muss, bevor Nachrichten wieder wie gewohnt zugestellt werden. Siehe Nachrichten kommen nicht mehr an in WhatsApp beheben. Wenn die Verbindung Aufmerksamkeit benötigt - WhatsApp-Verbindung muss aktualisiert werden (Schnellinstallations-Posteingänge): Öffnen Sie den Posteingang unter Einstellungen › Posteingänge. Das Banner am oberen Rand lautet Ihr Posteingang ist getrennt. Sie erhalten keine neuen Nachrichten, bis Sie ihn erneut autorisieren. Klicken Sie auf den Link Hier klicken, um erneut zu verbinden. in diesem Banner oder gehen Sie zu Konfiguration und klicken Sie auf Neu konfigurieren. Sie benötigen Admin-Zugriff auf den WhatsApp Business Account. - WhatsApp-Zugriffstoken benötigt Aufmerksamkeit (manuelle Posteingänge): Gehen Sie zu Konfiguration und ersetzen Sie das Zugriffstoken durch ein gültiges permanentes Token.
Fehlerbehebung bei WhatsApp
Bevor Sie etwas ändern: Löschen Sie Ihr WhatsApp-Konto nicht, entfernen Sie Ihr WhatsApp Business-Konto nicht und trennen Sie keinen Anbieter als generelle Lösung. Die richtige Wiederherstellung hängt davon ab, wie Ihre Nummer heute eingerichtet ist. Notieren Sie die vollständige Fehlermeldung, jeden Code und den Bildschirm, auf dem sie auftrat. Verbindung herstellen Ermitteln Sie zuerst, wie Ihre Nummer derzeit verwendet wird: eine neue Nummer, eine Nummer in der WhatsApp Business-App (benutzen Sie Koexistenz, um die App zu behalten) oder eine Nummer bei einem anderen API-Anbieter (diese folgen einem anderen Ablauf). Siehe So wählen Sie, wie WhatsApp verbunden wird. Was Sie sehen Meta-Code Bedeutung und Vorgehen Nummer nicht berechtigt, benötigt mehr Aktivität in der WhatsApp Business-App 3441045 Eine Berechtigungsprüfung für Koexistenz. Nutzen Sie die App wie gewohnt mit echten Kund:innen und versuchen Sie es später erneut. Meta gibt kein Minimum an. Generieren Sie keine Fake-Aktivität und erstellen Sie das Konto nicht erneut. Nummer nicht registriert mit der WhatsApp Business-App 2655095, 2655048 Prüfen Sie die Nummer und die Ländervorwahl sowie, dass sie in der Business -App ist (nicht persönliches WhatsApp). Für eine neue API-Nummer verwenden Sie den neuen Nummern-Ablauf. App aktualisieren 4563015 Installieren Sie die neueste WhatsApp Business-App und versuchen Sie es erneut. Unternehmen teilt dieses Konto bereits mit einem Partner 2655093 Meta meldet, dass dieses WhatsApp Business-Konto bereits einem Partner zugeordnet ist. Das bestätigt nicht, dass der andere Anbieter noch aktiv ist. Ein Wechsel des Partners ist in diesem Ablauf nicht möglich. Wenn die Nummer von einem anderen Anbieter stammt, siehe Fehler 2655093 nach dem Wechsel von einem anderen Anbieter unten. Kontaktieren Sie den Support, bevor Sie etwas trennen. Bereits beim Produkt registriert oder trennen Sie Ihre Unternehmensplattform 3441049, 2655094 Eine bestehende Plattform-Verbindung muss zuerst behandelt werden. Um die aktuelle Partner-Verbindung zu sehen: WhatsApp Business App › Einstellungen › Konto › Business Platform oder Meta Business Einstellungen › Konten › WhatsApp-Konten › Partner . Wenn Sie absichtlich trennen, schreibt Meta eine Wartezeit von 15 Minuten vor, bevor Sie es erneut versuchen. Diese Nummer ist bereits einem bestehenden WhatsApp-Konto zugeordnet Die Nummer ist aktiv in der WhatsApp Business-App. Um die App weiterhin zu nutzen, verbinden Sie per Koexistenz ( Quick Setup mit Meta verbinden ). Verwenden Sie nicht den Weg für neue Nummern, da dies die Nummer aus der App entfernt. Diese Telefonnummer existiert bereits in Ihrer Liste der Telefonnummern Kehren Sie zurück und wählen Sie die vorhandene Nummer im richtigen WhatsApp Business-Konto, anstatt sie erneut hinzuzufügen. Nummer ist nicht mit dem gewählten Unternehmen verknüpft 3441041 Wählen Sie das Unternehmens-Portfolio, das die Nummer besitzt. Nummer mit einer Facebook-Seite verknüpft 2655082 Prüfen Sie Meta Business Suite › Einstellungen › Konten › Seiten . Entfernen Sie die Seitenverknüpfung (nach Rücksprache mit dem Seiten-Admin) oder verwenden Sie eine andere Nummer. Konto nutzt Marketing-Nachrichten 3441047 Wählen Sie ein anderes WhatsApp Business-Konto. Wiederholen behebt es nicht. Unternehmen oder Konto eingeschränkt 2655089, 3441040, 2388107 Öffnen Sie Meta Business Support Home , prüfen Sie die Einschränkung und legen Sie Widerspruch ein. Erstellen Sie keine neuen Konten, um dies zu umgehen. Verifizierung wurde mit einem anderen Partner begonnen 2494143 Setzen Sie mit diesem Partner fort oder beantragen Sie direkt eine Meta-Unternehmensverifizierung. Funktion in Ihrer Region nicht verfügbar 3441042 Prüfen Sie die Ländervorwahl. Wenn korrekt, ist dieser Ablauf für die Nummer noch nicht verfügbar. Code konnte nicht gesendet oder verifiziert werden 2388091, 2388093 Überprüfen Sie die Nummer und nutzen Sie eine Methode, die sie empfangen kann (Festnetznummern benötigen einen Anruf). IVR-Nummern werden nicht unterstützt. Weitere Verbindungsprobleme - Konto oder Portfolio fehlt: Melden Sie sich mit dem Facebook-Konto an, das Admin des richtigen Portfolios ist. „Benutzer hat keine Berechtigung“ bedeutet, dass ein bestehender Admin Zugriff gewähren muss. - Facebook-Konto zu neu: Warten Sie ein paar Stunden oder verwenden Sie ein etabliertes Konto mit Unternehmenskontakten. - Unternehmensverifizierung läuft: Prüfen Sie Meta Business Suite › Sicherheitscenter. - Anzeigename abgelehnt: siehe Anzeigename unter Verwalten Sie Ihre WhatsApp-Nummer. - Telefonnummern-Limit erreicht: Wählen Sie die bestehende Nummer, falls sie bereits gelistet ist, oder bitten Sie Meta um ein höheres Limit. Löschen Sie keine funktionierende Nummer. - "Zu viele Versuche geraten": Warten Sie ca. 12 Stunden. "Code zu oft angefordert": Folgen Sie der von Meta angezeigten Wartezeit. - Fehler 2655093 nach Wechsel von einem anderen Anbieter: Die Kreditlinie des bisherigen Anbieters ist möglicherweise noch Ihrem WhatsApp Business-Konto zugeordnet. Das Entfernen des Anbieterzugriffs in Ihren Business-Einstellungen löst dies nicht immer. Zum Prüfen öffnen Sie die Details zur Kreditlinie des Kontos im WhatsApp Manager: Zugewiesen von zeigt den Anbieter, der sie hält. Bitten Sie diesen Anbieter, die Kreditlinie freizugeben, und versuchen Sie dann Quick Setup erneut. Wenn der Fehler weiter auftritt, kontaktieren Sie den Support mit Ihrer WhatsApp Business Account ID und den Fehlerdetails. - Registrieren Sie die Nummer nicht erneut in einer anderen WhatsApp-App, um diesen Fehler zu beheben. Eine Neu-Registrierung unterbricht den Nachrichtenfluss, Nachrichten nach dem Backup können verloren gehen und der Chatverlauf auf dem Telefon wird nicht in Chatwoot importiert. - Koexistenz mit QR-Code verbinden: Statt eines Verifizierungscodes zur Eingabe in der App zeigt der Ablauf evtl. QR-Code scannen an. Nutzen Sie den Scanner und den vom Ablauf vorgegebenen Code und lassen Sie das Meta-Fenster offen, bis alles abgeschlossen ist. Schlägt das Scannen fehl, prüfen Sie Kamera-Berechtigungen und benutzen Sie den aktuellen Code. Wenn der Ablauf nach einem SMS- oder Anruf-Code fragt, stoppen Sie: Das ist der neue Nummernweg, der die Nummer aus der App entfernt. - Koexistenz-Aufforderung oder QR-Code funktioniert nicht: Nutzen Sie die neueste Business-App, lassen Sie das Handy online, lassen Sie das Anmeldefenster offen und prüfen Sie die Kameraberechtigung für QR-Codes. Wechseln Sie nicht auf den manuellen Registrierungsweg, um einen fehlgeschlagenen Koexistenz-Schritt zu umgehen. - Meta-Fenster öffnet sich nicht oder bleibt hängen: Pop-ups erlauben, blockierende Erweiterungen deaktivieren, Meta-Sicherheitsprüfung abschließen und nach einem temporären Fehler einige Minuten warten. - Meta ist fertig, aber kein Posteingang in Chatwoot: Aktualisieren Sie und prüfen Sie Einstellungen › Posteingänge bevor Sie es erneut versuchen. Erstellen Sie keine doppelten Posteingänge. - Alte Chats fehlen nach Koexistenz: Das ist zu erwarten. Chatwoot importiert keine Chats von vor der Verbindung, selbst wenn Sie in Meta das Teilen des Chatverlaufs gewählt haben. Ab Verbindung erscheinen neue Kunden-Nachrichten und Ihre Antworten aus der WhatsApp Business-App in Chatwoot. Stellen Sie keine erneute Verbindung her, um alte Chats zu übertragen. Nachrichten empfangen und senden Symptom Wahrscheinliche Ursache Was tun Nachrichten treffen nicht mehr ein , aber die Nummer ist verbunden und Qualität ist grün Etwas an der Verbindung benötigt Aufmerksamkeit: Registrierung, Berechtigungen oder der Webhook. Häufig nach Änderung des Anzeigenamens oder Profils. Nach jeder Korrektur senden Sie eine Testnachricht an Ihre Nummer und antworten von Chatwoot, um beide Richtungen zu prüfen. Kontaktieren Sie zuerst den Support , damit wir Registrierung, Berechtigungen und Webhook für Ihren Posteingang prüfen können. Wenn die Nummer neu registriert werden muss, erledigen Sie das selbst in Meta und folgen Metas Prozess. Löschen Sie die Nummer nicht und erstellen Sie keinen neuen Posteingang. Koexistenz-Nummern benötigen einen eigenen Wiederherstellungsweg, wenden Sie sich vor Änderungen an den Support. Nach Einrichtung kommen keine Nachrichten an Ein möglicher Grund: Der Webhook ist nicht registriert oder verweist woandershin Öffnen Sie Konto-Integrität . Wenn Webhook-Konfiguration Webhook nicht konfiguriert oder Webhook-URL stimmt nicht überein zeigt, klicken Sie auf Webhook registrieren . Testen Sie: Senden Sie eine Nachricht an Ihre Nummer von einem anderen Handy, prüfen Sie, dass sie in Chatwoot ankommt, und antworten Sie von Chatwoot aus. Bleiben Nachrichten trotz korrekt konfiguriertem Webhook aus, kontaktieren Sie den Support. Für Twilio prüfen Sie die Callback-URL unter WhatsApp via Twilio verbinden . Sie können nur mit einer Vorlage antworten Über 24 Stunden seit letzter Kunden-Nachricht Senden Sie eine Vorlage. Siehe Vorlagen und 24-Stunden-Fenster Nachricht schlägt mit Fehler 131026 fehl (Nachricht unzustellbar) WhatsApp konnte die Nachricht nicht zustellen. Mögliche Gründe: Nummer ist nicht bei WhatsApp, Empfänger hat WhatsApps neueste Bedingungen nicht akzeptiert oder seine App ist veraltet. Bitten Sie den Empfänger über einen anderen Kanal, Nummer und Vorwahl zu prüfen, zu kontrollieren, dass er Sie nicht blockiert hat, seine App zu aktualisieren und Bedingungen zu akzeptieren und Ihnen zuerst eine WhatsApp-Nachricht zu senden. Trennen Sie den Posteingang nicht und registrieren Sie die Nummer für diesen Fehler nicht erneut. Nachricht schlägt mit Fehler 131049 fehl Meta hat diese Marketing-Vorlage nicht zugestellt, um das Engagement gesund zu halten. WhatsApp limitiert, wie viele Marketing-Nachrichten eine Person von allen Unternehmen erhält. Senden Sie die Vorlage nicht erneut oder klicken Sie nicht direkt auf Wiederholen . Warten Sie mindestens 24 Stunden, bevor Sie dieser Person wieder eine Marketing-Vorlage schicken. Antwortet der Kunde, zählen Marketing-Nachrichten im 24-Stunden-Fenster nicht zum Limit. WhatsApp-Verbindung muss aktualisiert werden / Ihr Posteingang ist getrennt Die Quick Setup-Verbindung ist abgelaufen Klicken Sie im Banner auf Hier erneut verbinden . Siehe WhatsApp-Nummer verwalten WhatsApp-Zugangstoken benötigt Aufmerksamkeit Das Token aus dem manuellen Setup ist abgelaufen oder wurde widerrufen Ersetzen Sie es im Tab Konfiguration des Posteingangs Vorlagen Symptom Wahrscheinliche Ursache Was tun Eine Vorlage fehlt in Chatwoot Noch nicht genehmigt, nicht synchronisiert oder von einem Typ, den Chatwoot nicht unterstützt Prüfen Sie den Status im WhatsApp Manager (bei Twilio-Posteingängen in der Twilio-Konsole) und klicken Sie auf Vorlagen synchronisieren . Unterstütze Typen unter Vorlagen und das 24-Stunden-Fenster . Nachrichten funktionieren, aber Vorlagen werden nie synchronisiert (Quick Setup) Die Verbindung hat die Berechtigung zum Lesen Ihres WhatsApp Business-Kontos verloren Fügen Sie ein Business Management Token hinzu Business Management Token: Business management token muss die Berechtigung whatsapp_business_management gewähren whatsapp_business_management wurde nicht ausgewählt Erstellen Sie ein neues Token mit dieser Berechtigung Business Management Token: kein Zugriff, oder Token ungültig Der Systembenutzer hat das WhatsApp-Konto nicht oder das Token ist abgelaufen oder gehört zu einer anderen App Prüfen Sie die zugewiesenen Assets und die App des Systembenutzers, dann ein neues Token generieren Token akzeptiert, Vorlagen fehlen weiterhin Das Token hat Zugriff auf ein anderes WhatsApp Business-Konto Prüfen Sie, dass der Systembenutzer exakt das vom Posteingang genutzte Konto hat und die Vorlagen dort existieren Eine Vorlage lässt sich nicht senden, oder Medien werden nicht angezeigt Leere Variablen, privater oder fehlerhafter Medien-Link oder Datei überschreitet Metas Limits Füllen Sie jede Variable aus, verwenden Sie einen öffentlichen Link und prüfen Sie das Format und die Größenbegrenzungen in Vorlagen und das 24-Stunden-Fenster Ein URL-Button öffnet die falsche Seite oder das Senden der Vorlage schlägt fehl Die Variable des Buttons ist leer oder falsch Bei einem URL-Button mit Variable geben Sie beim Senden den Wert unter Button-Parameter ein. WhatsApp hängt ihn am Ende der im Template gesetzten Basis-URL an. Geben Sie also nur den variablen Teil ein, nicht den vollständigen Link. Prüfen Sie bei Fehlern die exakte Fehlermeldung an der gescheiterten Nachricht und beheben Sie das Benannte. Kontakte und Telefonnummern Nummern sehen in WhatsApp und Chatwoot unterschiedlich aus (Brasilien, Mexiko, Argentinien). Diese Länder haben ihre Mobilnummern-Formate geändert und WhatsApp nutzt möglicherweise noch das alte: - Brasilien: Eine 9 wurde nach der Vorwahl hinzugefügt (+55 11 9 8765-4321 vs +55 11 8765-4321). - Argentinien: Eine 9 nach dem Ländercode kann vorhanden sein oder fehlen (+54 9 11 ... vs +54 11 ...). - Mexiko: WhatsApp kann eine 1 nach dem Ländercode einfügen (+52 1 ... vs +52 ...). Das kommt von WhatsApp und es gibt keine Einstellung dafür. In Brasilien und Mexiko gleicht Chatwoot beide Formate demselben Kontakt zu, sodass die Nummer nur unterschiedlich aussieht. In Argentinien ordnet Chatwoot eine Nachricht des Formats +54 9 einem ohne 9 gespeicherten Kontakt zu, aber nicht umgekehrt. Ein mit 9 gespeicherter Kontakt bekommt einen Doppelten. Am häufigsten tritt dies auf, wenn Sie eine Unterhaltung im aktuellen Format beginnen und WhatsApp von der alten registrierten Nummer antwortet. Sie können trotzdem normal mit diesen Kund:innen weiter schreiben. Ein Kontakt hat keine Telefonnummer. Das ist möglich. WhatsApp ermöglicht, dass manche Personen Unternehmen per Username anschreiben, ohne ihre Nummer preiszugeben. Chatwoot identifiziert den Kontakt dann per Business-Scoped User ID (BSUID) und zeigt den Username an, falls WhatsApp einen liefert. Sie können trotzdem Nachrichten empfangen und antworten. Siehe WhatsApp-Benutzernamen und BSUID in Chatwoot. Support kontaktieren Wenn Sie weiterhin nicht weiterkommen, kontaktieren Sie den Chatwoot-Support mit: - Der vollständigen Fehlermeldung und dem Code sowie einem Screenshot - Dem Schritt, der fehlschlug, und ob der Fehler in Meta oder Chatwoot erschien - Ihrem Posteingang-Link, der Geschäftsnummer mit Ländervorwahl und Zeitpunkt sowie Zeitzone des Versuchs - Wie die Nummer genutzt wird: neu, WhatsApp Business App oder anderer Anbieter - Bei Koexistenz: App-Version, Nutzungsdauer und ob sie auf dem Handy noch funktioniert - Ihrer Portfolio-ID, WhatsApp Business Account ID und Phone Number ID, jeweils beschriftet Teilen Sie niemals Ihr Passwort, Zugriffstoken, Ihren Verifizierungscode oder Ihre Zwei-Faktor-PIN. Schwärzen Sie diese Angaben auf Screenshots. Chatwoot kann Metas Entscheidungen zu Einschränkungen oder Überprüfungen nicht außer Kraft setzen.
WhatsApp-Benutzernamen und unternehmensspezifische Benutzer-IDs in Chatwoot
WhatsApp führt Benutzernamen für Personen ein, die mit Unternehmen chatten möchten, ohne ihre Telefonnummer zu teilen. In diesem Fall kann bei einem WhatsApp-Kontakt in Chatwoot ein Benutzername angezeigt werden oder gar keine Telefonnummer. Chatwoot unterstützt den Empfang und das Beantworten von WhatsApp-Unterhaltungen, bei denen nur eine BSUID verfügbar ist. Ihr Team kann weiterhin WhatsApp-Nachrichten empfangen und beantworten, auch wenn WhatsApp die Telefonnummer des Kunden nicht teilt. Was das für Ihr Team bedeutet Für Agenten bleibt der Arbeitsalltag unverändert. Neue WhatsApp-Unterhaltungen gehen weiterhin in Chatwoot ein, und Agenten können wie gewohnt direkt in der Unterhaltung antworten. Der einzige sichtbare Unterschied ist, dass manche Kontakte möglicherweise keine Telefonnummer haben. Wenn WhatsApp einen Benutzernamen bereitstellt, kann Chatwoot diesen beim Kontakt anzeigen. Wenn der Kunde früher über eine Telefonnummer mit Ihrem Team gechattet hat, werden diese Unterhaltungen möglicherweise unter Vorherige Unterhaltungen angezeigt. Was ist eine BSUID? BSUID steht für Business-Scoped User ID. Das ist die WhatsApp-Identität, über die ein Unternehmen einem Kunden weiterhin Nachrichten senden kann, wenn dessen Telefonnummer nicht verfügbar ist. Beim Antworten über das Chatwoot-Dashboard müssen Agenten BSUIDs weder manuell kopieren noch speichern oder verwalten. Chatwoot verwendet die aktive WhatsApp-Identität, die der Unterhaltung zugeordnet ist. So funktionieren Antworten Chatwoot antwortet mit der aktiven WhatsApp-Identität der Unterhaltung. Wenn WhatsApp eine Telefonnummer bereitstellt, kann Chatwoot diese verwenden. Stellt WhatsApp keine Telefonnummer bereit, verwendet Chatwoot die von Ihrem WhatsApp-Anbieter bereitgestellte BSUID. So kann die aktuelle Unterhaltung weiterhin beantwortet werden, während der Verlauf älterer Unterhaltungen erhalten bleibt. WhatsApp-Cloud-API-Postfächer Bei WhatsApp-Cloud-API-Postfächern (Schnelleinrichtung oder manuell) unterstützt Chatwoot Kontakte, für die nur eine BSUID verfügbar ist. Agenten können diese Unterhaltungen über Chatwoot empfangen und beantworten. Unterstützte WhatsApp-Nachrichtentypen funktionieren auch weiterhin mit Kontakten, für die nur eine BSUID verfügbar ist. Dazu gehören normale Antworten, unterstützte Vorlagen, interaktive Nachrichten und Anhänge. - Vorlagen: Authentifizierungsvorlagen (Einmalcodes) können nicht an einen Kontakt ohne Telefonnummer gesendet werden. - Kampagnen: Chatwoot sendet an die Telefonnummer des Kontakts, sofern vorhanden, und andernfalls an dessen BSUID. Kontakte, für die weder das eine noch das andere verfügbar ist oder für die in diesem Postfach mehr als eine BSUID vorhanden ist, werden übersprungen. Twilio-WhatsApp-Postfächer Bei Twilio-WhatsApp-Postfächern unterstützt Chatwoot die von Twilio übermittelten WhatsApp-Identitätsinformationen, einschließlich BSUID-Informationen, sofern diese im Twilio-Konto verfügbar sind. Die Twilio-Unterstützung kann von den eigenen WhatsApp-Funktionen und dem Einführungsstatus von Twilio abhängen. Wenn eine Nachricht nicht zugestellt wird, prüfen Sie den genauen Twilio-Zustellstatus oder den Fehler des Anbieters. Kunden nach ihrer Telefonnummer fragen In WhatsApp-Cloud-API-Postfächern können Agenten einen Kontakt ohne Telefonnummer bitten, diese mitzuteilen. Klicken Sie dazu in der Unterhaltung im Antwortfeld auf Den Kunden bitten, seine WhatsApp-Telefonnummer mitzuteilen. - Innerhalb von 24 Stunden nach der letzten Nachricht des Kunden sendet Chatwoot die Anfrage als normale Nachricht. Danach benötigen Sie eine genehmigte Vorlage mit einer Schaltfläche, über die Kontaktinformationen angefragt werden. - Es kann jeweils nur eine Anfrage ausstehen. Die Schaltfläche zeigt dann Kontaktinformationsanfrage ausstehend an. - Diese Funktion ist in Twilio-Postfächern nicht verfügbar. Der Kunde entscheidet selbst, ob er die Nummer teilt. Wenn er seine Nummer mitteilt, aktualisiert Chatwoot den Kontakt, sofern die Antwort sicher der aktuellen WhatsApp-Unterhaltung zugeordnet werden kann. Wenn die geteilte Nummer offenbar zu einem anderen Kontakt gehört, markiert Chatwoot sie zur Überprüfung, statt die Kontakte automatisch zusammenzuführen. Der Status der Anfrage lautet zunächst Warten auf Kontaktinformationen und anschließend Telefonnummer geteilt oder Telefonnummer muss überprüft werden, wenn die Nummer zu einem anderen Kontakt gehört. Benutzerdefinierte Integrationen und die API verwenden Wenn Sie in einer bestehenden Unterhaltung eine weitere Nachricht senden, verwenden Sie den Nachrichtenendpunkt dieser Unterhaltung. Chatwoot sendet die Nachricht über die WhatsApp-Identität, die der Unterhaltung bereits zugeordnet ist. Beim Erstellen einer Unterhaltung über die API bestimmt source_id die Messaging-Identität des Kontakts innerhalb des Postfachs. Ein Kontakt kann sowohl eine Telefonnummernidentität als auch eine oder mehrere BSUID-Identitäten haben. Diese dürfen nicht als austauschbar behandelt werden. Die Auswahl einer anderen Identität kann eine separate Unterhaltung erstellen, selbst wenn Auf einzelne Unterhaltung beschränken aktiviert ist. Diese Einstellung verwendet Unterhaltungen innerhalb der ausgewählten Identität erneut; sie führt keine Unterhaltungen über verschiedene Identitäten hinweg zusammen. Wählen Sie nicht ohne Prüfung der Identität und des Postfachs einfach den ersten oder letzten Eintrag in contact_inboxes aus. Um einen bestehenden Austausch fortzusetzen, verwenden Sie weiterhin die ID der Unterhaltung, statt mit einer anderen source_id eine neue Unterhaltung zu erstellen. Bestehende Unterhaltungen werden nicht automatisch zusammengeführt, wenn eine andere Identität verwendet wird.
Unstimmigkeiten bei WhatsApp-Nummern in Brasilien und Argentinien
Diese Anleitung wurde verschoben. Informationen zu Nummern aus Brasilien, Argentinien und Mexiko finden Sie unter Fehlerbehebung bei WhatsApp
Twilio-Inhaltsvorlagen
Diese Anleitung wurde verschoben. Twilio-Inhaltsvorlagen werden jetzt in Vorlagen und das 24-Stunden-Fenster behandelt.