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 gemeinsam aus einem Posteingang beantworten – zusammen mit Ihren anderen Kanälen. Sie können außerdem genehmigte Vorlagennachrichten senden, Broadcast-Kampagnen durchführen, CSAT-Bewertungen sammeln und WhatsApp-Anrufe entgegennehmen. Was Sie auf WhatsApp tun können | Funktion | Was es macht | Mehr erfahren | | --------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------- | | Gemeinsamer WhatsApp-Posteingang | Kundenmeldungen erscheinen als Konversationen, die Ihr Team zuweisen, beschriften, beantworten und erledigen kann | 2. Wählen Sie, wie Sie WhatsApp verbinden | | Vorlagennachrichten | Starten Sie eine Konversation oder antworten Sie nach 24 Stunden mit einer von Meta genehmigten Nachricht | 7. Vorlagen und das 24-Stunden-Fenster | | Kampagnen | Senden Sie eine genehmigte Vorlage an jeden Kontakt mit ausgewählten Labels. Business-Tarif und höher. | 8. WhatsApp-Kampagnen | | CSAT-Umfragen | Bitten Sie um eine Bewertung, wenn eine Konversation abgeschlossen ist – auch nach Ablauf des 24-Stunden-Fensters | 9. CSAT-Umfragen auf WhatsApp | | Anrufe | Kunden rufen Ihr Unternehmen über WhatsApp an, und Agenten nehmen Anrufe im Browser entgegen | 10. WhatsApp-Anrufe | | Kontogesundheit | Sehen Sie den Status Ihrer Nummer, Nachrichtenlimit, Überprüfung des Anzeigenamens und das Unternehmensprofil in Chatwoot | 11. Verwalten Sie Ihre WhatsApp-Nummer | Tarif & Zugriff | | Chatwoot Cloud | Selbst gehostet | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | WhatsApp-Posteingang (jede Verbindungsmethode) | Startups-Tarif und höher sowie die kostenlose Testphase. Nicht verfügbar im kostenlosen Hacker-Tarif. | Inklusive | | Schnellsetup mit Meta (der schnellste Weg zur Verbindung) | Inklusive ab dem Startups-Tarif. Während der kostenlosen Testphase klicken Sie Zugang anfragen im Einrichtungsbildschirm und reichen Sie Ihren Anwendungsfall ein, um es zu aktivieren. | Nur wenn Ihre Installation ihre eigene Meta-App dafür konfiguriert hat. Die meisten selbst gehosteten Installationen nutzen die manuelle Einrichtung. | | WhatsApp-Kampagnen: Versand | Business-Tarif und höher. Automatisch verfügbar, keine Anfrage notwendig. | Kein Premium-Feature. Funktioniert in der Community Edition und ist standardmäßig aktiviert. | | Kampagnen-Analysen | Business-Tarif und höher | Nur Enterprise-Tarif. Der Super-Admin Ihrer Installation aktiviert Kampagnen-Analysen in Super Admin › Accounts › öffnen Sie das Konto › Bearbeiten unter Premium-Features, dann Änderungen speichern. | | Anrufe | Business-Tarif und höher | Benötigt einen kostenpflichtigen selbst gehosteten Tarif mit Enterprise Edition, ab v4.15.0. Die Installation des Enterprise Edition-Builds allein aktiviert es nicht. | | Vorlagen, CSAT-Umfragen, Kontogesundheit | Jeder Tarif, der WhatsApp enthält | Inklusive | Wer was tun kann: - Administratoren verbinden Posteingänge und ändern Posteingangs-Einstellungen. - Agenten mit Zugriff auf den Posteingang beantworten Konversationen und senden Vorlagen. Siehe Preise & Tarife für den jeweiligen Funktionsumfang der Pläne. Ihre Verbindungsmethode bestimmt, was Sie nutzen können Chatwoot verbindet sich auf drei Arten mit WhatsApp. Wählen Sie vor der Verbindung, da manche Funktionen nur mit der WhatsApp Cloud API funktionieren. | | Schnellsetup mit Meta(WhatsApp Cloud API) | Manuelle Einrichtung(WhatsApp Cloud API) | Twilio | | -------------------------------------------------- | -------------------------------------------------- | --------------------------------------- | --------------------------------------- | | Einrichtungsaufwand | Wenige Minuten in einem Meta-Fenster. Keine Entwickler-Einrichtung. | Meta-App, Systembenutzertoken und Webhook | Twilio-Konto, Zugangsdaten und Webhook | | Weiter WhatsApp Business-App auf dem Telefon benutzen | ✅ (Koexistenz) | ❌ | ❌ | | Vorlagennachrichten | ✅ | ✅ | ✅ Twilio-Inhaltsvorlagen | | Kampagnen | ✅ | ✅ | ❌ | | CSAT-Umfragen nach 24 Stunden | ✅ | ✅ | ✅ | | Anrufe | ✅ | ✅ | ❌ | | Reiter "Kontogesundheit" | ✅ | ✅ | ❌ | | Verfügbar auf | Chatwoot Cloud | Cloud und selbst gehostet | Cloud und selbst gehostet | Sie nutzen 360dialog? 360dialog wird für neue Posteingänge nicht mehr angeboten. Bestehende 360dialog-Posteingänge funktionieren weiter für Konversationen, aber können keine Kampagnen, Anrufe oder CSAT-Vorlagen nutzen. So prüfen Sie, was Sie haben - Ihr Posteingangs-Typ: Gehen Sie zu Einstellungen › Posteingänge und öffnen Sie Ihren WhatsApp-Posteingang. Ein Tab Kontogesundheit bedeutet, es ist ein WhatsApp Cloud API-Posteingang. - Schnellsetup: Im WhatsApp-Einrichtungsbildschirm zeigt ein Zugang anfragen-Feld statt des Verbindungs-Buttons, dass Schnellsetup für Ihr Konto noch nicht aktiviert ist. - Kampagnen: WhatsApp unter Kampagnen in der Seitenleiste bedeutet, dass Kampagnen für Ihr Konto verfügbar sind. - Anrufe: Ein Tab Anrufe in den Posteingangs-Einstellungen bedeutet, dass Anrufe für Ihr Konto verfügbar sind. Ihr Weg durch diese Anleitung 1. Verbinden: Wählen Sie, wie Sie WhatsApp verbinden, dann die Seite für Ihre Methode (3, 4 oder 5). 2. Lernen Sie die eine Regel, die WhatsApp bestimmt: Vorlagen und das 24-Stunden-Fenster. 3. Fügen Sie hinzu, was Sie brauchen: Kampagnen (8), CSAT (9), Anrufe (10). 4. Gesund halten: Verwalten Sie Ihre WhatsApp-Nummer. 5. 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 nutzen Chatwoot Cloud und verbinden eine neue Nummer | Schnelle Einrichtung mit Meta (Seite 3) | | Ihre Nummer ist in der WhatsApp Business App und Sie möchten die App weiterhin auf Ihrem Handy nutzen | Schnelle Einrichtung mit Meta und wählen Sie, Ihre bestehende App zu verbinden (Seite 3). Dies wird Coexistence genannt. | | Ihre Nummer ist bereits auf der WhatsApp Business Platform (API), Sie sind ein technischer Anbieter, der seine eigene Nummer onboardet, oder Sie sind self-hosted | Manuelle Einrichtung (Seite 4) | | Sie senden bereits SMS oder WhatsApp über Twilio und möchten die Abrechnung dort behalten | Twilio (Seite 5). Beachten Sie, dass Kampagnen und Anrufe mit Twilio nicht verfügbar sind. | Nicht sicher, welche Funktionen Sie benötigen? Lesen Sie Ihre Verbindungsmethode entscheidet, was Sie nutzen können unter WhatsApp in Chatwoot. Bevor Sie beginnen (alle Methoden) - Sie sind 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, das das WhatsApp Business-Konto besitzt (oder besitzen wird). - Ihre Nummer kann eine Verifizierungs-SMS oder 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 für Anzeigenamen von Meta entspricht. Siehe Anzeigename unter Verwalten Sie Ihre WhatsApp Nummer. Kann ich später die Methode wechseln? - Schnelle Einrichtung zu manueller Einrichtung: In einigen Fällen möglich, ohne Unterhaltungen zu verlieren. Der Chatwoot-Support prüft zuerst die Berechtigung, und dies ist nicht verfügbar für Nummern, die Coexistence (die WhatsApp Business App) verwenden. Siehe Verschieben Sie ein Schnell-Einrichtungs-Postfach zu manueller Einrichtung. - Manuelle Einrichtung zu schneller Einrichtung: Nicht über das Dashboard verfügbar. - Zwischen Twilio und WhatsApp Cloud API: Dies bedeutet, ein neues Postfach zu erstellen. Unterhaltungen bleiben im alten Postfach. Start Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp. Sie sehen zwei Auswahlmöglichkeiten: - WhatsApp Cloud: Schnelle Einrichtung mit Meta (oder manuelle Einrichtung, über den Link unten auf diesem Bildschirm) - Twilio
Schnelle Einrichtung mit Meta verbinden
Schnelle Einrichtung mit Meta (auch Embedded Signup genannt) verbindet Ihre Nummer über ein Meta-Fenster. Chatwoot richtet den Webhook, das Token und die Telefonnummer für Sie ein. Plan & Zugriff - Nur Chatwoot Cloud. Ab dem Startups-Plan enthalten. Während der kostenlosen Testphase klicken Sie auf Zugang anfragen, beschreiben, wie Sie WhatsApp nutzen werden, und klicken auf Absenden, um es zu aktivieren. WhatsApp ist im kostenlosen Hacker-Plan nicht verfügbar. Siehe Preise & Pläne. - Nur Administratoren. Bevor Sie beginnen - Melden Sie sich bei Facebook mit einem Konto an, das Admin des richtigen Meta-Unternehmensportfolios ist. - Pop-ups für Chatwoot und Facebook zulassen. - Die WhatsApp Business App beibehalten (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. 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. Ein Meta-Fenster öffnet sich. 3. Melden Sie sich im Meta-Fenster an, wählen oder erstellen Sie Ihr Unternehmensportfolio und 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 Anruf sendet. - Eine Nummer in der WhatsApp Business App (Koexistenz): wählen Sie, ob Sie Ihre bestehende App verbinden möchten, dann: 1. Den im Meta-Fenster angezeigten Bestätigungscode kopieren. 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, ob Sie Ihren Chatverlauf teilen möchten. 4. Geben Sie den kopierten Code in der App ein und schließen Sie die Schritte im Meta-Fenster ab. 5. Wenn Sie WhatsApp Business-Konto verbunden! sehen, fügen Sie die Agenten hinzu, die dieses Postfach beantworten sollen. Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Telefon an Ihre Geschäftsnummer. Sie sollte als neue Konversation erscheinen. Antworten Sie aus Chatwoot und überprüfen Sie, ob die Nachricht ankommt. Bei Koexistenz prüfen Sie zusätzlich, 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 das 24-Stunden-Zeitfenster. - Anrufen: Falls Anrufe in Ihrem Plan enthalten sind, versucht Chatwoot, diese während der Einrichtung zu aktivieren. Ist Ihre Nummer nicht für Metas Calling API angemeldet, wird das Postfach dennoch erstellt und Sie können Anrufe später aktivieren. Siehe WhatsApp-Anrufe. - Chatverlauf (Koexistenz): Meta synchronisiert den Verlauf nur innerhalb von 24 Stunden nach der Verbindung. Lassen Sie die App mit einer stabilen Verbindung geöffnet. Große Verläufe dauern länger. - Meta-Prüfungen: Meta kann Sie dazu auffordern, Ihr Unternehmen zu verifizieren (Dokumente hochladen) und prüft Ihren Anzeigenamen. Verfolgen Sie beides in Account Health. Siehe Verwalten Sie Ihre WhatsApp-Nummer. Falls die schnelle Einrichtung nicht verfügbar ist Manchmal beschränkt Meta die schnelle Einrichtung für alle Anbieter. Chatwoot zeigt dann eine Mitteilung auf dem Einrichtungsbildschirm an. Während dieser Zeit: - Bereits auf der WhatsApp Cloud API befindliche Nummern können die manuelle Einrichtung nutzen. Siehe Mit WhatsApp Cloud API verbinden (manuelle Einrichtung). - Nummern mit Koexistenz können erst nach Aufhebung der Beschränkung verbunden werden. Etwas ist schiefgelaufen? Siehe Verbinden in WhatsApp-Fehlerbehebung. Dort werden alle möglichen Meta-Fehlercodes während dieses Ablaufs behandelt.
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 einbinden, Sie selbst gehostet sind oder die Schnell-Einrichtung nicht verfügbar ist. Sie verbinden Chatwoot mit Ihrer eigenen Meta-App. Plan & Zugriff - Jeder Tarif, der WhatsApp enthält (Startups und höher sowie die kostenlose Testversion) auf Chatwoot Cloud und selbst gehostet. Siehe Preise & Tarife. - Nur Administratoren. - Koexistenz (die WhatsApp Business-App behalten) wird bei der manuellen Einrichtung nicht unterstützt. Wenn Ihre Nummer in der WhatsApp Business-App aktiv ist, registrieren Sie sie nicht über diesen Ablauf. Verwenden Sie die Schnell-Einrichtung (Seite 3) oder kontaktieren Sie den Support. Bevor Sie beginnen Sie benötigen drei Dinge von Meta. Die geführte Einrichtung in Chatwoot begleitet Sie durch jeden Schritt und verlinkt auf den richtigen Meta-Bildschirm: - Eine Meta-App mit dem WhatsApp-Anwendungsfall - Die Phone Number ID und WhatsApp Business Account ID Ihrer Nummer - Einen permanenten Zugriffstoken von einem Meta-Systembenutzer Verbinden Sie Ihre Nummer 1. Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie WhatsApp Cloud. Auf dem Schnell-Einrichtung-Bildschirm klicken Sie unten auf manuelle Einrichtung. (Wenn die Schnell-Einrichtung nicht verfügbar ist, gelangen Sie direkt zur manuellen Einrichtung.) 2. Erstellen oder wählen Sie eine Meta-App aus. Erstellen Sie in Meta Developers eine App (oder wählen Sie die, die Sie bereits für diese Nummer verwenden), wählen Sie die Verbindung zu Kunden über WhatsApp und wählen Sie das Geschäftsportfolio, dem die Nummer gehört. Klicken Sie auf Meine Meta-App ist bereit. 3. Fügen Sie Ihre Telefonnummer hinzu und erhalten Sie deren IDs. Öffnen Sie in Ihrer Meta-App den WhatsApp-Anwendungsfall und wählen Sie API-Einrichtung. Öffnen Sie unter Nachrichten senden und empfangen den Von-Selektor und wählen Sie Ihre Nummer, oder klicken Sie auf Telefonnummer hinzufügen, vervollständigen Sie das Geschäftsprofil und verifizieren Sie mit dem von Meta gesendeten Code. Kopieren Sie die Phone Number ID und WhatsApp Business Account ID, geben Sie sie in Chatwoot ein und klicken Sie auf Weiter. 4. Generieren Sie einen permanenten Zugriffstoken. Gehen Sie in den Meta Business-Einstellungen zu Benutzer › Systembenutzer, erstellen Sie einen Admin-Systembenutzer (oder wählen Sie einen), ordnen Sie diesem Ihre Meta-App und das WhatsApp Business-Konto mit voller Kontrolle zu und klicken Sie dann auf Token generieren. Stellen Sie das Ablaufdatum auf Nie, wählen Sie whatsapp_business_management und whatsapp_business_messaging aus und kopieren Sie den Token. Meta zeigt ihn nur einmal an. Tragen Sie ihn anschließend in Chatwoot als Permanent access token ein und klicken Sie auf Details überprüfen. 5. Überprüfen Sie den Geschäftsnahmen, die Nummer und die IDs, ändern Sie ggf. den Postfachnamen und klicken Sie auf Postfach erstellen. 6. Chatwoot prüft Nummerzugriff, Vorlagenzugriff, Webhook-Callback und Webhook-Abonnement und richtet den Webhook automatisch in Meta ein. Wenn alle vier als Verifiziert angezeigt werden, klicken Sie auf Weiter, um Agenten hinzuzufügen. Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Handy an Ihre Geschäftsnummer. Sie sollte in Chatwoot erscheinen. Antworten Sie und prüfen Sie, ob sie ankommt. Halten Sie Ihren Token geheim. Jeder, der ihn hat, kann Ihre WhatsApp-Verbindung nutzen. Wenn Sie ihn bei Meta ersetzen oder widerrufen, aktualisieren Sie ihn im Tab 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. Generieren Sie einen Token mit beiden Berechtigungen. | | Webhook-Callback oder Webhook-Abonnement nicht verifiziert | Klicken Sie auf Webhook-Einrichtung wiederholen. Falls es weiterhin fehlschlägt, prüfen Sie, ob der Systembenutzer volle Kontrolle über das WhatsApp Business-Konto hat. | | Geben Sie die Phone Number ID und WhatsApp Business Account ID ein | Kopieren Sie beide aus der API-Einrichtung in Ihrer Meta-App. Es handelt sich um unterschiedliche Nummern. | Alles Weitere finden Sie unter WhatsApp Fehler beheben. Wie geht es weiter - Vorlagen, die in Ihrem WhatsApp Business-Konto genehmigt wurden, werden automatisch synchronisiert. Siehe Vorlagen und das 24-Stunden-Fenster. - Anrufe funktionieren auch mit manueller Einrichtung, sobald Ihre Nummer bei Metas Calling API registriert ist. Siehe WhatsApp-Anrufe. Mehrere Nummern verbinden Ja, das ist möglich. Erstellen Sie für jede Nummer ein separates Chatwoot-Postfach. Die geführte Einrichtung konfiguriert das Webhook-Routing für jede einzelne, Sie müssen nichts manuell zuweisen.
Verbinde WhatsApp über Twilio
Verbinden Sie eine WhatsApp-Nummer, die Sie in Twilio verwalten. Empfehlenswert, wenn Sie Twilio bereits für SMS oder WhatsApp nutzen und die Abrechnung dort behalten möchten. Plan & Zugriff - Jeder Plan, der WhatsApp einschließt (Startups und höher sowie die kostenlose Testversion) auf Chatwoot Cloud und Selbst-Hosting. Siehe Preise & Pläne. - Nur Administratoren. - Mit Twilio können Sie Vorlagen (Twilio-Inhaltsvorlagen) und CSAT-Umfragen versenden. Sie können jedoch keine WhatsApp-Kampagnen oder WhatsApp-Anrufe nutzen. Siehe die Tabelle unter WhatsApp in Chatwoot. Bevor Sie beginnen - Ein Twilio-Konto mit einer in Twilio genehmigten WhatsApp-Absendernummer. - Ihre Twilio Account SID und Auth Token oder eine API Key SID und ein API Key Secret. - Optional: eine Messaging Service SID, falls Sie über einen Twilio Messaging Service senden. Um eine zu erhalten, gehen Sie in der Twilio-Konsole auf Messaging › Services › Create Messaging Service, führen die Schritte aus und kopieren dann die SID des Dienstes. - Wenn Sie Twilio Studio verwenden, ersetzen Sie Ihren Webhook nicht durch die Callback-URL von Chatwoot. Dies würde Ihren Studio-Flow stoppen. Wenden Sie sich zuerst an den Support. Verbinden Sie Ihre Nummer 1. Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie Twilio aus. 2. Geben Sie einen Postfach-Namen ein. 3. Geben Sie die Telefonnummer ein, beginnend mit + und ohne Leerzeichen. Wenn Sie über einen Messaging Service senden, aktivieren Sie stattdessen Twilio Messaging Service verwenden und geben Sie die Messaging Service SID ein. Das Feld Telefonnummer wird dann ausgeblendet. Sie geben eines von beiden an, nicht beides. 4. Geben Sie Ihre Account SID und entweder Ihren Auth Token oder (nach Aktivierung von API-Key-Authentifizierung verwenden) Ihre API Key SID und Ihr API Key Secret ein. 5. Prüfen Sie, ob Sie entweder die Telefonnummer oder, bei aktivierter Funktion Twilio Messaging Service verwenden, die Messaging Service SID eingegeben haben (siehe Schritt 3). 6. Klicken Sie auf Twilio-Kanal erstellen und fügen Sie anschließend Agenten hinzu. 7. Kopieren Sie die in Chatwoot angezeigte Callback-URL und richten Sie diese als Webhook für eingehende Nachrichten in der Twilio-Konsole ein: - Für einen WhatsApp-Absender: Gehen Sie zu Messaging › Senders › WhatsApp Senders und wählen Sie Ihren Absender aus. Unter Endpoint-Konfiguration legen Sie die Webhook-URL für eingehende Nachrichten auf die Callback-URL fest und speichern. - Für einen Messaging Service: Gehen Sie zu Messaging › Services, wählen Sie Ihren Service, dann Integration, und fügen Sie die URL dort ein. Um die Callback-URL später erneut zu finden, gehen Sie zu Einstellungen › Postfächer, öffnen Ihr Postfach und wählen den Tab Konfiguration. Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Handy an Ihre Nummer und prüfen Sie, ob sie in Chatwoot ankommt. Antworten Sie und kontrollieren Sie, ob die Antwort auf dem Handy ankommt. Was passiert als Nächstes - Vorlagen: Genehmigte Twilio-Inhaltsvorlagen werden mit Chatwoot synchronisiert. Siehe Twilio-Inhaltsvorlagen unter Vorlagen und das 24-Stunden-Fenster.
Verschieben Sie ein Schnellsetup-Postfach zur manuellen Einrichtung.
Verbinde ein mit der Schnellinstallation erstelltes Postfach erneut, sodass deine eigene Meta-App verwendet wird. Dein Postfach, deine Unterhaltungen und Einstellungen bleiben erhalten. Wann du dies tun solltest Chatwoot zeigt ein Banner Manuelle Einrichtung empfohlen im Postfach an, wenn Meta-Einschränkungen für die gemeinsame Schnellinstallations-App das Postfach beeinträchtigen könnten. Die Verbindung über deine eigene Meta-App schützt das Postfach vor diesen Einschränkungen. Plan & Zugriff - Chatwoot Cloud Preise & Tarife, nur Administratoren. - Verfügbar, wenn das Banner Manuelle Einrichtung empfohlen in den Postfacheinstellungen erscheint. Das Banner ist keine Einstellung, die du aktivieren kannst: Es erscheint für WhatsApp Cloud-Postfächer mit Schnellinstallation (Embedded Signup), sobald dein Konto Zugriff erhalten hat, die Nummer nicht im Koexistenz-Modus verwendet wird und die Verbindung keinen Autorisierungsfehler aufweist. Kontaktiere den Support, um dein Postfach prüfen zu lassen. - Nicht für Koexistenz-Nummern. Wenn deine Nummer auch in der WhatsApp Business App verwendet wird, wende dich vor jeglichen Änderungen 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 kundenseitige Telefonnummer | WhatsApp Business Account ID, Telefonnummer-ID und Zugriffstoken | Das Webhook für deine eigene Meta-App wird nicht automatisch eingerichtet. Kontaktiere den Support, bevor du beginnst, damit das Webhook für deine Meta-App eingerichtet ist, bevor du das Postfach umstellst. Nach dem Umzug teste wie unter Prüfen, ob es funktioniert hat beschrieben. Bevor du beginnst Halte deine Meta-App, Telefonnummer-ID, WhatsApp Business Account ID und dauerhaften Zugriffstoken bereit. Folge den Schritten 2 bis 4 in Mit WhatsApp Cloud API verbinden (manuelle Einrichtung). Dein Token muss whatsapp_business_messaging beinhalten. Füge auch whatsapp_business_management hinzu, sonst werden Vorlagen nicht synchronisiert. Postfach umziehen 1. Gehe zu Einstellungen › Postfächer und öffne das WhatsApp-Postfach. 2. Klicke im Banner Manuelle Einrichtung empfohlen auf Manuelle Migration starten. 3. Bevor du beginnst: Lies, was beibehalten und was aktualisiert wird, dann gehe weiter. 4. Geschäftsdaten: Gib die WABA ID und Telefonnummer-ID ein. Die Angezeigte Telefonnummer wird nur zur Referenz angezeigt und kann nicht geändert werden. 5. Zugriffstoken: Füge deinen dauerhaften Zugriffstoken ein. 6. Migration überprüfen: Prüfe die Angaben und klicke auf WhatsApp-Postfach erneut verbinden. Chatwoot prüft dein Token, Konto und Nummer bei Meta bevor etwas geändert wird. Schlägt eine Prüfung fehl, behält das Postfach seine aktuelle Verbindung. Prüfen, ob es funktioniert hat - Eine neue Kundennachricht kommt im Postfach an - Eine Antwort von Chatwoot erreicht das Handy des Kunden - Du kannst eine Vorlage versenden - Vorlagen synchronisieren im Tab Konfiguration bringt deine Vorlagen herein
Vorlagen und das 24-Stunden-Fenster
Das 24-Stunden-Fenster WhatsApp ermöglicht es dir, jede Nachricht für 24 Stunden nach der letzten Nachricht des Kunden zu senden. Danach kannst du nur noch eine Vorlage senden: eine Nachricht, die Meta im Voraus genehmigt hat. - In Chatwoot zeigt das Antwortfeld nach Ablauf des Fensters folgendes an: Sie können aufgrund der 24-Stunden-Nachrichtenfenster-Beschränkung nur mit einer Vorlagennachricht antworten - Sobald der Kunde antwortet, öffnet sich ein neues 24-Stunden-Fenster und du kannst wieder frei tippen. - Um eine Konversation zu beginnen mit einem Kunden, der dir noch nicht geschrieben hat, benötigst du ebenfalls eine Vorlage. Plan & Zugriff - Jeder Tarif, der WhatsApp beinhaltet (Startups und höher sowie die kostenlose Testversion). Funktioniert mit WhatsApp Cloud API Posteingängen (Schnellstart oder manuell) und Twilio Posteingängen. Siehe Preise & Tarife. - Agenten im Posteingang können Vorlagen senden. Administratoren können Vorlagen synchronisieren und Token verwalten. Woher Vorlagen kommen Vorlagen werden außerhalb von Chatwoot erstellt und genehmigt, dann synchronisiert. | Posteingangstyp | Vorlagen erstellen in | Nach Chatwoot synchronisieren | | ----------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | | WhatsApp Cloud API | WhatsApp Manager (Kontotools › Nachrichtenvorlagen). Meta prüft diese, meistens innerhalb von 24 Stunden. | Automatisch nach einiger Zeit oder sofort mit Vorlagen synchronisieren im Reiter Konfiguration des Posteingangs | | Twilio | Twilio Console (Content Template Builder), dann an WhatsApp zur Freigabe senden | Automatisch oder mit dem Synchronisierungs-Button in den Posteingangseinstellungen | Nur freigegebene Vorlagen eines unterstützten Typs erscheinen in Chatwoot. Sende eine Vorlage in einer Konversation 1. Öffne die Konversation und klicke auf das Vorlagen-Symbol im Antwortfeld. 2. Der Whatsapp Vorlagen-Auswahldialog öffnet sich. Suche nach einer Vorlage und wähle sie aus. 3. Fülle die Variablen aus, zum Beispiel den Namen des Kunden oder eine Bestellnummer. Für Medien-Header füge eine öffentliche URL zum Bild, Video oder Dokument ein. 4. Überprüfe die Nachricht, die sich aktualisiert, während du die Variablen ausfüllst, und klicke auf Nachricht senden. Teste es: Sende zuerst eine Vorlage an deine eigene Nummer und überprüfe, wie sie auf dem Handy aussieht. Woraus eine Vorlage besteht Vorlagen können einen Header, Body, Footer und Buttons enthalten: - Header: Text, Bild, Video oder Dokument - Body: deine Nachricht, mit Variablen wie dem Kundennamen - Footer: eine kurze Textzeile - Buttons: Schnellantworten, Webseiten-Links, Telefonnummern und "Kopieren"-Code Einige WhatsApp-Vorlagentypen können in Chatwoot noch nicht verwendet werden: Authentifizierungs-(OTP)-Vorlagen, Listen-, Produkt- und Katalogvorlagen, Karussellvorlagen, Standort-Header, Anrufberechtigungsvorlagen sowie Formulare, Zahlungen und Flows. Medien im Vorlagen-Header Die Datei muss unter einem öffentlichen Link erreichbar sein, auf den Meta ohne Login zugreifen kann. Metas Grenzwerte: | 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 Dokumententypen wie Word, Excel, PowerPoint und Textdateien können als normale Nachrichten in einer Konversation verschickt werden, aber nicht im Vorlagen-Header. Twilio Content Templates unterstützen Text (bis zu 100 Variablen), Medien, Schnellantwort- und Call-to-Action-Vorlagen. Sie können nicht für Kampagnen verwendet werden. Listenpicker, Katalog- und Karussellvorlagen werden nicht unterstützt. - Verwende nummerierte Variablen wie 1, 2, 3, in der richtigen Reihenfolge ohne Lücken. Die Anzahl der ausgefüllten Variablen muss mit der Vorlage übereinstimmen. - Den Freigabestatus einer Vorlage kannst du in der Twilio Console sehen, nicht im WhatsApp Manager. - Wenn die Synchronisierung fehlschlägt, prüfe, ob die Account SID und Auth Token (oder API Key SID und API Key Secret) des Posteingangs noch in Twilio gültig sind, und synchronisiere dann erneut. Gute Praxis - Utility-Vorlagen (z. B. Bestellaktualisierungen, Erinnerungen) sind für transaktionale Nachrichten gedacht. Marketing-Vorlagen benötigen das Opt-in des Kunden und müssen Metas Versandregeln befolgen. - Behalte einen kleinen Satz gut benannter Vorlagen, die dein Team zu verwenden weiß. - Meta beobachtet die Nachrichtenqualität. Zu viele blockierte oder ignorierte Nachrichten können dein Nachrichtenlimit verringern. Siehe Nachrichtenlimit in Verwalten deiner WhatsApp-Nummer. Wenn Vorlagen nicht synchronisieren (Schnellstart-Posteingänge) Manchmal funktionieren Nachrichten noch, aber Vorlagen werden nicht synchronisiert. Das passiert, wenn die Verbindung aus dem Schnellstart nicht mehr die Berechtigung hat, auf dein WhatsApp Business Konto zuzugreifen. Du kannst das beheben, indem du Chatwoot ein Business Management Token gibst, das nur zum Synchronisieren von Vorlagen verwendet wird. Plan & Zugriff: Chatwoot Cloud, nur Schnellstart-Posteingänge (einschließlich Koexistenz). Manuell eingerichtete Posteingänge verwenden ihr eigenes Token — stelle sicher, dass dieses stattdessen whatsapp_business_management enthält. Du musst in Chatwoot und im Meta-Unternehmensbereich Admin sein. 1. Gehe in den Meta Unternehmenseinstellungen zu Benutzer › Systembenutzer und wähle (oder erstelle) einen Systemadmin-Benutzer. Ein dedizierter Benutzer wie Chatwoot template sync lässt sich am einfachsten verwalten. 2. Klicke auf Zuweisen von Assets, wähle WhatsApp-Konten, wähle das mit Chatwoot verbundene WhatsApp Business Konto aus und gewähre vollständige Kontrolle. Weise nur dieses Konto zu. 3. Klicke auf Token generieren, wähle die mit diesem WhatsApp-Konto verbundene Meta-App aus und wähle ein Ablaufdatum (60 Tage ist sicherer; Niemals benötigt weniger Wartung). 4. Wähle nur whatsapp_business_management und kopiere das Token. Meta zeigt es möglicherweise nur einmal an. 5. Gehe in Chatwoot zu Einstellungen › Posteingänge, öffne den Posteingang, wechsle zum Reiter Konfiguration und suche Add Business Management Token. Füge das Token ein und klicke auf Hinzufügen. 6. Klicke auf Vorlagen synchronisieren. Behandle das Token wie ein Passwort. Wenn du es in Meta widerrufst, ersetze es in Chatwoot, sonst stoppt die Vorlage-Synchronisation. - 60-Tage-Token: Die Vorlagensynchronisierung stoppt beim Ablauf. Generiere ein neues Token und ersetze das alte. - Nie-abgelaufene Token: Es kann trotzdem ungültig werden, wenn sich Systembenutzer, App, Berechtigung oder Asset-Zuweisung ändern. - So ersetzt du ein Token: Nach dem Speichern eines Tokens steht im Feld Business Management Token ersetzen. Füge das neue Token ein und klicke 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 & Zugriff - Chatwoot Cloud: WhatsApp-Kampagnen sind im Business-Tarif und höher verfügbar. Sie sind automatisch aktiviert; Sie müssen sie nicht anfordern. - Self-hosted: Funktioniert bei allen Tarifen. - Kampagnen-Analysen: Business-Tarif und höher in der Cloud. Bei Self-hosted nur im Enterprise-Tarif. Der Super-Admin Ihrer Installation aktiviert Kampagnen-Analysen unter Super Admin › Konten › Konto öffnen › Bearbeiten, unter Premium-Funktionen, dann auf Änderungen speichern klicken. - Postfach: Nur WhatsApp Cloud API (Quick Setup oder manuell). Twilio- und 360dialog-Postfächer können keine Kampagnen versenden. - Wer: Administratoren. Siehe Preise & Tarife. So prüfen Sie, ob Sie es haben: Öffnen Sie Kampagnen in der Seitenleiste. Wenn WhatsApp darunter erscheint, sind Kampagnen für Ihr Konto verfügbar. Vor dem Start Mindestens eine genehmigte Vorlage in Ihrem WhatsApp Cloud API Postfach. Siehe Vorlagen und das 24-Stunden-Fenster. 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 Ihr WhatsApp-Postfach aus. Das Kontoinformationen-Panel zeigt die Nachrichtenstufe der Nummer, den Kontostatus und die Qualitätsbewertung von Meta. 3. Zielgruppe: Wählen Sie ein oder mehrere Labels aus. Kontakte mit mindestens einem der Labels sind enthalten. Klicken Sie auf Anzeigen, um exakt zu sehen, wer enthalten ist. Das Panel zeigt an, wie viele Kunden Ihr WhatsApp-Konto kontaktieren kann. 4. Vorlage: Wählen Sie eine genehmigte Vorlage aus und füllen Sie deren Header, Variablen und Buttons aus. Prüfen Sie die Nachrichten-Vorschau. 5. Klicken Sie auf Kampagne planen, wählen Sie eine Uhrzeit 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 noch nicht verfügbar (sein Tooltip lautet Live-Test wird bald verfügbar sein). Was Sie erwarten können - Die Kampagne wird einmal zum geplanten Zeitpunkt versendet. Ihr Status wechselt von Geplant zu Verarbeitung zu Abgeschlossen. - Sie können sie bearbeiten, solange sie geplant ist. Sobald sie mit dem Versand beginnt, kann sie nicht mehr geändert werden. - Kontakte ohne Telefonnummer werden übersprungen. - Es können nur genehmigte Vorlagen gesendet werden. Freitext-Broadcasts sind bei WhatsApp nicht möglich. - Wie viele Kunden Sie an einem Tag kontaktieren können, ist durch Metas Messaging-Limit festgelegt, das für alle Nummern im Business-Portfolio gilt. Siehe Verwalten Sie Ihre WhatsApp-Nummer. - Wenn Kunden antworten, wird eine neue Konversation im Postfach geöffnet und das 24-Stunden-Fenster beginnt. - An einen Kontakt gesendete Kampagnen-Nachrichten erscheinen in dessen WhatsApp-Konversation, markiert mit Kampagne. Ergebnisse anzeigen Analytics sind verfügbar im Business-Tarif und höher (Cloud) oder in einem kostenpflichtigen Self-hosted-Tarif. Klicken Sie auf Analytics anzeigen bei der Kampagne, um zu sehen: - Zielgruppe, An WhatsApp übermittelt, Zugestellt, Gelesen, Fehlgeschlagen und Übersprungen - Die Zustellungen-Tabelle: Status jedes Kontakts und bei Fehlschlägen und Übersprüngen der Grund. Filtern Sie nach Status. - Während eine Kampagne noch gesendet wird, sind die Zahlen unvollständig. Kampagnen, die vor Einführung der Kampagnen-Analytics gesendet wurden, haben keine Analysedaten. Analysen sind eventuell nicht verfügbar für Kampagnen, die vor der Einführung des Zustellungs-Trackings gesendet wurden. Gute Praxis - Erstellen Sie für jede Kampagne ein eigenes Label anstatt ein allgemeines wiederzuverwenden. - Verwenden Sie Utility-Vorlagen für Updates und Marketing-Vorlagen nur für Kontakte mit Einwilligung. - Beobachten Sie Ihre Qualitätsbewertung nach jeder Kampagne. Viele Sperrungen oder Meldungen können Ihr Messaging-Limit senken. Fehlerbehebung | Symptom | Wahrscheinliche Ursache | Was zu tun ist | | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Kein WhatsApp unter Kampagnen | Ihr Tarif enthält keine Kampagnen, oder Sie sind kein Administrator | Prüfen Sie in Chatwoot Cloud, ob Sie im Business-Tarif oder höher sind. Prüfen Sie, ob Sie als Administrator eingeloggt sind. Falls beides zutrifft und der Tab fehlt, wenden Sie sich an den Chatwoot-Support. | | Mein Postfach ist nicht in der Liste | Es handelt sich um ein Twilio- oder 360dialog-Postfach | Kampagnen benötigen ein WhatsApp Cloud API-Postfach. Siehe So verbinden Sie WhatsApp | | Dieses Postfach hat keine genehmigten Vorlagen, die in einer Kampagne verwendet 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 es nicht erhalten | Keine Telefonnummer, fehlendes Label oder Meta hat die Nachricht abgelehnt | Öffnen Sie Analytics anzeigen, filtern Sie nach Fehlgeschlagen oder Übersprungen, und lesen Sie den Grund. Für Fehlercodes siehe | | Ich kann die Kampagne nicht bearbeiten | Sie wurde bereits mit dem Versand begonnen | Erstellen Sie eine neue Kampagne Fehlerbehebung WhatsApp |
CSAT-Umfragen auf WhatsApp
Bitten Sie Ihre Kunden, Ihren Support zu bewerten, wenn ein Gespräch gelöst wurde – auch nachdem das 24-Stunden-Fenster abgelaufen ist. Chatwoot erstellt die WhatsApp-Vorlage für Sie, reicht sie bei Meta ein und sendet sie, sobald sie genehmigt ist. Plan & Zugang - Jeder Plan, der WhatsApp beinhaltet (Startups und höher sowie die kostenlose Testversion). Funktioniert mit WhatsApp Cloud API und Twilio-Postfächern. Siehe Preise & Pläne . - Administratoren richten es ein. Einrichtung 1. Gehen Sie zu Einstellungen › Postfächer, öffnen Sie Ihr WhatsApp-Postfach und wechseln Sie zum Tab CSAT. 2. Aktivieren Sie CSAT aktivieren. 3. Füllen Sie die Felder Nachricht, Button-Text und Sprache aus. In der Vorschau sehen Sie, wie es in WhatsApp aussehen wird. 4. Speichern Sie. Chatwoot erstellt die Vorlage und sendet sie zur Prüfung an Meta. 5. Warten Sie, bis der Status Von WhatsApp genehmigt anzeigt. Optional: Klicken Sie auf Nutzungszweck prüfen, um zu sehen, ob Meta Ihre Nachricht voraussichtlich als Utility einstuft, inklusive eines vorgeschlagenen Umformulierungsvorschlags. Dies dient als Orientierung und ist keine Garantie. Optional: Wählen Sie mit Label-Regeln aus, für welche Gespräche eine Umfrage gesendet wird. Testen Sie es: Lösen Sie ein Testgespräch mit Ihrer eigenen Nummer. Sie sollten die Umfrage mit einem Button erhalten, der die Bewertungsseite öffnet. Vorlagen-Status | Status | Bedeutung | | --------------------------- | ------------------------------------------------------------------------- | | Ausstehende WhatsApp-Freigabe | Meta prüft die Vorlage | | Von WhatsApp genehmigt | Umfragen werden automatisch versendet, wenn Gespräche gelöst werden | | Meta hat die Vorlage abgelehnt | Meta hat abgelehnt. Ändern Sie die Nachricht und speichern Sie, um sie erneut einzureichen. | Was Sie erwarten können - Eine Umfrage pro Gespräch. - Solange die Vorlage noch nicht genehmigt ist, wird die Umfrage nur als normale Nachricht verschickt, solange das 24-Stunden-Fenster offen ist. Wenn das Fenster geschlossen ist, wird keine Umfrage verschickt und das Gespräch zeigt CSAT-Umfrage nicht gesendet wegen Einschränkungen für ausgehende Nachrichten an. - Meta erlaubt es nicht, genehmigte Vorlagen zu bearbeiten. Wenn Sie die Nachricht, den Button-Text oder die Sprache ändern, fordert Chatwoot Sie zur Bestätigung auf, löscht die aktuelle Vorlage und reicht eine neue zur Genehmigung ein. Bis Meta sie genehmigt, gilt die oben stehende Regel. Wenn das Speichern fehlschlägt, speichern Sie erneut, da die vorherige Vorlage bereits gelöscht sein kann. Gute Praxis - Halten Sie die Nachricht kurz und freundlich, mit deutlichem Button-Text wie „Jetzt bewerten“. - Verwenden Sie Label-Regeln, damit nur sinnvolle Gespräche eine Umfrage erhalten. - Ändern Sie die Vorlage selten. Jede Änderung pausiert Umfragen, bis Meta die neue Vorlage genehmigt hat.
WhatsApp-Anrufe
Kunden können Ihr Unternehmen über WhatsApp anrufen, und Agenten nehmen die Anrufe im Browser entgegen. Agenten können auch Kunden anrufen, die zugestimmt haben, Anrufe zu erhalten. Plan & Zugriff - Chatwoot Cloud: Business-Tarif und höher. Self-hosted: Ein kostenpflichtiger Tarif mit Enterprise Edition, ab v4.15.0. Das alleinige Installieren der Enterprise Edition aktiviert die Funktion nicht. Siehe Preise & Tarife. - Posteingang: Nur WhatsApp Cloud API. Beide Verbindungsmethoden funktionieren, Schnelleinrichtung und manuelle Einrichtung. Nicht verfügbar für Twilio- oder 360dialog-WhatsApp-Posteingänge. - Ihre Nummer muss für die WhatsApp Business Calling API von Meta registriert sein. - Administratoren aktivieren die Funktion. Agenten im Posteingang nehmen und tätigen Anrufe. So prüfen Sie, ob Sie es haben: Öffnen Sie die Einstellungen des Posteingangs. Ein Anrufe-Tab bedeutet, dass Anrufe für Ihr Konto verfügbar sind. Anrufe aktivieren Neuer Posteingang: Gehen Sie zu Einstellungen › Posteingänge › Posteingang hinzufügen › WhatsApp-Anruf und führen Sie die Schnelleinrichtung durch. Chatwoot schaltet die Anruffunktion während der Einrichtung frei. Bestehender Posteingang: 1. Gehen Sie zu Einstellungen › Posteingänge, öffnen Sie Ihren WhatsApp-Posteingang und wechseln Sie zum Tab Anrufe. 2. Aktivieren Sie WhatsApp-Anrufe aktivieren. 3. Optional: Bearbeiten Sie die Anruffreigabe-Anfrage, die Kunden sehen, wenn Sie um eine Anruf-Erlaubnis bitten. 4. Optional: Stellen Sie die weiteren Umschalter im Tab Anrufe ein: - Eingehende Anrufe erlauben: Ist dies deaktiviert, werden eingehende Anrufe automatisch abgelehnt, den Agenten wird nichts angezeigt und es wird keine Unterhaltung erstellt. Ausgehende Anrufe funktionieren weiterhin. - Anrufe aufzeichnen: Fügt jede Anrufaufnahme der Unterhaltung hinzu. - Aufnahmen transkribieren: Wird angezeigt, wenn die Aufzeichnung aktiviert ist. Fügt ein Transkript mit Captain hinzu und benötigt aktivierte Audio-Transkription für Ihr Konto. Wenn Sie Sprachanruf konnte für diese Nummer nicht aktiviert werden sehen, ist Ihre Nummer derzeit nicht für die Meta Calling API registriert. Bitten Sie Meta oder Ihren WhatsApp Business Solution Provider um die Registrierung und versuchen Sie es erneut. Vor dem ersten Anruf: Jeder Agent muss Mikrofonzugriff für Chatwoot im Browser erlauben. Testen Sie es: Öffnen Sie auf einem anderen Telefon WhatsApp, suchen Sie Ihr Unternehmen und tippen Sie auf anrufen. In Chatwoot sollte eine Anrufbenachrichtigung erscheinen. Anrufe entgegennehmen und tätigen - Eingehend: Ein Anruffenster zeigt den Namen des Anrufers, die Nummer und den Posteingang. Agenten können den Anruf annehmen oder ablehnen. - Ausgehend: Klicken Sie im Gespräch auf WhatsApp-Anruf starten. Wenn der Kunde noch nicht zugestimmt hat, erhält er zunächst eine Anruffreigabe-Anfrage: Eine Anruffreigabe-Anfrage wurde an den Kontakt gesendet. Versuchen Sie es erneut, sobald sie akzeptiert wurde. Nach der Zustimmung können Sie erneut anrufen. - Anrufstatus im Gespräch: Eingehender Anruf, Ausgehender Anruf, Anruf läuft, Anruf beendet, Verpasster Anruf, Keine Antwort. - Aufzeichnungen werden, sofern verfügbar, dem Gespräch hinzugefügt. Transkripte erscheinen, wenn Ihr Konto über die Captain Audio-Transkription verfügt. Wer den Anruf erhält - Zugewiesene Unterhaltung: Nur das Anruffenster des zuständigen Agenten klingelt, unabhängig vom Verfügbarkeitsstatus. - Nicht zugewiesene Unterhaltung: Posteingangs-Agenten, die auf Online gesetzt sind, klingeln. - Niemand online: Alle Posteingangs-Agenten und alle Administratoren klingeln. Der erste Agent, der beitritt, nimmt den Anruf entgegen. Wenn die Unterhaltung keinem Agenten zugewiesen ist, wird sie dem beitretenden Agenten zugewiesen. Wenn ein Agent einen Anruf startet, wird das Gespräch ebenfalls ihm zugewiesen, sollte es noch keinem Agenten zugewiesen sein. Gute Praxis - Bitten Sie frühzeitig im Gespräch um die Anruffreigabe, nicht erst im Moment, wenn Sie anrufen möchten. - Stellen Sie sicher, dass Agenten, die Anrufe entgegennehmen, auf Online gesetzt sind, damit keine Anrufe verpasst werden. Fehlerbehebung | Symptom | Wahrscheinliche Ursache | Was ist zu 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 in Preise & Tarife und Ihre Verbindungsmethode in WhatsApp in Chatwoot | | Sprachanruf konnte nicht aktiviert werden | Die Nummer ist nicht für Meta Calling API registriert | Bitten Sie Meta oder Ihren Anbieter um Registrierung und versuchen Sie es erneut | | Agent kann nicht hören oder gehört werden | Im Browser ist keine Mikrofon-Erlaubnis erteilt | Mikrofonzugriff für Chatwoot in den Browsereinstellungen erlauben | | Anruffreigabe-Anfrage bereits kürzlich gesendet | Der Kunde hat auf die vorherige Anfrage noch nicht reagiert | Warten Sie, bis der Kunde annimmt, bevor Sie es erneut versuchen |
Verwalten Sie Ihre WhatsApp-Nummer
Sehen Sie die Gesundheit Ihrer Nummer, das Nachrichtenlimit und Ihr Unternehmensprofil, ohne Chatwoot zu verlassen. Plan & Zugang - Jeder Plan mit WhatsApp (Startups und höher sowie die kostenlose Testphase), für WhatsApp Cloud API-Postfächer (Schnelleinrichtung oder manuell). Twilio-Postfächer haben diesen Tab nicht. Siehe Preise & Pläne - Administratoren. Kontogesundheit öffnen Gehen Sie zu Einstellungen › Postfächer, öffnen Sie Ihr WhatsApp-Postfach und wählen Sie den Tab Kontogesundheit. Klicken Sie auf Zum Meta Business Manager, 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. Hier sind sie nur lesbar: Änderungen vornehmen in den WhatsApp-Verwaltungstools von Meta. | | Telefonnummer | Anzeigenummer, WhatsApp-Anzeigename und dessen Überprüfungsstatus, Telefonnummernstatus, ob Koexistenz aktiviert ist, sowie die Telefonnummern-ID | | Gesundheit & Kapazität | Qualitätsbewertung (Grün, Gelb, Rot), Business-Nachrichtenlimit, Kontomodus (Sandbox oder Live) und Durchsatz | | Unternehmenskonto | Name und ID des WhatsApp Business Accounts, sowie das dazugehörige Unternehmensportfolio | | Webhook-Konfiguration | Ob die Callback-URL von Meta für diese Nummer auf dieses Chatwoot-Postfach zeigt. Webhook erfolgreich konfiguriert bestätigt nur die Einstellung, nicht den Nachrichtenempfang. Wenn 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 von Chatwoot aus. | Nachrichtenlimit Das Business-Nachrichtenlimit wird von Meta festgelegt: wie viele einzigartige Kunden Sie außerhalb des 24-Stunden-Fensters (mit Vorlagen) innerhalb von 24 Stunden kontaktieren dürfen. Es ist für alle Nummern in Ihrem Unternehmensportfolio gemeinsam. Meta erhöht das Limit, wenn Sie hochwertige Nachrichten senden, und kann es senken, wenn die Qualität sinkt. Anzeigename Ihr Anzeigename ist der Unternehmensname, den Kunden sehen. Meta prüft diesen. | Status in Chatwoot | Bedeutung | | -------------------------- | ------------------------------------------------------------------------------------------------------------------- | | Genehmigt | Wird oben in Chats angezeigt (es kann stattdessen ein vom Kunden gespeicherter Name erscheinen) | | Noch nicht geprüft | Gespeichert, aber Kunden sehen möglicherweise Ihre Nummer, bis Meta ihn prüft. Die Prüfung startet bei höherem Nachrichtenlimit. | | In Überprüfung | Meta prüft den Namen. Ändern Sie ihn nicht erneut, bis die Überprüfung beendet ist. | | Nicht genehmigt | Meta hat ihn abgelehnt. Ändern Sie ihn im Meta Business Manager und reichen Sie ihn erneut ein. | Damit der Name beim ersten Mal genehmigt wird: Verwenden Sie Ihren echten Unternehmens- oder Markennamen, entsprechend Ihrer Website und dem Meta Business Manager. Vermeiden Sie generische Wörter („Support“, „Offiziell“), Emojis, Symbole, Slogans und übermäßig viele Großbuchstaben. Nach einer Änderung des Anzeigenamens kann es erforderlich sein, dass die Nummer erneut registriert werden muss, bevor Nachrichten wie gewohnt fließen. Siehe Nachrichten kommen nicht mehr an in vTroubleshoot WhatsApp. Wenn die Verbindung Aufmerksamkeit benötigt - WhatsApp-Verbindung muss aktualisiert werden (Schnelleinrichtungs-Postfächer): Klicken Sie im Postfach auf WhatsApp erneut verbinden oder gehen Sie zu Konfiguration und klicken Sie auf Neu konfigurieren. Sie benötigen Admin-Zugriff auf das WhatsApp Business-Konto. - WhatsApp-Zugangstoken benötigt Aufmerksamkeit (manuelle Postfächer): Gehen Sie zu Konfiguration und ersetzen Sie das Zugangstoken durch ein gültiges permanentes Token.
Fehlerbehebung bei WhatsApp
Bevor Sie irgendetwas ändern: Löschen Sie Ihr WhatsApp-Konto nicht, entfernen Sie Ihr WhatsApp Business-Konto nicht und trennen Sie keinen Anbieter als generelle Maßnahme. 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 erschien. Verbinden Wissen Sie zuerst, wie Ihre Nummer heute verwendet wird: eine neue Nummer, eine Nummer in der WhatsApp Business-App (verwenden Sie Koexistenz, um die App zu behalten), oder eine Nummer bei einem anderen API-Anbieter (diese nutzen unterschiedliche Wege). Siehe Wählen Sie, wie Sie WhatsApp verbinden. | Was Sie sehen | Meta-Code | Was es bedeutet und was zu tun ist | | -------------------------------------------------------------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nummer nicht berechtigt, benötigt mehr Aktivität in der WhatsApp Business-App | 3441045 | Eine Koexistenz-Berechtigungsprüfung. Nutzen Sie die App weiterhin wie gewohnt mit echten Kunden und versuchen Sie es später erneut. Meta veröffentlicht kein Minimum. Erzeugen Sie keine künstliche Aktivität und legen Sie das Konto nicht neu an. | | Nummer nicht mit der WhatsApp Business-App registriert | 2655095, 2655048 | Überprüfen Sie die Nummer und die Ländervorwahl, und dass sie in der Business App ist (nicht im privaten WhatsApp). Für eine ausschließlich API-basierte neue Nummer nutzen Sie den neuen Nummernweg. | | 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 mit einem Partner verbunden ist. Das bestätigt nicht, dass der andere Anbieter noch aktiv ist. Ein Wechsel von Partnern ist in diesem Ablauf nicht möglich. Kontaktieren Sie den Support, bevor Sie etwas trennen. | | Bereits mit dem Produkt registriert oder Geschäftsplattform trennen | 3441049, 2655094 | Eine bestehende Plattformverbindung muss zuerst behandelt werden. Wenn Sie absichtlich trennen, verlangt Meta 15 Minuten Wartezeit bis zum erneuten Versuch. | | Nummer nicht mit dem gewählten Unternehmen verbunden | 3441041 | Wählen Sie das Unternehmensportfolio aus, dem diese Nummer gehört. | | 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 Seitenadministrator) oder verwenden Sie eine andere Nummer. | | Konto verwendet Marketingnachrichten | 3441047 | Wählen Sie ein anderes WhatsApp Business-Konto. Ein erneuter Versuch 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 ggf. Widerspruch ein. Erstellen Sie keine neuen Konten, um die Einschränkung zu umgehen. | | Verifizierung bei einem anderen Partner gestartet | 2494143 | Fahren Sie mit diesem Partner fort, oder beantragen Sie die Meta Business-Verifizierung direkt. | | Funktion in Ihrer Region nicht verfügbar | 3441042 | Prüfen Sie die Ländervorwahl. Ist sie korrekt, ist dieser Ablauf für diese Nummer noch nicht verfügbar. | | Code konnte nicht gesendet oder überprüft werden | 2388091, 2388093 | Überprüfen Sie die Nummer und nutzen Sie eine empfangsfähige Methode (Festnetz benötigt Sprachoption). IVR-Nummern werden nicht unterstützt. | Weitere Verbindungsprobleme - Konto oder Portfolio fehlt: Melden Sie sich mit dem Facebook-Konto an, das Administrator des richtigen Portfolios ist. „Benutzer hat keine Berechtigung“ bedeutet, ein bestehender Administrator muss Zugriff gewähren. - Facebook-Konto zu neu: Warten Sie einige Stunden oder nutzen Sie ein etabliertes Konto mit Geschäftszugang. - Unternehmensverifizierung läuft: Prüfen Sie Meta Business Suite › Security Center. - Anzeigename abgelehnt: Siehe Anzeigename unter Verwalten Sie Ihre WhatsApp-Nummer. - Telefonnummern-Limit erreicht: Wählen Sie die vorhandene Nummer, wenn sie bereits aufgelistet ist, oder bitten Sie Meta um ein höheres Limit. Löschen Sie keine funktionierende Nummer. - „Zu oft geraten“: Warten Sie etwa 12 Stunden. „Code zu oft angefordert“: Befolgen Sie die von Meta angezeigte Wartezeit. - Koexistenz-Aufforderung oder QR-Code funktioniert nicht: Verwenden Sie die neueste Business-App, halten Sie das Telefon online, lassen Sie das Anmelde-Fenster offen und überprüfen Sie die Kamerazugriffserlaubnis für QR-Codes. - Meta-Fenster öffnet sich nicht oder stoppt: Pop-ups erlauben, blockierende Erweiterungen deaktivieren, Meta-Sicherheitsprüfung abschließen und nach einem kurzfristigen Fehler einige Minuten warten. - Meta abgeschlossen, 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. - Koexistenz-Chatverlauf unvollständig: Halten Sie die App online geöffnet. Meta synchronisiert den Verlauf nur innerhalb von 24 Stunden nach der Verbindung. Kontaktieren Sie umgehend den Support statt sich erneut zu verbinden. Nachrichten empfangen und senden | Symptom | Wahrscheinliche Ursache | Was zu tun ist | | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nachrichten kommen nicht mehr an, aber die Nummer zeigt Verbunden und Qualität ist Grün | Etwas in der Verbindung benötigt Aufmerksamkeit: Registrierung, Berechtigungen oder der Webhook. Das folgt häufig auf Änderungen am Anzeigenamen oder Profil. Nach jeder Behebung eine Testnachricht an Ihre Nummer senden und von Chatwoot aus antworten, um beide Richtungen zu bestätigen. | Kontaktieren Sie zuerst den Support, damit wir die Registrierung, Berechtigungen und den Webhook Ihres bestehenden Posteingangs prüfen können. Falls die Nummer erneut registriert werden muss, machen Sie das selbst bei Meta nach Metas Registrierungsvorgang. Löschen Sie die Nummer nicht und erstellen Sie keinen neuen Posteingang. Koexistenz-Nummern benötigen einen anderen Wiederherstellungspfad, daher vor Änderungen Support kontaktieren. | | Nach Einrichtung kommen keine Nachrichten an | Eine mögliche Ursache: Der Webhook ist nicht registriert oder verweist woanders hin | Öffnen Sie Account Health. Wenn Webhook-Konfiguration als Webhook nicht konfiguriert oder Webhook-URL stimmt nicht überein angezeigt wird, klicken Sie auf Webhook registrieren. Dann testen: Senden Sie eine Nachricht an Ihre Nummer von einem anderen Telefon, prüfen Sie die Ankunft in Chatwoot und antworten Sie von Chatwoot aus. Wenn der Webhook als konfiguriert angezeigt wird, aber trotzdem keine Nachrichten ankommen, kontaktieren Sie den Support. Für Twilio: Callback-URL in Twilio prüfen (Seite 5). | | Sie können nur mit einer Vorlagennachricht antworten | Mehr als 24 Stunden seit der letzten Nachricht des Kunden | Senden Sie eine Vorlage. Siehe Vorlagen und das 24-Stunden-Fenster | | Eine Nachricht schlägt fehl mit Fehler 131049 | Meta hat diese Marketingvorlage zur Wahrung der Engagement-Qualität nicht zugestellt. WhatsApp limitiert, wie viele Marketingnachrichten eine Person von allen Unternehmen erhält. | Nicht sofort erneut senden oder auf Erneut versuchen klicken. Mindestens 24 Stunden warten, bevor Sie dieser Person eine weitere Marketingvorlage senden. Utility-Vorlagen sind nicht betroffen. Antwortet der Kunde, zählen Marketingnachrichten innerhalb des 24-Stunden-Fensters nicht zum Limit. | | WhatsApp-Verbindung muss aktualisiert werden / WhatsApp neu verbinden | Die Quick-Setup-Verbindung ist abgelaufen | Klicken Sie auf WhatsApp neu verbinden. Siehe Verwalten Sie Ihre WhatsApp-Nummer | | WhatsApp-Zugriffstoken benötigt Aufmerksamkeit | Das manuell eingerichtete Token ist abgelaufen oder wurde widerrufen | Ersetzen Sie es im Reiter Konfiguration des Posteingangs | Vorlagen | Symptom | Wahrscheinliche Ursache | Was zu tun ist | | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | Eine Vorlage fehlt in Chatwoot | Noch nicht genehmigt, nicht synchronisiert oder ein von Chatwoot nicht unterstützter Typ | Status im WhatsApp Manager prüfen und Vorlagen synchronisieren klicken. Unterstützte Typen auf Seite 7 prüfen. | | Nachrichten funktionieren, aber Vorlagen werden nie synchronisiert (Quick-Setup) | Die Verbindung hat die Berechtigung verloren, auf Ihr WhatsApp Business-Konto zuzugreifen | Fügen Sie ein Business Management Token hinzu (Seite 7) | | Business Management Token: Business management token must grant the whatsapp_business_management permission | whatsapp_business_management wurde nicht ausgewählt | Neues Token mit dieser Berechtigung generieren | | Business Management Token: keine Berechtigung oder Token ungültig | Der Systembenutzer hat das WhatsApp-Konto nicht, das Token ist abgelaufen oder gehört zu einer anderen App | Zugewiesene Assets und App des Systembenutzers prüfen, dann neues Token generieren | | Token akzeptiert, Vorlagen fehlen trotzdem | Das Token kann auf ein anderes WhatsApp Business-Konto zugreifen | Prüfen Sie, ob der Systembenutzer genau das Konto des Posteingangs hat und dort die Vorlagen existieren | | Vorlage schlägt beim Senden fehl oder Medien werden nicht angezeigt | Leere Variablen, privater oder kaputter Medienlink, oder Datei überschreitet Metas Limits | Alle Variablen füllen, öffentlichen Link verwenden, Format und Größe prüfen (Seite 7) | | Dynamischer URL-Button funktioniert nicht | Bekanntes Problem bei bestimmten dynamischen URL-Buttons | Statische URL in der Vorlage verwenden | Kontakte und Telefonnummern Nummern sehen in WhatsApp und Chatwoot unterschiedlich aus (Brasilien, Mexiko, Argentinien). Diese Länder haben ihr Mobilnummernformat geändert, und WhatsApp kann immer noch das alte verwenden: - Brasilien: Eine 9 wurde nach der Vorwahl hinzugefügt (+55 11 9 8765-4321 vs +55 11 8765-4321). - Argentinien: Eine 9 nach der Ländervorwahl kann vorhanden sein oder nicht (+54 9 11 ... vs +54 11 ...). - Mexiko: WhatsApp kann eine 1 nach der Ländervorwahl hinzufügen (+52 1 ... vs +52 ...). Chatwoot gleicht beide Formate automatisch demselben Kontakt zu, sodass Sie keine Duplikate bekommen sollten. Die Nummer kann an den beiden Orten einfach unterschiedlich dargestellt werden. Support kontaktieren Wenn Sie weiterhin nicht weiterkommen, kontaktieren Sie den Chatwoot-Support mit: - Der vollständigen Fehlermeldung und dem Fehlercode sowie einem Screenshot - Dem Schritt, der fehlgeschlagen ist, und ob der Fehler in Meta oder in Chatwoot auftrat - Ihrem Posteingangslink, der geschäftlichen Telefonnummer mit Ländervorwahl sowie Zeitpunkt und Zeitzone des Versuchs - Wie die Nummer verwendet wird: neu, WhatsApp Business-App oder anderer Anbieter - Für Koexistenz: App-Version, wie lange sie bereits genutzt wird und ob sie auf dem Telefon noch funktioniert - Ihrer Unternehmensportfolio-ID, WhatsApp Business Account ID und Phone Number ID, beschriftet Teilen Sie niemals Ihr Passwort, Zugriffstoken, Ihren Bestätigungscode oder Ihren Zwei-Faktor-PIN. Verbergen Sie diese in Screenshots. Chatwoot kann Metas Entscheidungen zu Einschränkungen oder Überprüfungen nicht außer Kraft setzen.