Verwenden Sie diesen Artikel, um Daten-Connectoren 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 Teamkollegen warten zu müssen. Sie erfahren, wie Sie einen Connector aus einer Vorlage oder von Grund auf neu erstellen, dessen API-Endpunkt konfigurieren, die Antwort gestalten, steuern, wer ihn auslösen kann, die Sicherheit handhaben, ihn sicher einführen und seine Leistung überwachen.
Hinweis: Sie benötigen die Berechtigung „Can access developer hub“ permission, um einen Daten-Connector zu erstellen, zu bearbeiten oder live zu schalten.
Wie funktionieren Daten-Connectoren?
Jeder Daten-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:
Benutzerdefinierte interne Backend-Tools
Drittanbieter-Plattformen (Shopify, Salesforce, Stripe, Jira usw.)
Tipp: Daten-Connectoren können von Fin in Procedures und anderen Automatisierungen verwendet werden, einschließlich Workflows und macros aus dem Inbox. Erfahren Sie mehr darüber, wie Sie Ihre APIs mit Daten-Connectoren entwerfen und verwenden.
So erstellen Sie einen Daten-Connector
Navigieren Sie zu Einstellungen > Integrationen > Daten-Connectoren und klicken Sie auf Neu.
Wenn Sie eine der unterstützten Apps installiert haben, sehen Sie eine Vorlage für diese App unter Daten-Connector erstellen aufgelistet. Vorlagen sind derzeit für Shopify, Stripe und Statuspage verfügbar – siehe Von einer Drittanbieter-Vorlage unten für Details.
Von einer Drittanbieter-Vorlage
Daten-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 Daten-Connector-Vorlagen für jede App als Daten-Connector, der bereit ist, live geschaltet zu werden.
Wenn Sie auf eine Vorlage klicken, sehen Sie einige Informationen darüber, was der Daten-Connector macht, und können ihn in der Messenger-Vorschau testen. Wenn Sie mit dem Verhalten des Daten-Connectors zufrieden sind, wählen Sie einfach Für AI Agent live schalten.
Die Messenger-Vorschau verwendet hier standardmäßig Beispieldaten. Wenn Sie als bestimmter Benutzer vorschauen und „Zugriff auf echte Benutzerdaten bei Auslösung“ aktivieren, ruft der Daten-Connector Ihr echtes System auf und gibt die echten Daten dieses Benutzers zurück – verwenden Sie also zum Testen ein Testbenutzerkonto, niemals einen echten Kunden. Wenn der Daten-Connector live geschaltet ist, verwendet Fin echte Kundendaten für Live-Gespräche.
Wenn Sie den Daten-Connector konfigurieren möchten, können Sie auf Anpassen klicken, was Sie zum Daten-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 Daten-Connector-Vorlagen im obigen Abschnitt.
Erfahren Sie mehr über verfügbare Daten-Connector-Vorlagen und Anwendungsfälle für Fin.
Von einer AI-Empfehlung
Um AI-empfohlene Daten-Connectoren zu sehen, gehen Sie zu Einstellungen > Integrationen > Daten-Connectoren und klicken Sie auf Neuer Daten-Connector.
Sie sehen Ihre einzigartigen AI-empfohlenen Daten-Connectoren unter „Daten-Connector aus Vorlage erstellen“. Diese werden basierend auf Ihrem Gesprächsverlauf generiert, um Ihnen potenzielle Daten-Connectoren 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 Daten-Connector klicken, finden Sie Informationen darüber, was der Daten-Connector macht, und können ihn im Messenger (mit Beispieldaten) vorschauen. AI-empfohlene Daten-Connectoren sind lediglich Vorschläge basierend auf Ihrem Gesprächsvolumen, erfordern jedoch eine manuelle API-Verbindung, um zu funktionieren.
Um den Daten-Connector live zu schalten, klicken Sie auf Einrichten, um die API-Details zu konfigurieren.
Jetzt müssen Sie nur noch den Daten-Connector mit Ihrer API verbinden, indem Sie die HTTPS-URL hinzufügen.
Um diesen Daten-Connector weiter anzupassen, siehe den Abschnitt Von einem benutzerdefinierten Daten-Connector.
Erstellen Sie einen benutzerdefinierten Daten-Connector von Grund auf
Um Ihren eigenen benutzerdefinierten Daten-Connector für Fin einzurichten, navigieren Sie zu Einstellungen > Integrationen > Daten-Connectoren und klicken Sie auf + Neu > + Von Grund auf neu erstellen.
Phase 1: API
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.
Siehe Best Practices für das Schreiben von Daten-Connector-Beschreibungen.
Hinweis: Emojis werden in Daten-Connector-Namen nicht unterstützt und führen bei Verwendung zu einem Fehler.
Dateneingaben
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. Wenn Fin eine Suchanfrage oder einen anderen Wert basierend auf der Kundenanfrage an die API übergeben muss, fügen Sie eine Dateneingabe hinzu und setzen Sie die Quelle auf Fin sammeln lassen – Fin sammelt den Wert automatisch aus dem Gespräch.
Klicken Sie auf + Dateneingabe und wählen Sie ein Format:
Text
Nummer
Dezimalzahl
Wahr/Falsch
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:
Let Fin collect — Fin sammelt die Daten automatisch aus dem Gespräch
People attribute — aus einem bestehenden Intercom-Attribut gezogen
Custom value — ein von Ihnen definierter fester Wert
Nach Auswahl einer Quelle verwenden Sie den Erforderlich-Schalter, um festzulegen, ob die Eingabe erforderlich oder optional ist. Dies muss für jede Eingabe manuell konfiguriert werden (der Zustand wird nicht automatisch gesetzt).
Die Beschriftung des Schalters ändert sich je nach ausgewählter Quelle:
Let Fin collect: Der Schalter zeigt Fin muss diesen Parameter sammeln. Wenn aktiviert, muss Fin diesen Wert vom Kunden erfassen, bevor der Connector ausgeführt werden kann.
People attribute oder Custom value: Der Schalter zeigt Dieser Parameter muss einen Wert haben. Wenn aktiviert, wird der Connector nicht ausgeführt, wenn der Wert fehlt.
Der Status erforderlich oder optional jeder Eingabe wird in der Liste der Dateneingaben angezeigt.
API-Endpunkt
Fügen Sie die HTTPS (sichere Web)-URL für Ihren API-Endpunkt hinzu und wählen Sie die HTTP-Anfragemethode: GET (Daten abrufen), POST (Daten senden), PUT (Daten ersetzen), DELETE (Daten entfernen) 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 Attribute immer mit dem Picker aus – geben Sie Tokens niemals manuell ein.
Hinweis: Wenn Ihr Connector die Intercom Contacts API aufruft und einen Kontakt identifizieren muss, wählen Sie Contact ID (user.id) aus dem Picker – nicht User ID (user_id). Die Contacts API erwartet die von Intercom generierte Kontakt-ID (user.id). Die Verwendung von user_id (die extern gesetzte ID) führt zum Fehlschlagen der Suche.
Wichtig: Der Editor wandelt jeden {{...}}-Text in eine Pill um, sodass ein manuell eingegebenes Token identisch mit einem gültigen Attribut aussieht. Wenn der Bezeichner nicht mit einem echten Attribut übereinstimmt – wie user.id oder user_id – wird er zur Laufzeit in einen leeren Wert aufgelöst. Dies macht Ihre Anforderungs-URL fehlerhaft und verursacht Fehler wie 404 ohne sichtbare Hinweise im Editor. Verwenden Sie immer den Attribute Inserter Picker, um Attribute einzufügen.
Authentifizierung und Header
Wählen Sie ein Authentifizierungstoken und fügen Sie alle benutzerdefinierten Schlüssel-Wert-Header hinzu, die Ihre API benötigt (z. B. Content-Type: application/json).
Hinweis: Wenn Sie einen JSON-Anfragetext senden (POST, PUT oder PATCH), müssen Sie explizit einen Content-Type: application/json-Header hinzufügen. Ohne diesen Header wird die empfangende API den Anfragetext nicht parsen und alle Felder als ungültig ablehnen – selbst wenn das JSON korrekt formatiert ist.
Hinweis: Sie können mehrere Tokens an einen einzelnen Connector anhängen. Jeder Token muss einen anderen Header-Schlüssel verwenden – alle angehängten Tokens werden mit jeder Anfrage gesendet.
Sobald die Endpunkt-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 – beheben Sie alle Fehler, bevor Sie mit Phase 2: Daten fortfahren.
Phase 2: Daten — Gestaltung der API-Antwort
Der Daten-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.
Einschränken und Gestalten
Standardmäßig hat Fin Zugriff auf die vollständige API-Antwort. Um zu begrenzen, was Fin lesen kann, wechseln Sie zu Manuell Zugriff einschränken und wählen nur die Felder aus, die Sie freigeben möchten.
Hinweis: Bei Verwendung von Manuell Zugriff einschränken können Felder, deren Namen Sonderzeichen enthalten – wie Klammern (), Pluszeichen + oder Schrägstriche / – aufgrund eines Pfadabgleich-Bugs stillschweigend von den Daten ausgeschlossen werden, die Fin erhält. Um dies zu umgehen, benennen Sie die betroffenen Felder um, um Sonderzeichen zu entfernen, bevor Sie den Zugriff einschränken. Alternativ verwenden Sie den vollständigen Datenzugriff, wenn die Antwort keine sensiblen Daten enthält.
Wählen Sie, wie Sie die Antwort transformieren möchten:
Tabellenansicht — Felder filtern, umbenennen und Transformationen auf Feldebene mit einem visuellen Editor festlegen
Python — Schreiben Sie Python-Code, um die Antwort zu bereinigen, umzuformen oder neu zu formatieren, bevor sie Fin erreicht
Objektzuordnung
Die Objektzuordnung ermöglicht es Ihnen, API-Antwortfelder direkt auf Intercom-Kontakt- oder Firmenattribute abzubilden und synchronisiert Daten automatisch von Ihrem externen System in Ihren Intercom-Arbeitsbereich.
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.
Hinweis: Wenn Sie Objektzuordnung auswählen, sehen Sie in Workflows und Procedures nur zugeordnete Objekte; ohne Zuordnung werden alle Optionen ausgewählt im Einschränken und Gestalten der Daten-Tabelle angezeigt. Bei Python werden nur zurückgegebene Werte angezeigt.
Phase 3: Fin — wie Fin den Connector auslöst
Der Fin-Tab steuert, ob Fin den Daten-Connector automatisch oder nur bei explizitem Aufruf aus einem Workflow, einer Procedure oder einem macro auslöst. Wählen Sie den Auslösemodus, der zur Sensitivität oder Schreibaktivität des Connectors passt.
Tipp: Bevor Fin einen Connector verwenden kann, stellen Sie sicher, dass Folgendes vorhanden ist:
Dateneingaben: Für jeden Wert, den Fin an die API übergeben muss – wie eine Suchanfrage, ein Produktname oder eine Bestell-ID – fügen Sie eine Dateneingabe mit der Quelle Let Fin collect hinzu. Dies weist Fin an, die relevanten Begriffe aus dem Gespräch zu sammeln und automatisch an die API zu übergeben.
Test connection: Führen Sie einen erfolgreichen Test mit echten Daten durch (Phase 1). Die Testantwort bestimmt, was Fin sieht und an Kunden zurückgibt – Beispieldaten spiegeln keine echten Ergebnisse wider.
Fin trigger: Stellen Sie im Fin-Tab Wie soll Fin diesen Connector verwenden? auf Enabled (direct trigger) ein.
Connector description: Schreiben Sie eine klare, fokussierte Beschreibung dessen, was der Connector tut und wann er verwendet wird. So entscheidet Fin, wann er ihn aufruft.
Set live: Schließen Sie die Sicherheitsprüfungen in Phase 4 ab, klicken Sie dann auf Save und Set live.
Wie soll Fin diesen Connector verwenden?
Enabled (direct trigger)
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, für wen dieser Data connector mit wiederverwendbaren Fin-Zielgruppen verfügbar ist oder indem Sie eine benutzerdefinierte Zielgruppe speziell für diesen Connector erstellen. Zum Beispiel könnten Sie ihn für Kunden in Ihrer Zielgruppe „Enterprise plan“ verfügbar machen oder auf eine benutzerdefinierte Zielgruppe wie angemeldete users mit verifizierter E-Mail beschränken, die nach ihrem Kontostand fragen.
Hinweis: Sie können jetzt Fin-Zielgruppen mit Data connectors verwenden. Fin-Zielgruppen sind wiederverwendbare Kundengruppen, die Sie einmal erstellen und dann über mehrere Connectoren hinweg anwenden – das erleichtert die Konsistenz.
Sie können Everyone, eine wiederverwendbare Fin-Zielgruppe oder eine Custom-Zielgruppe für einmalige Regeln wählen.
Sie können mehrere Fin-Zielgruppen auswählen, aber Custom-Regeln können nicht mit einer Fin-Zielgruppe kombiniert werden.
Alle bestehenden Data connector-Zielgruppenregeln, die Sie konfiguriert haben, werden zu einer Custom-Zielgruppe, um die Funktionalität zu erhalten.
Tipp: Wenn Sie den Data connector testen möchten, bevor Sie ihn für Kunden aktivieren, verwenden Sie die Zielgruppenregeln, um den Data connector zunächst nur für sich oder Ihre Teammitglieder zu aktivieren.
Deaktiviert (manueller Auslöser)
Der Connector wird nicht automatisch ausgeführt. Sie müssen ihn manuell zu einem Workflow, einer Procedure oder einem Macro hinzufügen. Am besten für sensible oder schreibaktive Connectoren – wie „Delete account“ – bei denen Sie menschliche oder Workflow-Überwachung wünschen, bevor etwas ausgeführt wird.
Verwenden Sie die Fin-Vorschau, um genau zu sehen, wie Fin mit diesem Connector reagieren wird, bevor Sie ihn live schalten.
Hinweis: Änderungen an der Fin-Trigger-Einstellung werden im Entwurfsmodus gespeichert und treten erst in Kraft, wenn Sie sie veröffentlichen. Die Live-Version des Connectors verwendet weiterhin die bestehenden Einstellungen, bis Sie auf Set live klicken. Nach Änderungen bestätigen Sie immer, dass die Einstellung in der Live-Version und nicht nur im Entwurf reflektiert wird.
Phase 4: Sicherheit – Zugriffskontrolle und Live-Schaltung
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.
Kundenauthentifizierung
Schalten Sie dies ein, um die Authentifizierungsregeln Ihres Workspaces durchzusetzen, bevor der Connector auf sensible Informationen zugreifen oder diese anzeigen kann. Die Authentifizierungsregeln werden unter Einstellungen > Workspace > Security > Customer authentication konfiguriert.
Sicherheitsprüfung
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 Save und dann auf Set live. Der Status des Data connectors ändert sich in Einstellungen > Integrations > Data connectors zu Live. Fin beginnt sofort, ihn für Gespräche zu verwenden, die der konfigurierten Zielgruppe entsprechen.
Wichtig: Es gibt einige potenzielle Wege, wie Fin versehentlich Informationen eines anderen users beim Parameter-Passing teilen könnte. Siehe unsere empfohlenen Einstellungen zur besten Risikominderung.
Wie man Data connectors sicher einführt
Hinweis: Die Messenger-Vorschau hier verwendet standardmäßig Beispieldaten. Wenn Sie als bestimmter user vorschauen und „Access and update real user data when triggered“ aktivieren, ruft der Data connector Ihr echtes System auf und liefert die echten Daten dieses users zurück – verwenden Sie also ein Testuser-Konto, niemals einen echten Kunden, wenn Sie so testen. Wenn der Data connector live geschaltet ist, verwendet Fin echte Kundendaten für Live-Gespräche.
Data connectors erfordern, dass AI Answers im Workflow-Schritt aktiviert ist, damit Fin sie verwenden kann. AI Answers können in Test-Workspaces nicht aktiviert werden, daher können Data connectors nur in Produktionsumgebungen vollständig getestet werden. Verwenden Sie Testuser-Profile in der Produktion für sicheres Testen.
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.
Wie man Data connectors überwacht und verwaltet
Um bestehende Data connectors zu finden, navigieren Sie zu Einstellungen > Integrations > Data connectors. Die Liste der Data connectors zeigt für jeden Connector folgende Details an:
Name und Status (live oder Entwurf)
Allgemeine Nutzung (Gesamtausführungen)
Fin-Nutzung – Auflösungsrate und die Zielgruppe, für die er verfügbar ist
Gesundheit – API-Erfolgsrate und ein allgemeiner Gesundheitsindikator
Sicherheitsstatus
Konfigurationsdetails
Duplikat-Option – Erstellen Sie eine Kopie des Connectors als Ausgangspunkt für einen neuen
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 zum Ändern öffnen können.
Wie man Data connector-Aktivitäten im Inbox anzeigt
Um Data connector-Aktivitäten für ein bestimmtes Gespräch zu sehen, öffnen Sie das Gespräch im Inbox und wählen Sie Show conversation events. Das Ereignis-Panel zeigt, ob Fin Zugriff auf den Data connector hatte und ob er erfolgreich ausgelöst wurde.
Hinweis:
Wenn es einen Fehler beim Auslösen des Data connectors gibt, wählen Sie Logs, um den Grund herauszufinden.
Fin entscheidet sich möglicherweise nicht immer dafür, den Data connector zu verwenden, obwohl eine API-Anfrage gestellt wurde, wenn anderer Inhalt als relevanter eingestuft wird.
Fin kann keine benutzerdefinierten Attribute oder Ereignisdaten für Antworten abfragen. Um Fin zu ermöglichen, mit Echtzeit-Asset-Daten zu antworten, richten Sie Data Connectors ein, damit Fin über API auf externe Datenquellen zugreifen kann.
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 einige oder alle Antworten daraus verwendet.
Versionierung von Data connectors
Data connectors verwenden ein Entwurfs-/Live-Versionierungssystem, damit Sie Änderungen sicher vornehmen können, ohne den laufenden Connector zu unterbrechen.
Jeder Data connector hat eine Live-Version und eine Entwurfs-Version. Änderungen werden am Entwurf vorgenommen, ohne die laufende Live-Version zu beeinflussen.
Wenn Sie einen Entwurf veröffentlichen, wird ein neuer Versions-Snapshot erstellt und zur Live-Version. Sie können beim Veröffentlichen Notizen hinzufügen. Die vorherige Live-Version wird archiviert.
Jede Version speichert eine Versionsnummer, wer sie erstellt hat, Änderungsnotizen (falls hinzugefügt) und einen Zeitstempel.
Die vollständige Änderungshistorie ist nachvollziehbar und Sie können zu jeder vorherigen Version zurückkehren.
Hinweis: Dies gilt für alle Connector-Einstellungen, einschließlich des Fin Trigger-Schalters. Wenn Sie Wie soll Fin diesen Connector verwenden? ändern und nicht veröffentlichen, wird die Live-Version weiterhin genau wie zuvor ausgelöst. Ein Banner im Editor zeigt an, dass Sie ungespeicherte Änderungen haben – klicken Sie immer auf Live setzen, um Ihre Änderungen zu aktivieren.
Öffentliche APIs für Data connectors
Zwei öffentliche APIs (application programming interfaces) bieten Ihnen programmgesteuerten 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.
So verwenden Sie die Configuration API
Die Configuration API ist eine Reihe von CRUD (create, read, update, delete) Endpunkten zur programmgesteuerten Verwaltung von Data connectors. Verwenden Sie sie, um neue Connectoren zu erstellen, Connectoren mit Ihren internen Systemen zu synchronisieren und die Connector-Verwaltung im großen Maßstab zu automatisieren. Die folgende Tabelle listet die verfügbaren Endpunkte und deren Zweck auf.
Methode | Endpunkt | Zweck |
GET | /data_connectors | Gibt eine paginierte Liste aller Data connectors für den Workspace zurück, sortiert nach zuletzt aktualisiert. |
GET | /data_connectors/:id | Ruft die vollständigen Details eines einzelnen Data connectors nach ID ab, einschließlich Konfiguration, Dateneingaben, Antwortfeldern und Objektzuordnungen. |
POST | /data_connectors | Erstellt einen neuen Data connector im Entwurfszustand. Konfigurieren Sie dessen URL, Header, Dateneingaben und andere Einstellungen, und setzen Sie ihn live, wenn er bereit ist. |
PATCH | /data_connectors/:id | Aktualisiert einen bestehenden Data connector. Es werden nur angegebene Felder geändert. Setzen Sie den Zustand auf live oder draft, um den Zustand des Connectors zu ändern. |
DELETE | /data_connectors/:id | Löscht einen bestehenden Data connector. Der Connector muss sich im Entwurfszustand befinden und darf von keinen workflows oder AI agents verwendet werden. |
Die Authentifizierung verwendet OAuth (Open Authorization). Lese- und Schreibzugriff erfordert den read_write_data_connectors-Bereich. Nur-Lese-Zugriff erfordert den read_workflow_connector_execution_result-Bereich.
So verwenden Sie die Results API
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.
GET /data_connectors/:id/execution_results — ruft paginierte Ausführungsprotokolle ab. Standardmäßig werden Ergebnisse der letzten Stunde zurückgegeben. Verwenden Sie
start_tsundend_ts, um den Zeitraum anzupassen. Anforderungs-/Antwortkörper sind standardmäßig ausgeschlossen — verwenden Sieinclude_bodies=true, um sie einzuschließen.GET /data_connectors/:id/execution_results/:result_id — ruft ein einzelnes Ausführungsergebnis ab, das immer vollständige Anforderungs-/Antwortkörper für tiefgehende Fehlerbehebung enthält.
Filteroptionen umfassen Erfolgsstatus, spezifische Fehlertypen und Zeiträume, angegeben als Unix-Zeitstempel (Sekunden seit dem 1. Januar 1970 UTC). 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.
Bekannte Einschränkungen
Die folgenden Einschränkungen gelten für Data connectors. Wo eine Umgehungslösung verfügbar ist, wird diese unten angegeben.
Fin verwendet möglicherweise nicht immer einen Data connector, selbst wenn eine API-Anfrage erfolgreich ausgeführt wird – wenn anderer Inhalt als relevanter für die Kundenfrage bewertet wird, verwendet Fin stattdessen diesen. Keine Umgehung; überprüfen Sie die Benennung und Beschreibung des Connectors, um die Relevanzabstimmung zu verbessern.
Fin kann Intercom-Benutzerdefinierte Attribute oder Ereignisdaten nicht direkt abfragen, um Fragen zu beantworten. Verwenden Sie stattdessen einen Data connector, um diese Daten über einen externen API-Endpunkt bereitzustellen.
Data connectors erfordern, dass AI Answers im Workflow-Schritt aktiviert sind, damit Fin sie verwenden kann. AI Answers können in Test-Workspaces nicht aktiviert werden, daher können Data connectors nur in einer Produktionsumgebung vollständig getestet werden. Verwenden Sie Testbenutzerprofile in der Produktion für sicheres Testen.
Der Data connector execution webhook wird nicht ausgelöst, wenn der Connector als Teil einer Vorschau-Konversation aktiviert wird.
Ein Data connector kann nur über die API gelöscht werden, wenn er sich im Entwurfszustand befindet und von keinen workflows oder AI agents referenziert wird.
Emojis werden in Data connector-Namen nicht unterstützt – das Einfügen führt beim Speichern zu einem Fehler.
Die E-Mail-Adresse des Bearbeiters wird in Data connector-Anfragen nicht als Platzhalter angezeigt – nur die Bearbeiter-ID (
admin_assignee_id) ist verfügbar. Um die E-Mail des Bearbeiters zu erhalten, übergeben Sieadmin_assignee_idund suchen Sie den entsprechenden Datensatz über die Admins API (GET /admins/{admin_id}), die das E-Mail-Feld zurückgibt. Alternativ speichern Sie die E-Mail in einem benutzerdefinierten Gesprächsattribut zum Zeitpunkt der Zuweisung und verweisen stattdessen auf dieses Attribut.
Hinweis: Es gibt kein vom Kunden konfigurierbares Timeout-Feld. Das Standard-Timeout beträgt 15 Sekunden. Für Data connectors, die innerhalb von Fin Procedures in berechtigten Workspaces verwendet werden, wird das Timeout auf 30 Sekunden verlängert.
Fehlerbehebung bei Data connectors
So verwenden Sie Data connector-Protokolle
Alle Antwortdaten von Data connectors, die von Fin ausgelöst werden, werden bis zu 14 Tage lang aufgezeichnet und gespeichert. Wenn Ihre Sicherheits- oder Compliance-Richtlinie ein kürzeres Zeitfenster erfordert, wenden Sie sich an unser Support-Team, um stattdessen eine 7-tägige Aufbewahrung zu beantragen.
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.
So verwenden Sie den Data connector execution webhook
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 nutzen, um Echtzeit-Dashboards, Alarme und SLA (Service Level Agreement)-Überwachung in Ihren externen Diensten zu erstellen.
Hinweise:
Sie müssen eine App erstellen, Webhooks einrichten und den Data connector execution webhook abonnieren, bevor Sie Data connector-Benachrichtigungen erhalten können.
Der Data connector execution webhook wird übersprungen, wenn der Data connector als Teil einer Vorschau-Konversation ausgelöst wird.