Weitere Kanäle
Von Sojan
Von Sojan
Verbinden und verwalten Sie E-Mail, WhatsApp, Facebook, Instagram, Telegram und weitere Kanäle.
Wie richtet man einen Instagram-Kanal ein?
Wenn Sie eine selbst gehostete Chatwoot-Installation verwenden, richten Sie Ihre Instagram-App bitte wie in dieser Anleitung beschrieben ein. Für die Cloud-Version von Chatwoot folgen Sie bitte dieser Anleitung. Voraussetzungen Bevor Sie Ihr Instagram-Postfach zu Chatwoot hinzufügen, müssen Sie sicherstellen, dass Sie ein Instagram-Unternehmenskonto besitzen. Richten Sie ein Instagram-Unternehmenskonto ein, falls Sie noch keines haben. Diese Anleitung von Instagram hilft Ihnen dabei. Wie erstellt man ein Instagram-Postfach in Chatwoot? Schritt 1. Gehen Sie zu Einstellungen → Postfächer → "Postfach hinzufügen". Schritt 2. Klicken Sie auf die Schaltfläche "Mit Instagram fortfahren". Schritt 3. Aktivieren Sie "Nachrichten zugreifen und verwalten" und klicken Sie auf die Erlauben-Schaltfläche, um die Autorisierung fortzusetzen. Schritt 5. "Mitarbeiter hinzufügen" zu Ihrem Instagram-Postfach. Sie haben erfolgreich ein Instagram-Postfach erstellt. Immer wenn ein Kunde eine Nachricht an Ihr Instagram-Konto sendet, können Sie diese in Chatwoot sehen und darauf antworten.
Wie richtet man einen Line-Kanal ein?
Schritt 1. Gehe zu Einstellungen → Posteingänge → „Posteingang hinzufügen“. Schritt 2. Klicke auf das "Line"-Symbol. Schritt 3. Gehe zur Line Developer Console und erstelle ein Line-Konto. Schritt 4. Erstelle einen "Provider" in der Developer Console. Erstelle unter dem Provider einen neuen "Messaging API"-Kanal (Bot). Schritt 5. Fülle die folgenden Felder aus der Line Developer Console (Messaging API Channel) aus und klicke auf „LINE-Kanal erstellen“. 1. Kanalname 2. LINE Channel ID 3. LINE Channel Secret 4. LINE Channel Token Schritt 6. „Agenten hinzufügen“ zu deinem Line-Posteingang. Die Einrichtung des Posteingangs ist abgeschlossen. Schritt 7. Gehe in der Developer Console zum "Messaging API"-Kanal und konfiguriere das Webhook. 1. Chatwoot Webhook-URL überprüfen 2. „Webhook verwenden“ aktivieren Schritt 8. Teste deinen neuen Line-Posteingang. Sende eine Nachricht an den Line Bot. Prüfe den Chatwoot Line-Posteingang auf die neue Nachricht.
Wie richtet man einen SMS-Kanal ein?
Du kannst dein SMS-Kanal-Postfach über zwei Anbieter einrichten: 1. Twilio 2. Bandwidth Erstellen eines SMS-Postfachs Folge den untenstehenden Schritten. Schritt 1. Öffne dein Chatwoot-Dashboard. Gehe zu Einstellungen → Postfächer → Postfach hinzufügen. Schritt 2. Klicke auf das "SMS"-Symbol. Schritt 3. Wähle deinen API-Anbieter aus und konfiguriere das Postfach. Nachfolgend werden beide Optionen erklärt. "Twilio" als API-Anbieter wählen Wenn du Twilio für dein SMS-Postfach verwenden möchtest, wähle es aus dem Dropdown-Menü. Es werden die erforderlichen Felder angezeigt, wie unten beschrieben. Dies sind die erforderlichen Eingaben, um diesen Kanal zu erstellen: Klicke auf Twilio-Kanal erstellen nachdem du die Informationen eingetragen hast. Chatwoot mit Twilio Studio konfigurieren Wenn du Twilio Studio für einen benutzerdefinierten Gesprächsfluss verwendest, führt das direkte Aktualisieren der Webhook-URL dazu, dass deine bestehende Integration nicht mehr funktioniert. In solchen Fällen kannst du zum Abschnitt "Twilio Studio" in diesem Dokument navigieren. "Bandwidth" als API-Anbieter wählen Wenn du Bandwidth für dein SMS-Postfach verwenden möchtest, wähle es aus dem Dropdown-Menü. Es werden die erforderlichen Felder wie unten gezeigt angezeigt. Klicke auf Bandwidth-Kanal erstellen nachdem du die Informationen eingetragen hast. Sobald dieser Schritt abgeschlossen ist, kannst du Agenten hinzufügen. Schritt 4. "Agenten hinzufügen" zu deinem Postfach. Du hast erfolgreich ein SMS-Postfach erstellt. Du wirst die Nachrichten in deinem Chatwoot-Dashboard erhalten. Siehe auch: Eine SMS-Kampagne an eine Kontaktgruppe senden.
Wie richtet man einen Instagram-Kanal (über Facebook-Login) ein?
Wir empfehlen Instagram Business Login als bevorzugte Authentifizierungsmethode, da sie eine einfachere Konfiguration und ein besseres Entwicklererlebnis bietet. Bitte beziehe dich für weitere Details auf diese Anleitung. Die Unterstützung für Instagram über Facebook Login wird ab Version 4.1 eingestellt. Wenn du eine selbstgehostete Chatwoot-Installation verwendest, richte deine Instagram-App wie in dieser Anleitung beschrieben ein. Für die Cloud-Version von Chatwoot folge bitte dieser Anleitung. Voraussetzungen Bevor du dein Instagram-Postfach zu Chatwoot bringst, musst du sicherstellen, dass du ein Business-Instagram-Konto hast. Schritt 1. Richte ein Business-Instagram-Konto ein, falls du noch keines hast. Diese Anleitung von Instagram hilft dir dabei. Schritt 2. Stelle sicher, dass deine Facebook-Seite mit diesem Instagram-Konto verbunden ist. Um Facebook und Instagram zu verbinden, folge diesen Schritten: 1. Gehe zu https://www.facebook.com/pages/?category=your_pages. 2. Wähle deine Seite aus. 3. Gehe zu den Einstellungen. 4. Wähle „Instagram“ aus und verbinde dein Unternehmenskonto wie unten gezeigt: Wechsle jetzt zurück zur Chatwoot-App. Wie erstelle ich ein Instagram-Postfach in Chatwoot? Schritt 1. Gehe zu Einstellungen → Postfächer → „Postfach hinzufügen“. Schritt 2. Klicke auf das "Messenger"-Symbol. Schritt 3. Klicke auf den Facebook-Login-Button. Es öffnet sich ein neues Fenster, in dem du dich anmelden kannst. Schritt 4. Authentifiziere dich mit Facebook, wähle ein Instagram-Konto aus und wähle die Seite, die du verbinden möchtest. Aktiviere alle Berechtigungen, die in der Liste angezeigt werden. Dadurch kann Chatwoot alle gewünschten Aktionen reibungslos ausführen. Schritt 5. „Agenten hinzufügen“ zu deinem Instagram-Postfach. Du hast erfolgreich ein Instagram-Postfach erstellt. Wann immer ein Kunde eine Nachricht an dein Instagram-Konto sendet, kannst du diese in Chatwoot sehen und darauf antworten.
Wie richtet man einen Telegram-Kanal ein?
Schritt 1. Gehe zu Einstellungen → Posteingänge → „Posteingang hinzufügen“. Schritt 2. Klicke auf das "Telegram"-Symbol. Schritt 3. Erstelle einen neuen Telegram-Bot mit dem Telegram BotFather. Schritt 4. Gib das API-Token des Telegram-Bots ein und klicke auf „Telegram-Kanal erstellen“. Schritt 5. „Füge Agent:innen“ zu deinem Telegram-Posteingang hinzu. Die Einrichtung des Posteingangs ist abgeschlossen. Schritt 6. Gehe auf die Einstellungen-Seite des Posteingangs und überprüfe, ob der Posteingangsname mit dem über BotFather erstellten Bot-Benutzernamen übereinstimmt. Schritt 7. Sende eine Nachricht an den Telegram-Bot. Überprüfe den Chatwoot-Telegram-Posteingang auf die neue Nachricht. FAQ Unterstützt Chatwoot Telegram-Business-Bot-Konten? Ja — Unterstützung für Telegram-Business-Mode-Bots wurde in Chatwoot v4.3.0 (18. Juni 2025) hinzugefügt. Wie aktiviere ich Business Bots? 1. Führe in @BotFather den Befehl /business_mode aus, wähle deinen Bot aus und bestätige. 2. Erstelle einen neuen Telegram-Posteingang in Chatwoot (Einstellungen → Posteingänge → Posteingang hinzufügen → Telegram) und füge das gleiche Bot-Token ein. 3. Chatwoot erkennt den Business Modus automatisch und registriert den korrekten Webhook. 4. Für beste Ergebnisse solltest du diesen Business-Bot in einem eigenen Posteingang führen, getrennt von eventuellen Standard-Bots, die du schon verwendest.  Bekannte Probleme mit Business Bots • 24-Stunden-Antwortfenster – Telegram erlaubt dem Bot (und Chatwoot), nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden zu antworten.  • Wenn ein:e Nutzer:in zuvor mit demselben Bot außerhalb des Business-Modus gechattet hat, können Antworten vom Bot und nicht vom Business-Account stammen; Ein dedizierter Business-Bot und Posteingang vermeiden diese Verwirrung. • Die Telegram Business API bietet derzeit weniger Funktionen als die reguläre Bot API (z.B. keine "Tippen"-Anzeige, eingeschränkte Nachrichtentypen). Die Erwartungen sollten entsprechend angepasst werden.
Wie richtet man einen TikTok-Kanal ein?
Wenn Sie eine selbstgehostete Chatwoot-Installation verwenden, richten Sie Ihre TikTok-App bitte wie in dieser Anleitung beschrieben ein. Für die Cloud-Version von Chatwoot folgen Sie bitte dieser Anleitung. Voraussetzungen Bevor Sie den TikTok-Kanal einrichten, stellen Sie Folgendes sicher: 1. Sie haben ein TikTok Business-Konto, das in einer berechtigten Region registriert ist. 2. Ihr TikTok Business-Konto ist so eingestellt, dass es Direktnachrichten von allen akzeptiert. Andernfalls müssen Sie Nachrichten manuell in der TikTok-App annehmen. Erfahren Sie, wie Sie Ihre Nachrichteneinstellungen aktualisieren. Einrichtung des TikTok-Kanals Schritt 1: Navigieren Sie zu Postfächern Gehen Sie zu Einstellungen > Postfächer und klicken Sie auf Postfach hinzufügen. Wählen Sie TikTok aus der Liste der verfügbaren Kanäle. Schritt 2: Verbinden Sie Ihr TikTok-Konto Klicken Sie auf Mit TikTok fortfahren, um den Authentifizierungsprozess zu starten. Schritt 4: Chatwoot autorisieren Sie werden zu TikTok weitergeleitet. Prüfen Sie die angeforderten Berechtigungen und klicken Sie auf Weiter, um Chatwoot den Zugriff auf Ihr TikTok Business-Konto zu erlauben. Schritt 5: Agent:innen hinzufügen Nach der Autorisierung werden Sie zurück zu Chatwoot geleitet. Fügen Sie dem TikTok-Postfach Agent:innen hinzu, damit sie Nachrichten anzeigen und beantworten können. Ihr TikTok-Kanal ist jetzt verbunden. Eingehende TikTok-Direktnachrichten erscheinen nun in Ihrem Chatwoot-Dashboard. Einschränkungen beim Messaging - Kund:innen müssen das Gespräch initiieren, Unternehmen können nicht zuerst schreiben. - Agent:innen können bis zu 10 Nachrichten senden, bevor der/die Kund:in antwortet. Sobald der/die Kund:in antwortet, ist das Messaging unbeschränkt. - Das Antwortfenster beträgt 48 Stunden ab der letzten Nachricht des/der Kund:in. - Aufgrund von Einschränkungen der TikTok Business Messaging API werden derzeit nur Text, Bild und Beitrags-Teilen unterstützt. - Direkt aus der TikTok-App gesendete Nachrichten werden mit Chatwoot synchronisiert. - Nachrichten in nicht unterstützten Formaten (z. B. Audio, Sticker) erscheinen als "Diese Nachricht wird nicht unterstützt. Sie können diese Nachricht in der TikTok-App anzeigen." FAQ’s Warum kann ich einigen TikTok-Nutzer:innen keine Mediannachrichten senden? Das liegt an Einschränkungen seitens TikTok. In manchen Regionen ist das Senden oder Empfangen von Bildern nicht erlaubt, und in anderen Fällen kann das Konto des/der Nutzer:in von TikTok markiert sein. Welche Länder unterstützen TikTok Business Messaging? Die TikTok Business Messaging API ist derzeit nicht im EWR, der Schweiz oder dem Vereinigten Königreich verfügbar. Messaging-Funktionen können für Nutzer:innen in diesen Regionen eingeschränkt oder nicht verfügbar sein. Für die aktuell unterstützten Regionen und Einschränkungen konsultieren Sie bitte die offizielle Dokumentation von TikTok. Verfügbarkeit TikTok ist sowohl in Cloud- als auch selbstgehosteten Tarifen verfügbar.
Wie richtet man einen Twitter-Kanal ein?
HINWEIS: Die Twitter-Integration wurde vorübergehend eingestellt, da Twitter Änderungen an seinen APIs vorgenommen hat. Dazu gehören Einschränkungen bei der Anzahl der Anfragen pro Minute sowie erhebliche Preisänderungen. Mit einem Twitter-Posteingang kannst du sowohl Tweets verwalten, in denen du erwähnt wirst, als auch deine Twitter-Direktnachrichten über Chatwoot. Wenn du eine selbstgehostete Chatwoot-Installation verwendest, richte deinen Twitter-Posteingang wie in dieser Anleitung beschrieben ein. Für die Cloud-Version von Chatwoot folge bitte den untenstehenden Schritten. Schritt 1. Gehe zu Einstellungen → Posteingänge → „Posteingang hinzufügen“. Schritt 2. Klicke auf das "Twitter"-Symbol. Schritt 3. Klicke auf den "Mit Twitter anmelden"-Button. Schritt 4. Du wirst zu Twitter weitergeleitet. Klicke auf den Button "App autorisieren". Schritt 5. „Agenten hinzufügen“ zu deinem Twitter-Posteingang. Du hast erfolgreich einen Twitter-Posteingang erstellt. Du kannst nun Twitter-Direktnachrichten sowie Tweets, in denen du erwähnt wirst, über Chatwoot verwalten. Zusätzliche Posteingangseinstellungen Dein frisch eingerichteter Twitter-Posteingang sollte jetzt in deiner Liste der Posteingänge erscheinen. Um dies zu sehen und weitere Einstellungen vorzunehmen, gehe zu Einstellungen → Posteingänge → klicke auf das Zahnrad beim zugehörigen Twitter-Posteingang. Du siehst dann folgenden Bildschirm: Hier kannst du grundlegende Änderungen vornehmen. Tab „Einstellungen“ Begrüßungskanal aktivieren. Sobald diese Option aktiviert ist, sendet Chatwoot eine Begrüßungsnachricht an neue Unterhaltungen, die über deinen Twitter-Posteingang erstellt werden. CSAT aktivieren. Mit dieser Option wird nach jeder gelösten Anfrage eine Kundenzufriedenheitsumfrage gestartet. Die Ergebnisse der CSAT-Umfrage können später im Statistik-Bereich eingesehen werden. Tab „Mitarbeiter“ Klicke auf den Mitarbeiter-Tab. Hier kannst du Agenten zum Posteingang hinzufügen oder bereits hinzugefügte Agenten entfernen. Du kannst auch die automatische Zuweisung neuer Unterhaltungen an die zu diesem Posteingang hinzugefügten Agenten aktivieren oder deaktivieren. Klicke auf Aktualisieren, um die Änderungen zu speichern. Tab „Geschäftszeiten“ Klicke auf den Tab Geschäftszeiten. In diesem Abschnitt kannst du die Arbeitszeiten deines mit dem Twitter-Posteingang verbundenen Teams festlegen. Klicke auf das Kontrollkästchen für Geschäftsverfügbarkeit für diesen Posteingang aktivieren, wenn du feste Geschäftszeiten hast. Sobald das Kontrollkästchen aktiviert ist, öffnet sich der untenstehende Bereich. Hier kannst du deine Nachricht schreiben, die dem Kunden außerhalb der Geschäftszeiten angezeigt wird. Du kannst außerdem die verfügbaren Geschäftszeiten für jeden Wochentag und die entsprechende Zeitzone auswählen. Klicke auf den Button „Geschäftszeiten aktualisieren“.
Wie richtet man einen Facebook-Kanal ein?
Wenn Sie eine selbstgehostete Chatwoot-Installation verwenden, richten Sie bitte Ihre Facebook-App wie in dieser Anleitung beschrieben ein. Für die Cloud-Version von Chatwoot befolgen Sie bitte die folgenden Schritte. Schritt 1. Gehen Sie zu Einstellungen → Postfächer → „Postfach hinzufügen“. Schritt 2. Klicken Sie auf das "Messenger"-Symbol. Schritt 3. Klicken Sie auf die Facebook-Login-Schaltfläche. Es öffnet sich ein neues Fenster, in dem Sie sich einloggen können. Schritt 4. Authentifizieren Sie sich bei Facebook und wählen Sie die Seite aus, die Sie verbinden möchten. Aktivieren Sie alle angezeigten Berechtigungen. So kann Chatwoot alle gewünschten Aktionen problemlos ausführen. Schritt 5. Sie können nun Ihre Facebook-Seite aus dem Dropdown-Menü auswählen, das in Chatwoot erscheint. Schritt 6. „Fügen Sie Agenten“ zu Ihrem Facebook-Postfach hinzu. Sie haben erfolgreich ein Facebook-Postfach erstellt. Jedes Mal, wenn ein Kunde eine Nachricht an Ihre Facebook-Seite sendet, können Sie diese in Chatwoot sehen und beantworten. Zusätzliche Postfach-Einstellungen Ihr frisch konfiguriertes Facebook-Postfach sollte nun in Ihrer Liste der Postfächer erscheinen. Um dies zu sehen und weitere Einstellungen für Ihr Facebook-Postfach vorzunehmen, gehen Sie zu Einstellungen → Postfächer → klicken Sie auf das Zahnradsymbol beim zugehörigen Facebook-Postfach. Sie sehen dann folgenden Bildschirm: Einstellungen-Tab Begrüßung für den Kanal aktivieren. Sobald Sie dies aktivieren, sendet Chatwoot eine Begrüßungsnachricht an neue Unterhaltungen, die über Ihr Facebook-Postfach erstellt wurden. CSAT aktivieren. Sobald Sie dies aktivieren, wird bei jeder gelösten Anfrage Ihre Umfrage zur Kundenzufriedenheit ausgelöst. Die CSAT-Ergebnisse können später im Bereich Berichte eingesehen werden. Erneut autorisieren. Wann immer Sie Ihre Facebook-Seite erneut verbinden und autorisieren müssen, tun Sie dies über diese Schaltfläche. Mitarbeiter-Tab Klicken Sie auf den Tab Mitarbeiter. Hier können Sie Agenten zum Postfach hinzufügen oder bereits hinzugefügte Agenten wieder entfernen. Sie können auch die automatische Zuweisung neuer Unterhaltungen an die diesem Postfach hinzugefügten Agenten aktivieren oder deaktivieren. Klicken Sie auf Aktualisieren, um die Änderungen zu speichern. Geschäftszeiten-Tab Klicken Sie auf den Tab Geschäftszeiten. In diesem Abschnitt können Sie die Arbeitszeiten Ihres Teams für das Facebook-Postfach festlegen. Klicken Sie auf das Kontrollkästchen Verfügbarkeit für dieses Postfach aktivieren, wenn Sie klar definierte Geschäftszeiten haben. Sobald das Kontrollkästchen aktiviert ist, öffnet sich der untenstehende Abschnitt. Sie können hier Ihre Nachricht verfassen, die dem Kunden während der Geschäftszeiten außerhalb angezeigt wird. Hinweis: Wenn Captain für ein Postfach aktiviert ist, wird die Abwesenheitsnachricht automatisch unterdrückt. Captain übernimmt dann die Konversationen direkt, auch außerhalb der Geschäftszeiten. Die Abwesenheitsnachricht wird nur gesendet, wenn Captain die Konversation an einen menschlichen Agenten übergibt oder Captain für das Postfach nicht konfiguriert ist. Sie können auch für jeden Wochentag die verfügbaren Geschäftszeiten zusammen mit der passenden Zeitzone auswählen. Klicken Sie auf die Schaltfläche „Geschäftszeiten-Einstellungen aktualisieren“.
Wie erstellt man einen API-Kanaleingang?
Um ein API-Channel-Postfach in Chatwoot-Installationen zu erstellen und zu konfigurieren, befolgen Sie die nachfolgend beschriebenen Schritte. API-Kanal einrichten Schritt 1. Gehen Sie zu Einstellungen → Postfächer → „Postfach hinzufügen“. Schritt 2. Klicken Sie auf das "API"-Symbol. Schritt 3. Geben Sie einen Namen für den Channel und eine Callback-URL an. Hier ein Beispiel: Schritt 4. „Agenten hinzufügen“ zu Ihrem API-Postfach. Die Einrichtung des Postfachs ist abgeschlossen. Nachrichten an den API-Kanal senden Um Nachrichten an den API-Kanal zu senden, stellen Sie sicher, dass Sie die folgenden Modelle und die Nomenklatur verstehen, die in Chatwoot verwendet werden. 1. Channel: Ein Channel definiert den Typ der Quelle der Konversationen. Zum Beispiel Facebook, Twitter, API usw. 2. Postfach: Sie können mehrere Quellen für Konversationen desselben Channel-Typs erstellen. Beispielsweise können Sie mehr als eine Facebook-Seite mit einem Chatwoot-Konto verbinden. Jede Seite wird in Chatwoot als Postfach bezeichnet. 3. Konversation: Eine Konversation ist eine Sammlung von Nachrichten. 4. Kontakt: Jeder Konversation ist eine reale Person zugeordnet, genannt Kontakt. 5. Kontakt-Postfächer: Dies ist die Sitzung jedes Kontakts in einem Postfach. Ein Kontakt kann mehrere Sitzungen und mehrere Konversationen im selben Postfach haben. Wie sende ich eine Nachricht in einem API-Kanal? Um eine Nachricht in einem API-Kanal zu senden, erstellen Sie einen Kontakt, starten eine Konversation und senden schließlich die Nachricht. APIs erfordern das api_access_token im Request-Header. Sie können diesen Token in Ihren Profileinstellungen → Access Token einsehen. 1. Kontakt erstellen Ref: API-Dokumentation Übergeben Sie die Postfach-ID des API-Kanals zusammen mit den anderen angegebenen Parametern. Dadurch wird automatisch eine Sitzung für Sie erstellt. Eine Beispielantwort sieht wie unten aus. { "email": "string", "name": "string", "phone_number": "string", "thumbnail": "string", "additional_attributes": {}, "contact_inboxes": [ { "source_id": "string", "inbox": { "id": 0, "name": "string", "website_url": "string", "channel_type": "string", "avatar_url": "string", "widget_color": "string", "website_token": "string", "enable_auto_assignment": true, "web_widget_script": "string", "welcome_title": "string", "welcome_tagline": "string", "greeting_enabled": true, "greeting_message": "string" } } ], "id": 0, "availability_status": "string" } Wie Sie in der Antwort sehen können, sehen Sie die contact_inboxes und jeder contact_inbox hat eine source_id. Die Source ID kann als Sitzungskennung angesehen werden. Sie werden diese source_id verwenden, um eine neue Konversation zu erstellen wie unten beschrieben. 2. Konversation erstellen Ref: API-Dokumentation Verwenden Sie die source_id aus dem vorherigen API-Aufruf. Sie erhalten eine Konversations-ID, die verwendet werden kann, um eine Nachricht zu erstellen. { "id": 0 } 3. Neue Nachricht erstellen Ref: API-Dokumentation Es gibt 2 Nachrichtentypen. 1. Eingehend: Nachrichten, die vom Endnutzer gesendet werden, gelten als eingehende Nachrichten. 2. Ausgehend: Nachrichten, die vom Agenten gesendet werden, gelten als ausgehende Nachrichten. Wenn Sie die API mit dem korrekten Inhalt aufrufen, erhalten Sie eine Antwort wie diese: { "id": 0, "content": "Dies ist eine eingehende Nachricht vom API-Kanal", "inbox_id": 0, "conversation_id": 0, "message_type": 0, "content_type": null, "content_attributes": {}, "created_at": 0, "private": false, "sender": { "id": 0, "name": "Pranav", "type": "contact" } } Wenn alles erfolgreich ist, sehen Sie die Konversation im Dashboard wie folgt. Sie werden benachrichtigt, wenn eine neue Nachricht auf der beim Erstellen des API-Kanals angegebenen URL erstellt wird. Sie können mehr über die Nachrichten-Nutzlast hier lesen. Nachrichten über Callback-URL empfangen Wenn eine neue Nachricht im API-Kanal erstellt wird, erhalten Sie einen POST-Request an die beim Erstellen des API-Kanals angegebene Callback-URL. Die Nutzlast sieht so aus. Eine vollständige Liste der vom Webhook unterstützten Events finden Sie hier. Event-Typ: message_created { "id": 0, "content": "Dies ist eine eingehende Nachricht vom API-Kanal", "created_at": "2020-08-30T15:43:04.000Z", "message_type": "incoming", "content_type": null, "content_attributes": {}, "source_id": null, "sender": { "id": 0, "name": "contact-name", "avatar": "", "type": "contact" }, "inbox": { "id": 0, "name": "API Channel" }, "conversation": { "additional_attributes": null, "channel": "Channel::Api", "id": 0, "inbox_id": 0, "status": "open", "agent_last_seen_at": 0, "contact_last_seen_at": 0, "timestamp": 0 }, "account": { "id": 1, "name": "API testing" }, "event": "message_created" } Schnittstellen mit Client-APIs erstellen Die verfügbaren Client-APIs für den API-Kanal helfen Ihnen dabei, kundenorientierte Schnittstellen für Chatwoot zu erstellen. Diese APIs sind nützlich für folgende Anwendungsfälle: 1. Verwenden Sie eine eigene Chat-Oberfläche anstelle des Chatwoot-Chat-Widgets. 2. Bauen Sie Konversationsschnittstellen in Ihre mobilen Apps ein. 3. Fügen Sie Chatwoot zu anderen Plattformen hinzu, für die Chatwoot kein offizielles SDK hat. Kundenobjekte erstellen Sie können Kunden-Datenobjekte mit Hilfe des inbox_identifier und customer_identifier erstellen und abrufen. Inbox Identifier Sie erhalten den inbox_identifier in Ihrem API-Kanal → Einstellungen → Konfiguration. Customer Identifier Der customer_identifier oder die source_id wird beim Erstellen des Kunden über die create API bereitgestellt. Sie müssen diesen Bezeichner clientseitig speichern, um im Auftrag des Kunden weitere Anfragen stellen zu können. Dies kann z.B. in Cookies, lokalem Speicher usw. erfolgen. Verfügbare APIs Die verfügbaren Client-APIs sind hier dokumentiert. Mit den APIs können Sie folgendes tun: - Kontakt erstellen, anzeigen und aktualisieren - Konversationen erstellen und auflisten - Nachrichten erstellen, auflisten und aktualisieren HMAC-Authentifizierung Die Client-APIs unterstützen auch die HMAC-Authentifizierung. Das HMAC-Token für den Channel kann durch Ausführen des folgenden Befehls in Ihrer Rails-Konsole abgerufen werden. # Ersetzen Sie api_inbox_id durch Ihre Postfach-ID Inbox.find(api_inbox_id).channel.hmac_token Verbindung zu Chatwoot WebSockets Um Echtzeit-Updates aus dem Agenten-Dashboard zu erhalten, verbinden Sie sich mit Chatwoot WebSockets über folgende URL. <your installation url>/cable WebSocket-Verbindung authentifizieren Nachdem Sie sich mit dem pubsub_token des Kunden angemeldet haben, erhalten Sie Ereignisse, die auf Ihr Kundenobjekt ausgerichtet sind. Das pubsub_token wird beim API-Aufruf zur Kundenanlage bereitgestellt. Beispiel const connection = new WebSocket('ws://localhost:3000/cable'); connection.send(JSON.stringify({ command:"subscribe", identifier: "{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\""+ customer_pubsub_token+"\\"}" })); Eine vollständige Liste der von WebSockets unterstützten Events finden Sie hier. Webhook-Verifizierung Sobald Sie einen API-Kanal erstellen, generieren wir automatisch ein Secret, mit dem Sie die von Ihrer Anwendung empfangene Nutzlast verifizieren können. Mehr über die Webhook-Verifizierung erfahren Sie hier. Umsetzung Hier ist ein Beispiel für eine Chat-Oberfläche, die auf den Client-APIs basiert.
Wie richtet man einen E-Mail-Kanal ein?
Um Ihre Kundenservice-/Ticketing-E-Mails über Chatwoot zu verwalten, können Sie ein E-Mail-Postfach in Chatwoot erstellen. Dies ist eine vollständige Anleitung, wie Sie Ihren E-Mail-Kanal einrichten und nutzen können. Dieses Dokument ist in drei Teile unterteilt: 1. Erstellen eines E-Mail-Postfachs 2. Einstellungen für Gmail-Nutzer 3. Erstellen eines Microsoft-E-Mail-Postfachs Sie können gerne zu jedem Abschnitt springen. Los geht’s. Wie erstellt man ein E-Mail-Postfach in Chatwoot? Schritt 1. Öffnen Sie Ihr Chatwoot-Dashboard. Gehen Sie zu Einstellungen → Postfächer → Postfach hinzufügen. Schritt 2. Klicken Sie auf das "E-Mail"-Symbol. Schritt 3. Geben Sie den Kanalnamen (wie Sie diesen Kanal benennen möchten) und Ihre Support-E-Mail ein und klicken Sie auf den Button "E-Mail-Kanal erstellen". Hinweis: Sie sehen außerdem die Option, Microsoft als E-Mail-Anbieter auszuwählen. Wenn Sie eine Outlook-/Microsoft-E-Mail nutzen, scrollen Sie stattdessen zum Abschnitt "Wie erstellt man einen Microsoft-E-Mail-Kanal?" (letzter Abschnitt). Schritt 4. "Agenten hinzufügen" zu Ihrem E-Mail-Postfach. Sie haben erfolgreich ein E-Mail-Postfach erstellt. Schritt 5. Konfigurieren Sie Ihre E-Mail-Einstellungen. Gehen Sie zu Einstellungen → Postfächer → E-Mail-Postfach Einstellungen → Reiter "Konfiguration". Hier sehen Sie drei Haupt-Einstellungen: 1. Weiterleitung an E-Mail 2. IMAP konfigurieren 3. SMTP konfigurieren Alle drei Einstellungen werden in den folgenden Abschnitten erklärt. Wie leitet man E-Mails an das Chatwoot-Postfach weiter? Schritt 1. Kopieren Sie die "Weiterleitungs-E-Mail-Adresse" aus dem Reiter Konfiguration unter Postfach-Einstellungen. Schritt 2. Richten Sie die kopierte E-Mail-Adresse als Weiterleitungsadresse im E-Mail-Postfach ein. Hinweis: Wie Sie eine Weiterleitungsadresse in Gmail hinzufügen, erfahren Sie im Abschnitt zu Gmail unten. Schritt 3. Senden Sie eine E-Mail an die hinzugefügte Weiterleitungsadresse und prüfen Sie das Chatwoot-E-Mail-Postfach auf die neue E-Mail. Wie konfiguriert man IMAP für den E-Mail-Kanal? Wenn Sie Gmail nutzen, scrollen Sie bitte unten zum IMAP-Abschnitt für Gmail. Schritt 1. Gehen Sie zu Einstellungen → Postfächer → E-Mail-Postfach Einstellungen → Reiter Konfiguration. Schritt 2. Aktivieren Sie die Checkbox IMAP-Konfiguration für dieses Postfach aktivieren. Danach werden folgende Felder sichtbar: 1. Adresse 2. Port 3. E-Mail 4. Passwort Hinweis: Wenn Sie Gmail mit 2FA verwenden, scrollen Sie zum Abschnitt "Wie generiert man ein App-Passwort für Gmail?" weiter unten. Wenn Sie ein reguläres Gmail-Konto nutzen, scrollen Sie zum Abschnitt "Wie erlaubt man weniger sicheren Zugriff auf Gmail?". Schritt 3. Testen Sie, ob alles funktioniert. Senden Sie eine E-Mail an die imap-konfigurierte E-Mail im Chatwoot. Überprüfen Sie das Chatwoot-Postfach auf die neue E-Mail. Öffnen Sie die E-Mail-Konversation in Chatwoot und überprüfen Sie die Details der E-Mail. Wie konfiguriert man SMTP für den E-Mail-Kanal? Schritt 1. Gehen Sie zu Einstellungen -> Postfächer -> E-Mail-Postfach-Einstellungen. Schritt 2. Wählen Sie den Reiter "Konfiguration". Schritt 3. Um SMTP zu aktivieren, wählen Sie die Checkbox "SMTP-Konfiguration für dieses Postfach aktivieren". Füllen Sie die Felder unten aus und klicken Sie anschließend auf den Button "SMTP-Einstellungen aktualisieren". 1. Adresse 2. Port 3. E-Mail 4. Passwort Hinweis: Wenn Sie Gmail mit 2FA verwenden, scrollen Sie zum Abschnitt "Wie generiert man ein App-Passwort für Gmail?". Wenn Sie ein reguläres Gmail-Konto nutzen, scrollen Sie zum Abschnitt "Wie erlaubt man weniger sicheren Zugriff auf Gmail?". 5. Domain Schritt 4. Öffnen Sie eine bestehende E-Mail-Konversation in Chatwoot. Schritt 5. Schreiben Sie eine Antwort für die Konversation und klicken Sie auf den Button "Senden". Überprüfen Sie, ob die E-Mail zugestellt wurde. Sie können auch das Postfach des Empfängers auf die zugestellte E-Mail überprüfen. Einstellungen für Gmail-Nutzer Wie aktiviert man IMAP für das Gmail-Postfach? Schritt 1. Öffnen Sie Ihr Gmail-Postfach und klicken Sie oben rechts auf das Zahnradsymbol für die Einstellungen. Klicken Sie auf den Button "Alle Einstellungen ansehen". Schritt 2. Wählen Sie auf der Einstellungsseite den Reiter "Weiterleitung und POP/IMAP". Schritt 3. Wählen Sie die Option "IMAP aktivieren" im Abschnitt IMAP-Zugriff und klicken Sie auf den Button "Änderungen speichern". Wie erlaubt man weniger sicheren Zugriff auf Gmail? Hinweis: Diese Option ist für Gmail-Konten mit aktivierter Zwei-Faktor-Authentifizierung oder von einer Organisation verwalteten Konten nicht verfügbar. Schritt 1. Gehen Sie zu Google Konto Sicherheit. Schritt 2. Klicken Sie auf "Zugriff aktivieren" im Abschnitt "Zugriff durch weniger sichere Apps" auf der Sicherheitsseite. Schritt 3. Schalten Sie "Weniger sichere Apps zulassen" auf "AN". Nun können Sie Ihr Gmail-Passwort für die IMAP/SMTP-Konfiguration verwenden. Wie generiert man ein App-Passwort für Gmail? Hinweis: Diese Option gilt für Gmail-Konten mit aktivierter Zwei-Faktor-Authentifizierung oder von einer Organisation verwalteten Konten. Schritt 1. Gehen Sie zu Google Konto Sicherheit. Schritt 2. Klicken Sie auf "App-Passwörter" im Abschnitt "Bei Google anmelden" auf der Sicherheitsseite. Schritt 3. Wählen Sie die Mail-App, wählen Sie ein Gerät und klicken Sie auf "GENERIEREN". Verwenden Sie das generierte Passwort, um IMAP/SMTP zu konfigurieren. Wie fügt man eine Weiterleitungsadresse für Gmail hinzu? Schritt 1. Öffnen Sie Ihr Gmail-Postfach und klicken Sie oben rechts auf das Zahnradsymbol für die Einstellungen. Klicken Sie auf "Alle Einstellungen ansehen". Schritt 2. Wählen Sie im Einstellungsbereich den Reiter "Weiterleitung und POP/IMAP". Schritt 3. Klicken Sie auf "Weiterleitungsadresse hinzufügen". Es wird nach der Weiterleitungsadresse gefragt. Geben Sie die Adresse von Chatwoot ein und klicken Sie auf "Weiter". Schritt 4. Bestätigen Sie die Weiterleitungsadresse im Browser-Popup. Das E-Mail-Postfach sendet einen Bestätigungscode an die Weiterleitungsadresse. Schritt 5. Kopieren Sie den Bestätigungscode aus dem Chatwoot-E-Mail-Postfach. Schritt 6. Fügen Sie den Bestätigungscode ein und klicken Sie auf den Button "Bestätigen". Schritt 7. Wählen Sie die Option "Eine Kopie eingehender E-Mails weiterleiten". Wählen Sie die gewünschte Aktion aus dem zweiten Dropdown-Menü und klicken Sie auf "Änderungen speichern". Wie erstellt man einen Microsoft-E-Mail-Kanal? Schritt 1. Öffnen Sie Ihr Chatwoot-Dashboard. Gehen Sie zu Einstellungen → Postfächer → Postfach hinzufügen. Schritt 2. Klicken Sie auf das "E-Mail"-Symbol. Schritt 3. Klicken Sie auf das "Microsoft"-Symbol. Schritt 4. Geben Sie Ihre Outlook-/Microsoft-E-Mail-Adresse ein. Schritt 5. Geben Sie Ihre Microsoft-/Outlook-Zugangsdaten ein. Schritt 6. Erlauben Sie der "Chatwoot"-App, Ihre E-Mails zu lesen und zu beantworten. Schritt 7. "Fügen Sie Agenten" zu Ihrem E-Mail-Postfach hinzu. Sie haben erfolgreich ein Microsoft-E-Mail-Postfach erstellt. Schritt 5. Konfigurieren Sie Ihre E-Mail-Einstellungen. Gehen Sie zu Einstellungen → Postfächer → E-Mail-Postfach Einstellungen → Reiter "Konfiguration". Hinweis: Bitte ändern Sie aktuell nichts in den Einstellungen, da wir die Standardwerte für IMAP und SMTP verwendet haben. Wir werden diese Felder für Outlook-Konten bald nicht mehr editierbar machen. Wir nutzen Standard-IMAP-Einstellungen zum Abrufen sowie SMTP zum Senden von E-Mails; Sie müssen nichts in der Konfiguration einrichten. Schritt 6. Wenn Ihr Zugriffstoken abläuft, müssen Sie Ihr Microsoft-Konto erneut autorisieren, indem Sie zu Einstellungen -> Konfiguration gehen.