Verwenden Sie diesen Artikel, um Data connectors einzurichten, zu konfigurieren und zu verwalten – die Funktion, mit der Fin Live-Daten aus Ihren externen Systemen abruft und Kunden personalisierte Antworten gibt, ohne auf einen Kollegen warten zu müssen. Sie erfahren, wie Sie einen Connector aus einer Vorlage oder von Grund auf neu erstellen, den API-Endpunkt konfigurieren, die Antwort gestalten, steuern, wer ihn auslösen kann, die Sicherheit handhaben, ihn sicher einführen und seine Leistung überwachen.

Jeder Data connector besteht aus einem API (application programming interface)-Aufruf, den Sie konfigurieren. Fin bestimmt automatisch, wann er verwendet wird, um kundenspezifische Antworten zu liefern. Sie können jedes System mit einer API verbinden, einschließlich:

Navigieren Sie zu Einstellungen > Integrationen > Data connectors und klicken Sie auf Neu.

Wenn Sie eine der unterstützten Apps installiert haben, sehen Sie eine Vorlage für diese App unter Data connector erstellen. Vorlagen sind derzeit für Shopify, Stripe und Statuspage verfügbar – siehe Von einer Drittanbieter-Vorlage unten für Details.

Data connector-Vorlagen sind verfügbar, wenn die folgenden Apps in Ihrem Workspace installiert sind:

Wenn die App noch nicht installiert ist, gehen Sie zum App Store, um sie zu installieren. Sobald die App installiert ist, erscheinen Data connector Vorlagen für jede App als Data connector, bereit zur Live-Schaltung.

Wenn Sie auf eine Vorlage klicken, sehen Sie einige Informationen darüber, was der Data connector macht, und können ihn in der Messenger-Vorschau testen. Wenn Sie mit dem Verhalten des Data connectors zufrieden sind, wählen Sie einfach Für AI Agent live schalten.

Die Messenger-Vorschau hier verwendet Beispieldaten. Beim Live-Schalten des Data connectors verwendet Fin Ihre echten Kundendaten.

Wenn Sie den Data connector konfigurieren möchten, können Sie auf Anpassen klicken, was Sie zum Data connector-Builder für erweiterte Konfiguration führt.

Wenn Sie keine unserer unterstützten Apps installiert haben, werden die Apps hier angezeigt, damit Sie sie in Ihrem Workspace installieren können. Nach der Installation erscheinen die entsprechenden Data connector-Vorlagen im obigen Abschnitt.

Um AI-empfohlene Data connectors zu sehen, gehen Sie zu Einstellungen > Integrationen > Data connectors und klicken Sie auf Neuer Data connector.

Sie sehen Ihre einzigartigen AI-empfohlenen Data connectors unter „Data connector aus Vorlage erstellen“. Diese werden basierend auf Ihrem Gesprächsverlauf generiert, um Ihnen potenzielle Data connectors zu zeigen, den Prozentsatz des Gesprächsvolumens, den sie lösen könnten, und eine Vorschau im Messenger, bevor Sie etwas einrichten.

Damit AI-Empfehlungen angezeigt werden, muss Fin in Ihrem Workspace live sein und Sie müssen ein ausreichendes Gesprächsvolumen haben.

Wenn Sie auf einen AI-empfohlenen Data connector klicken, finden Sie Informationen darüber, was der Data connector macht, und können ihn im Messenger (mit Beispieldaten) vorschauen. AI-empfohlene Data connectors sind lediglich Vorschläge basierend auf Ihrem Gesprächsvolumen, erfordern jedoch eine manuelle API-Verbindung, um zu funktionieren.

Um den Data connector live zu schalten, klicken Sie auf Einrichten, um die API-Details zu konfigurieren.

Jetzt müssen Sie nur noch den Data connector mit Ihrer API verbinden, indem Sie die HTTPS-URL hinzufügen.

Um diesen Data connector weiter anzupassen, siehe den Abschnitt Von einem benutzerdefinierten Data connector.

Um Ihren eigenen benutzerdefinierten Data connector für Fin einzurichten, navigieren Sie zu Einstellungen > Integrationen > Data connectors und klicken Sie auf + Neu > + Von Grund auf neu erstellen.

Der API-Tab definiert, wie Intercom mit Ihrem externen System kommuniziert.

Geben Sie Ihrem Connector einen kurzen, beschreibenden Namen – zum Beispiel „Unbezahlten Kontostand abrufen.“ Dies hilft Fin zu verstehen, wann er verwendet werden soll. Fügen Sie eine interne Beschreibung für die Referenz Ihres Teams hinzu.

Dateneingaben ermöglichen es Ihnen, anzugeben, welche Informationen Fin sammeln muss, bevor der Connector ausgeführt wird – zum Beispiel die Kontonummer eines Kunden, wenn diese nicht bereits in Intercom gespeichert ist.

