Integrationen, Umzug und API-Schlüssel

Unter Integrationen (/app/integrations) verbindest du reactive.chat mit Werkzeugen, die dein Team schon benutzt. Integrationen gelten für den ganzen Workspace. Einrichten dürfen Eigentümer und Admins; ein Admin, der auf einzelne Projekte beschränkt ist, kann es nicht.

Diese Seite beschreibt, was die Integrationen für dich tun und wie du sie bedienst. Die technischen Einzelheiten, etwa zur Signatur von Webhooks, stehen im Teil Technische Integration.

Ehrlich zum Stand

Für über 30 Dienste steht eine Anbindung bereit. Die meisten davon sind gegen nachgebaute Gegenstellen geprüft, aber noch nicht gegen den echten Dienst gelaufen. Die Integrationsseite kennzeichnet sie mit „Ungeprüft gegen den echten Dienst“; manche tragen „In Arbeit“. Webhooks und Slack tragen diesen Vermerk nicht. Richte eine ungeprüfte Integration ein, teste sie mit echten Daten und gib uns über Feedback geben Bescheid, wenn etwas nicht stimmt.

Eine Integration einrichten

1. Öffne Integrationen. Oben siehst du, wie viele verbunden sind, wie viele einen Fehler haben, pausiert sind, und ob Zustellungen gescheitert sind.
2. Suche im Katalog (Integration suchen, Filter „Alle“ oder „Nicht verbunden“) und klicke Einrichten.
3. Trage die Zugangsdaten ein, die der Dienst verlangt, meist einen API-Schlüssel oder ein Token aus deinem Konto dort.
4. Verbinden und aktivieren prüft die Verbindung sofort und schaltet die Integration ein. Mit Nur speichern, noch nicht aktivieren hebst du dir das für später auf.

Später kannst du eine Integration Bearbeiten, Pausieren, Wieder aktivieren oder Entfernen. Entfernen löscht die gespeicherten Zugangsdaten und lässt sich nicht rückgängig machen. Zugangsdaten werden verschlüsselt gespeichert.

Einen Knopf zum Anmelden beim Dienst gibt es nur für Google Drive. Bei allen anderen trägst du die Zugangsdaten selbst ein, bei Slack zum Beispiel die Angaben einer eigenen Slack-App.

Wenn ein Dienst nicht antwortet

Jede Integration arbeitet über eine Warteschlange. Antwortet ein Dienst nicht, wird mehrmals mit wachsendem Abstand wiederholt; nach wiederholten Ausfällen wird er eine Weile ausgesetzt („Vorübergehend ausgesetzt: der Dienst hat mehrfach nicht geantwortet …“). Ein Ereignis, das nach etwa einer Stunde nicht zugestellt ist, wird verworfen. Die letzten gescheiterten Zustellungen siehst du im Abschnitt Gescheiterte Zustellungen, ohne Inhalt.

Eine Chat-Nachricht wartet nie auf eine Integration. Hängt ein Dienst, läuft der Chat ungestört weiter.

Was es gibt

Meldungen an dein Team

• Slack – jedes neue Gespräch erscheint als Thread in einem Kanal. Ihr antwortet im Thread, der Besucher sieht die Antwort im Chat. /rc zeigt den Stand. Slack-Nutzer ordnest du Agenten zu.
• Microsoft Teams, Discord – Meldungen über eine Webhook-Adresse.
• Telegram – Meldungen an einen Chat über Bot-Token und Chat-ID.
• E-Mail – Meldungen an ein Team-Postfach.

Automatisierung

• Webhooks – reactive.chat schickt Ereignisse signiert an eine https://-Adresse deiner Wahl: neues Gespräch, jede Nachricht, Übergabe an einen Menschen angefordert, Bewertung abgegeben, neuer Fehlerfall. Darüber binden sich auch Zapier, Make und n8n an. Das Signaturgeheimnis kannst du aufdecken, kopieren und neu erzeugen; ein neues Geheimnis gilt sofort, das alte nicht mehr.
• Zapier – über die REST-Hooks der Schnittstelle. Für Make und n8n gibt es noch keine fertige App, dort nimmst du Webhooks.

Kontext im Pult

