Integrations-Hub
Der Integrations-Hub ist der zentrale Ort, an dem ein Unternehmen externe Kanaele und Systeme anbindet, damit sie gemeinsam mit dem CRM arbeiten: Messenger, Website-Formulare, Telefonie, Dokumentenaustausch und eigene Anwendungen. Ein angebundener Kanal lebt nicht mehr fuer sich allein: Eingehende Nachrichten, Anfragen und Anrufe werden zu Anfragen mit Verantwortlichem, Pipeline und Historie.
Der Hub befindet sich im Bereich CRM → Integrationen (Route /crm/integrations). Der Formular-Builder oeffnet sich gleich daneben unter /crm/integrations/forms.
Einheitlicher Ablauf zum Anbinden
Alle Konnektoren werden ueber denselben Ablauf angebunden, in Arbeitsbegriffen:
- Hinzufuegen. Waehlen Sie den Konnektortyp aus dem Katalog und durchlaufen Sie den schrittweisen Assistenten. Oft koennen Sie ein fertiges Geschaeftsszenario waehlen, um nicht alles von Hand einzurichten.
- Einrichten. Fuellen Sie die Hauptfelder aus; fortgeschrittene Transport- und Authentifizierungsparameter bleiben verborgen, solange sie nicht gebraucht werden. Die Einrichtung laesst sich als Entwurf speichern, um spaeter zurueckzukehren.
- Verbindung pruefen. Starten Sie die Pruefung – sie zeigt, ob die Verbindung in Ordnung ist, und nennt eine verstaendliche Ursache, falls etwas nicht stimmt.
- Aktivieren. Speichern Sie die Verbindung mit dem Aktivitaetsschalter. Fuer das Web-Widget und Formulare wird in diesem Schritt der Code zum Einbetten in die Website erzeugt.
- Status und Zustand. Jede Verbindungskarte hat einen Zustand: aktiv und in Ordnung, Warnung, Fehler, Entwurf, archiviert oder ausgeschaltet. Daran sehen Sie sofort, welche Kanaele Aufmerksamkeit brauchen.
- Arbeitsfluss. Jeder Typ hat seinen eigenen Arbeitsbildschirm: Anfragenzaehler bei Formularen, ein Anfrageprotokoll bei der REST-Integration, Synchronisierungsauftraege beim Dokumentenaustausch sowie Zustellzustand und Wiederholungswarteschlange bei Messengern.
Wer richtet es ein
Der Integrations-Hub ist eine administrative Einstellung und keine taegliche Handlung eines Mitarbeiters. Der Katalog laesst sich mit dem Leserecht fuer Kommunikation ansehen; Verbindungen anlegen, aendern, pruefen und loeschen darf, wer das Schreibrecht hat (der Portaladministrator hat vollen Zugriff). Ohne Schreibrecht oeffnet sich der Hub nur lesend: Konnektoren sind sichtbar, aber Assistent, Pruefung und Schalter sind nicht verfuegbar, und beim Versuch erscheint ein Hinweis auf fehlende Berechtigungen.
Konnektoren-Katalog
Im Katalog sind die Typen externer Verbindungen zusammengefasst, die Ihr Portal unterstuetzt. Der Satz an Typen waechst und kann sich zwischen Installationen unterscheiden; sehen Sie die genaue Liste daher immer im Katalog selbst unter /crm/integrations nach, nicht in diesem Artikel. Nachstehend sind die wichtigsten Konnektor-Familien beschrieben.
In einzelnen ausgelieferten Versionen kann eine Konnektorkarte voruebergehend einen technischen internen Namen statt einer Benutzerbezeichnung zeigen. Das aendert weder den Konnektortyp noch seine Berechtigungen; eine solche Ansicht gilt jedoch erst nach einer UI-Korrektur und visuellen Pruefung als lokalisierter Screenshot-Nachweis.
Der Katalog und der Filter der Verbindungen sind nach Arbeitsrichtung gruppiert: Dokumentenaustausch, Chats und Messenger, Formulare, Telefonie, E-Mail, programmatischer Zugriff (REST) und Anmeldung am Portal. Ueber die Gruppen findet man den passenden Typ leichter, wenn der Katalog viele davon enthaelt.
Dokumentenaustausch
- Dokumentenaustausch (SBIS) – die Integration mit dem Betreiber fuer elektronischen Dokumentenaustausch SBIS: Aus der Dokumentkarte werden ausgehende Entwuerfe vorbereitet, Statusangaben und signierte Kopien abgerufen, und eingehende Dokumente werden dem Kunden zugeordnet. Das ist ein regionaler Konnektor fuer Russland. Ausfuehrlich auf der Seite Dokumentenaustausch (SBIS).
- Diadoc – ein zweiter Betreiber fuer elektronischen Dokumentenaustausch in Russland. Der Zweck ist derselbe: ausgehende Dokumente, Signaturstatus und die Zuordnung eingehender Dokumente zum Kunden.
Chats und Messenger
- Telegram-Bot und MAX-Bot – beidseitige Dialogkanaele: Eingehende Nachrichten aus dem Messenger werden mit Anfragen und CRM-Chats verknuepft, und Antworten gehen ueber den Konnektor zurueck.
- WhatsApp – ein Messenger-Dialogkanal mit derselben Logik: Die Nachricht des Kunden wird zu einer Anfrage mit Verantwortlichem und Historie.
- Chat-Widget – ein einbettbares Chatfenster fuer die Website: Der Besucher schreibt von der Website aus, und die Anfrage erscheint im gemeinsamen CRM-Fluss. Der Assistent verlangt mindestens eine erlaubte Domain ohne Protokoll; ausserdem koennen Arbeitsgruppe, Workspace und Pipeline, das Vorabformular sowie der Einbettungscode nach dem Speichern festgelegt werden.
- Chat-Webhook – die Annahme von Nachrichten aus einem externen Chatsystem ueber einen Webhook, wenn es dafuer keinen fertigen Konnektor gibt.
Formulare und Anfragen
- Website-Formular – die einseitige Annahme von Anfragen aus einem externen Formular ueber einen Webhook: Anfragen werden je nach gewaehltem Szenario zu Anfragen – direkt im CRM, zuerst mit Pruefung oder nur lokal.
- Website-Formulare (eingebautes Modul) – portaleigene Formulare, die Sie ohne Programmierer erstellen und veroeffentlichen. Sie haben im Hub keine eigene Einrichtung: Die Schaltflaeche «Formulare oeffnen» fuehrt in den Formular-Builder, und die Karte im Hub zeigt Zaehler fuer Anfragen und CRM-Fehler. Siehe auch Formulare.
- Umfragen – das Sammeln von Antworten aus einem Umfrageformular in denselben Eingangsfluss.
Umfragen sind ein eigener Builder für eingehende Anfragen. Öffnen Sie CRM → Integrationen, erstellen Sie eine Umfrage, fügen Sie Schritte hinzu, konfigurieren Sie Optionen und Kontaktfelder und prüfen Sie „Veröffentlichen“ und „Antworten“. Vor der Veröffentlichung erlaubte Website-Ursprünge eintragen. Das Portal stellt öffentlichen Link und Code für Pop-up/Inline-Widget bereit. Veröffentlichen und Zurücknehmen sind eigene Aktionen und können an der Bereitschaftsprüfung oder einem Fehler scheitern; zum Löschen ist eine zweite Bestätigung erforderlich. Archivieren ist nicht verfügbar. Die öffentliche Seite funktioniert ohne Anmeldung, die Schaltflächensprache folgt der Sprache des Besuchers. Das aktuelle öffentliche Telefonfeld wandelt jede Eingabe unabhängig von Sprache oder Land des Besuchers zwangsweise in das russische Format +7 um; eine internationale Nummer kann dadurch verändert werden. Sammeln Sie bis zur Korrektur keine Telefonnummern über eine Umfrage und behandeln Sie dieses Feld weder als lokalisiert noch als Screenshot-Nachweis. Verwenden Sie nur synthetische Fragen, Ursprünge und Antworten, keine Tokens, echten Kontakte oder aktiven Links.
Kommunikation und E-Mail
- Telefonie – eine Karte für einen externen Telefonieanbieter und CRM-Regeln für eingehende Anrufe. Im aktuellen Assistenten lässt sich kein Routing-Ziel wählen; solange dieses Feld fehlt, gelten ein verbundener Anbieter, eingehendes Routing und CDR nicht als verfügbar.
- Postfach – die Anbindung des Arbeitspostfachs, damit die Korrespondenz mit dem Kunden im CRM landet und nicht im persoenlichen Mailprogramm eines einzelnen Mitarbeiters bleibt.
Programmatischer Zugriff und Anmeldung
- Externe REST-Integration (API-Schluessel) – eine programmatische, beidseitige Verbindung: Ein externes System legt Aufgaben und Deals ueber die API mit einem Zugriffsschluessel an und aktualisiert sie, im Namen eines separaten Servicekontos mit minimalen Rechten. Ausfuehrlich auf der Seite Externe REST-Integration.
- Single Sign-on (OIDC) – die Anmeldung der Mitarbeiter am Portal ueber das unternehmenseigene Authentifizierungssystem. Das ist eine administrative Einstellung fuer das gesamte Portal: Sie aendert die Art, wie Menschen sich anmelden, nicht den Anfragenfluss – stimmen Sie sie deshalb vor dem Aktivieren mit dem Administrator ab. Die Schritte zur Pruefung des Connectors und zum Umgang mit dem einmaligen Secret stehen unter Single Sign-on (OIDC).
Separat wird AI eingerichtet: die Anbindung externer Sprachmodelle und Assistenten – siehe AI und Szenarien.
Aktuelle Einschränkung der Telefonie im Hub: Die Connector-Karte ist verfügbar, aber der Assistent zeigt kein Routing-Ziel — weder Warteschlange noch einzelnen Benutzer. Der Server lehnt das Speichern ohne dieses Ziel ab; Pipeline-Einstellungen sind eine getrennte Ebene. Solange das Feld fehlt, gilt der Anbieter nicht als verbunden und es werden keine eingehende Weiterleitung, Warteschlange, Fallback oder CDR versprochen. Der Ablauf bleibt source-blocked und geplant.
Alle Connectoren im Ueberblick
| Connector | Richtung | Was fuer die Anbindung noetig ist | Was danach zu kontrollieren ist |
|---|---|---|---|
| REST-Integration | Beidseitig (ueber die API) | API-Schluessel, Servicekonto mit minimalen Rechten | Verbindungsstatus, Austauschfehler und eingehende Ereignisse |
| Telegram-Bot / MAX-Bot | Beidseitig (Dialog) | Bot-Token, Empfangsadresse | Dialoge, Zustellfehler und Wiederholungen |
| Beidseitig (Dialog) | Zugang des Kanalanbieters, Empfangsadresse | Dialoge, Zustellfehler und Wiederholungen | |
| Chat-Widget | Beidseitig (Dialog) | Mindestens eine erlaubte Domain ohne Protokoll und Einbettungscode; Vorabformular und Weiterleitung optional | Von der Website erzeugte Anfragen und Korrespondenz |
| Chat-Webhook | Eingehende Nachrichten | Empfangsadresse und Zugang des externen Chatsystems | Angenommene Nachrichten und Verarbeitungsfehler |
| Website-Formular | Einseitig | Empfangsadresse, Quellenname, Token | Angenommene Anfragen und Verarbeitungsfehler |
| Formular-Builder | Einseitig | Ein Formular im Portal selbst zusammenstellen | Angenommene Anfragen und den Fertigstellungsstatus des Formulars |
| Umfragen | Einseitig | Umfrageformular und Regel zur Antwortannahme | Angenommene Antworten und Verarbeitungsfehler |
| Telefonie | Katalog und eingeschränkter Assistent | Anbieter und Pipeline; kein Routing-Ziel | Belegt keine Verbindung, kein Routing und keine CDR |
| Postfach | Beidseitig (E-Mails) | Zugang zum Arbeitspostfach | Korrespondenz je Kunde und Abruffehler |
| Dokumentenaustausch (SBIS) | Beidseitig (Dokumente) | Benutzername/Passwort des Betreibers, juristische Person, Umgebung | Austauschstatus je Dokument |
| Diadoc | Beidseitig (Dokumente) | Zugang des Betreibers, juristische Person | Austauschstatus je Dokument |
| Single Sign-on (OIDC) | Anmeldung am Portal | Daten des unternehmenseigenen Anmeldesystems | Ob sich die Mitarbeiter anmelden koennen |
Die Tabelle beschreibt die wichtigsten Familien, nicht die vollstaendige Liste: Der Satz an Typen im Katalog Ihres Portals kann groesser sein.
Gute Praktiken
- Geben Sie der Verbindung einen verstaendlichen Namen und starten Sie sofort die Verbindungspruefung, statt sie «blind» zu aktivieren.
- Weisen Sie jedem Kanal eine Pipeline, eine Startstufe und einen Verantwortlichen zu, damit keine Anfrage ohne Eigentuemer haengen bleibt.
- Pruefen Sie regelmaessig die Status: Ein Kanal mit Warnung oder Fehler bedeutet verlorene Anfragen und Nachrichten.
- Zeigen Sie Tokens, Schluessel, Passwoerter und Einbettungscodes mit echten Werten nicht auf Screenshots und leiten Sie sie nicht weiter.
Verwandte Seiten