Klicken Sie auf + Dateneingabe und wählen Sie ein Format:

Geben Sie jeder Eingabe einen Namen und eine Beschreibung, damit Fin weiß, wie sie gesammelt wird. Sie können auch einen Fallback-Wert festlegen, falls die API eine null- oder fehlende Antwort zurückgibt.

Wählen Sie für jede Eingabe aus, woher die Daten stammen sollen:

Fügen Sie die HTTPS (sichere Web-) URL für Ihren API endpoint hinzu und wählen Sie die HTTP-Anfragemethode: GET (Daten abrufen), POST (Daten senden), PUT (Daten ersetzen), DELETE (Daten löschen) oder PATCH (Daten teilweise aktualisieren).

Verwenden Sie den Attribute Inserter, um dynamische Werte — wie die user ID eines Kunden — direkt im URL-Pfad oder im Anfragetext zu übergeben.

Wählen Sie ein Authentifizierungstoken aus und fügen Sie alle benutzerdefinierten Schlüssel-Wert-Header hinzu, die Ihre API benötigt (zum Beispiel Content-Type: application/json).

Sobald die Endpoint-URL und die Authentifizierungsdetails vollständig sind, klicken Sie auf Test connection, um Ihre Einrichtung zu überprüfen. Ein erfolgreicher Test zeigt eine grüne Bestätigung und die rohe API-Antwort. Ein fehlgeschlagener Test zeigt den HTTP-Fehlercode und eine Beschreibung an — beheben Sie alle Fehler, bevor Sie mit Phase 2: Data fortfahren.

Der Data-Tab steuert, wie die API-Antwort gefiltert und transformiert wird, bevor Fin sie zur Beantwortung von Kundenanfragen verwendet. Sie können einschränken, welche Felder Fin sieht, und die Daten mit einem visuellen Editor oder Python-Code umformen.

Standardmäßig hat Fin Zugriff auf die vollständige API-Antwort. Um zu begrenzen, was Fin lesen kann, wechseln Sie zu Manually restrict access und wählen nur die Felder aus, die Sie freigeben möchten.

Wählen Sie, wie Sie die Antwort transformieren möchten:

Objektzuordnung ermöglicht es Ihnen, API-Antwortfelder direkt auf Intercom-Kontakt- oder Unternehmensattribute abzubilden und Daten automatisch von Ihrem externen System in Ihren Intercom-Arbeitsbereich zu synchronisieren.

Klicken Sie auf Test code, um Ihre Python-Transformationslogik zu überprüfen, und auf Test connection, um den vollständigen API-Aufruf und die Antwortform zu bestätigen. Beheben Sie alle Fehler, bevor Sie mit Phase 3: Fin fortfahren.

Der Fin-Tab steuert, ob Fin den Data connector automatisch auslöst oder nur, wenn er explizit aus einem workflow, einer procedure oder einem macro aufgerufen wird. Wählen Sie den Auslösemodus, der zur Sensibilität oder Schreibaktivität des Connectors passt.

Fin löst den Connector automatisch basierend auf der Kundenfrage aus — kein workflow erforderlich. Am besten für schreibgeschützte Connectoren wie "Bestellstatus prüfen" und hochvolumige, wiederholbare Anfragen.

Sie können steuern, wer auf diesen Data connector zugreifen kann, mit wiederverwendbaren Fin audiences oder indem Sie eine benutzerdefinierte Zielgruppe speziell für diesen Connector erstellen. Zum Beispiel könnten Sie ihn für Kunden in Ihrer "Enterprise plan"-Zielgruppe verfügbar machen oder auf eine benutzerdefinierte Zielgruppe wie angemeldete users mit verifizierter E-Mail beschränken, die nach ihrem Kontostand fragen.

Der Connector läuft nicht automatisch. Sie müssen ihn manuell zu einem Workflow, einer Procedure oder einem Macro hinzufügen. Am besten für sensible oder schreibaktive Connectoren — wie "Konto löschen" — bei denen menschliche oder workflowbasierte Kontrolle vor dem Ausführen gewünscht ist.

Verwenden Sie die Fin-Vorschau, um genau zu sehen, wie Fin mit diesem Connector antwortet, bevor Sie ihn live schalten.

Der Security-Tab ist der letzte Schritt vor der Live-Schaltung. Er steuert, ob Kunden authentifiziert sein müssen, bevor der Data connector auf ihre Daten zugreifen oder diese anzeigen kann.

Schalten Sie dies ein, um die Authentifizierungsregeln Ihres Arbeitsbereichs durchzusetzen, bevor der Connector auf sensible Informationen zugreifen oder diese anzeigen kann. Die Authentifizierungsregeln werden unter Einstellungen > Arbeitsbereich > Sicherheit > Kundenauthentifizierung konfiguriert.