Diese Integrationen zeigen im Pult in der Kontextspalte Karten zum Besucher, zum Beispiel seine Bestellungen oder seinen CRM-Kontakt, teils mit Aktionen:

• CRM – HubSpot, Pipedrive
• Shop – Shopify, Shopware 6, WooCommerce
• Zahlungen – Stripe (mit einem eingeschränkten Leseschlüssel)
• Website – WordPress
• Analyse – Matomo, Plausible, Google Analytics 4
• Fehler – Sentry

Angaben, die auf einer nicht signierten Angabe des Besuchers beruhen, kennzeichnet die Karte. Aktionen führst du mit Ausführen und einer Rückfrage aus.

Tickets, Termine, Telefon

• Zendesk, Freshdesk, Jira, Linear, GitHub – Tickets bzw. Issues aus einem Gespräch oder einem Fehlerfall anlegen.
• Cal.com – freie Termine zeigen und buchen, auch durch den KI-Assistenten.
• Twilio – SMS aus dem Pult und Sendeweg für den SMS-Kanal.

Wissensquellen

• Notion, Confluence – Inhalte in die Wissensbasis übernehmen.
• Google Drive – unter Wissensbasis, „Dateien & Google Drive“ (siehe Wissensbasis und Help-Center).
• KB-Crawler – Einstellungen für den Durchgang durch deine Website.

Kanäle

• WhatsApp Business, Facebook Messenger, Instagram Direct – siehe Kanäle.

Umzug von einem anderen Anbieter

Unter Umzug (/app/migration) übernimmst du Daten aus einem anderen Chat-Werkzeug:

• Intercom und Crisp – über deren Schnittstelle oder eine Exportdatei; bei Crisp auch Hilfeartikel als Markdown,
• Tidio – über eine Exportdatei,
• Zendesk – über den vollständigen JSON-Export und den Export des Help-Centers.

So gehst du vor:

1. Neuen Umzug anlegen und das Ziel wählen (In welches Projekt?).
2. Verbinden und nachsehen, was da ist – du siehst, was vorhanden ist, und eine Stichprobe.
3. Was soll mit? – Kontakte, Gespräche, Artikel.
4. Umzug starten. Du kannst Anhalten oder den Auftrag verwerfen.

Das solltest du wissen:

• Importierte Gespräche landen geschlossen im Pult.
• Importierte Kontakte gelten als unbestätigt.
• Sensible Angaben in den Texten werden maskiert.
• Anhänge kommen als Verweis, nicht als Datei.
• Ein zweiter Lauf legt nichts doppelt an.
• Deine Zugangsdaten zum alten Anbieter werden nach dem Lauf gelöscht.
• Die Schnittstellen der Anbieter sind ohne echte Konten dort geprüft; die Datei-Importe sind mit Beispieldateien bis zum Ende geprüft.

Mit Snippet tauschen übersetzt das Konto ein vorhandenes Intercom- oder Crisp-Snippet in ein Snippet von reactive.chat. Die JavaScript-Befehle boot, open, identify und track heißen dabei wie bei Intercom.

API-Schlüssel

Unter API-Schlüssel (/app/api-keys, Eigentümer und Admins) legst du Schlüssel für die REST-Schnittstelle an. Ein Schlüssel wird genau einmal angezeigt; danach speichert reactive.chat nur noch einen Abdruck davon. Kopiere ihn also sofort an einen sicheren Ort.

Beim Anlegen wählst du, was der Schlüssel darf:

• nur lesen
• lesen und schreiben
• nur Kundendaten-Import – für den Import nach Kundendaten im Chat
• lesen + Besucherdaten bzw. lesen, schreiben + Besucherdaten – erst damit sieht der Schlüssel Name, E-Mail und Telefon von Besuchern

Die Liste zeigt Name, Präfix, wann und von wem der Schlüssel angelegt und wann er zuletzt benutzt wurde. Widerrufen wirkt sofort und lässt sich nicht zurücknehmen.

Mit einem Schlüssel kannst du reactive.chat auch an KI-Werkzeuge anbinden, die das Model Context Protocol (MCP) sprechen; die Seite zeigt Beispiele dafür. Wie die Schnittstelle funktioniert, steht im Teil Technische Integration.