Führen Sie eine Diagnose durch, um die Gesundheit und Sicherheit Ihrer API-Konfiguration zu bewerten. Risiken werden mit umsetzbaren Empfehlungen angezeigt – beheben Sie diese, bevor Sie den Connector live schalten.

Sobald alle Sicherheitsprüfungen bestanden sind, klicken Sie auf Speichern und dann auf Live schalten. Der Status des Data connectors ändert sich in Einstellungen > Integrationen > Data connectors zu Live. Fin beginnt sofort, ihn für Gespräche zu verwenden, die der konfigurierten Zielgruppe entsprechen.

Wir empfehlen, Zielgruppenregeln zu verwenden, um Data connectors phasenweise an Ihre Kundenbasis auszurollen. So können Sie die Leistung des Data connectors validieren und bei Bedarf Anpassungen vornehmen.

Um vorhandene Data connectors zu finden, navigieren Sie zu Einstellungen > Integrationen > Data connectors. Die Liste der Data connectors zeigt für jeden Connector folgende Details an:

Klicken Sie auf eine Connector-Zeile, um das Gesundheits-Dashboard zu öffnen, in dem Sie Nutzung, Leistungskennzahlen und Ausführungsprotokolle überprüfen oder den Konfigurationseditor öffnen können, um Änderungen vorzunehmen.

Um Data connector-Aktivitäten für ein bestimmtes Gespräch zu sehen, öffnen Sie das Gespräch im Inbox und wählen Sie Gesprächsereignisse anzeigen. Das Ereignisfenster zeigt, ob Fin Zugriff auf den Data connector hatte und ob dieser erfolgreich ausgelöst wurde.

Inbox-Ansichten können mit dem Attribut „Fin AI Agent: Action used in reply“ erstellt werden. Dieses Attribut wird gesetzt, wenn Fin einen Data connector aufruft und eine Teil- oder Gesamtrückmeldung in einer Antwort verwendet.

Data connectors verwenden ein Entwurf-/Live-Versionierungssystem, damit Sie Änderungen sicher vornehmen können, ohne den laufenden Connector zu unterbrechen.

Zwei öffentliche APIs (application programming interfaces) geben Ihnen programmatischen Zugriff auf Data connector-Konfigurationen und Ausführungsergebnisse. Beide verwenden OAuth (Open Authorization) zur Authentifizierung. Die vollständige Referenzdokumentation ist im Intercom Developer Hub verfügbar.

Die Configuration API ist eine Reihe von CRUD (create, read, update, delete) Endpunkten zur programmatischen Verwaltung von Data connectors. Verwenden Sie sie, um neue Connectoren zu erstellen, Connectoren mit Ihren internen Systemen zu synchronisieren und das Connector-Management in großem Maßstab zu automatisieren. Die folgende Tabelle listet die verfügbaren Endpunkte und deren Zweck auf.

Die Authentifizierung verwendet OAuth (Open Authorization). Lese- und Schreibzugriff erfordert den read_write_data_connectors-Bereich. Nur-Lesezugriff erfordert den read_workflow_connector_execution_result-Bereich.

Die Results API bietet programmgesteuerten Zugriff auf Ausführungsdaten für jeden Data connector. Verwenden Sie sie, um benutzerdefinierte Dashboards zu erstellen, Alarmsysteme zu speisen oder tiefere Analysen als das integrierte Health-Dashboard durchzuführen.

Filteroptionen umfassen Erfolgsstatus, spezifische Fehlertypen und Zeiträume, die als Unix-Zeitstempel (Sekunden seit dem 1. Januar 1970 UTC) angegeben sind. Die Paginierung verwendet ein Cursor-basiertes Modell und gibt bis zu 30 Ergebnisse pro Seite zurück. Die Authentifizierung erfolgt über OAuth mit dem read_workflow_connector_execution_result-Bereich.

Die folgenden Einschränkungen gelten für Data connectors. Wo eine Umgehungslösung verfügbar ist, wird diese unten angegeben.

Alle Antwortdaten von Data connectors, die von Fin ausgelöst werden, werden bis zu 14 Tage lang aufgezeichnet und gespeichert. Um auf Protokolle zuzugreifen, navigieren Sie zu Einstellungen > Integrationen > Data connectors, klicken Sie auf den Connector, den Sie untersuchen möchten, und wählen Sie Protokolle.

Für Echtzeitsignale zu Erfolgs- und Fehlerquoten von Data connectors verwenden Sie den Data connector execution webhook. Damit können Sie Ausführungsereignisse von Intercom empfangen und diese zur Erstellung von Echtzeit-Dashboards, Alarmen und SLA-Überwachung (Service Level Agreement) in Ihren externen Diensten nutzen.