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 lernen, 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“ (Erlaubnis), 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 nutzen.
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. 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 hier verwendet Beispieldaten. Beim Live-Schalten des Daten-Connectors verwendet Fin Ihre echten Kundendaten.
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, erscheinen die Apps hier, 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) ansehen. AI-empfohlene Daten-Connectoren sind lediglich Vorschläge basierend auf Ihrem Gesprächsvolumen, erfordern jedoch eine manuelle Verbindung einer API, damit sie 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.“ Das 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 zu einem Fehler, wenn sie enthalten sind.
Dateneingaben
Dateneingaben ermöglichen es Ihnen anzugeben, welche Informationen Fin sammeln muss, bevor der Connector ausgeführt wird – zum Beispiel die Kontonummer eines Kunden, falls 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 der Auswahl einer Quelle verwenden Sie den Required-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 must collect this parameter. Wenn aktiviert, muss Fin diesen Wert vom Kunden erfassen, bevor der Connector ausgeführt werden kann.
People attribute oder Custom value: Der Schalter zeigt This parameter must have a value. Wenn aktiviert, wird der Connector nicht ausgeführt, wenn der Wert fehlt.
Der erforderliche oder optionale Status jeder Eingabe wird in der Liste der Dateneingaben angezeigt.
API endpoint
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 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 – tippen 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 dazu, dass die Suche fehlschlägt.
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 Anzeige 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 (zum Beispiel 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 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 Endpoint-URL und die Authentifizierungsdetails vollständig sind, klicken Sie auf Test connection, um Ihre Einrichtung zu validieren. 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: Data fortfahren.
Phase 2: Data — Gestaltung der API-Antwort
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.
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 Manually restrict access und wählen nur die Felder aus, die Sie freigeben möchten.
Hinweis: Bei Verwendung von Manually restrict access 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
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 validieren, 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 nur zugeordnete Objekte in Workflows und Procedures; ohne Zuordnung werden alle Optionen, die im Restrict and shape the data-Tab ausgewählt sind, aufgelistet. Für Python werden nur zurückgegebene Werte angezeigt.
Phase 3: Fin — wie Fin den Connector auslöst
Der Fin-Tab steuert, ob Fin den Data connector automatisch oder nur bei explizitem Aufruf aus einem workflow, procedure oder 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:
Data inputs: 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 How should Fin use this connector? auf Enabled (direct trigger).
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 sollte 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 „Check order status“ 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 "Enterprise plan"-Zielgruppe verfügbar machen oder auf eine benutzerdefinierte Zielgruppe wie angemeldete Nutzer 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 macht es einfacher, Konsistenz zu wahren.
Sie können Jeden, eine wiederverwendbare Fin-Zielgruppe oder eine Benutzerdefinierte Zielgruppe für einmalige Regeln wählen.
Sie können mehrere Fin-Zielgruppen auswählen, aber Sie können keine Benutzerdefinierten Regeln mit einer Fin-Zielgruppe kombinieren.
Alle bestehenden Data connector-Zielgruppenregeln, die Sie konfiguriert haben, werden zu einer Benutzerdefinierten 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 Prozedur 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 Fin preview, 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 Sicherheits-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 > Sicherheit > Kundenauthentifizierung 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 Speichern und dann auf Set live. Der Status des Data connectors ändert sich in Einstellungen > Integrationen > Data connectors zu Live. Fin wird ihn sofort für Gespräche verwenden, die der konfigurierten Zielgruppe entsprechen.
Wichtig: Es gibt einige potenzielle Wege, wie Fin versehentlich Informationen eines anderen Nutzers beim Parameter-Übergeben teilen könnte. Siehe unsere empfohlenen Einstellungen zur besten Risikominderung.
Wie man Data connectors sicher einführt
Hinweis: Die Messenger-Vorschau hier verwendet Beispieldaten. Wenn Sie den Data connector live schalten, verwendet Fin Ihre echten Kundendaten.
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 Testnutzerprofile 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 > Integrationen > 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
Duplizieren-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 öffnen können, um Änderungen vorzunehmen.
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 Gesprächsereignisse anzeigen. 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 Protokolle, um herauszufinden, warum.
Fin wählt möglicherweise nicht immer die Verwendung des Data connectors, 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 die Antwort mit Echtzeit-Asset-Daten zu ermöglichen, richten Sie Data Connectors so ein, dass 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 eine Teil- oder Gesamtrückmeldung in einer Antwort verwendet.
Versionierung von Data connectors
Data connectors verwenden ein Entwurf-/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 wird 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 Connectoren
Zwei öffentliche APIs (application programming interfaces) bieten 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.
So verwenden Sie die Configuration API
Die Configuration API ist eine Sammlung von CRUD (create, read, update, delete) Endpunkten zur programmatischen Verwaltung von Data Connectoren. 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 Connectoren für den Workspace zurück, sortiert nach zuletzt aktualisiert. |
GET | /data_connectors/:id | Ruft die vollständigen Details eines einzelnen Data Connectors anhand der 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 die angegebenen 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 programmatischen Zugriff auf Ausführungsdaten für jeden Data Connector. Verwenden Sie sie, um benutzerdefinierte Dashboards zu erstellen, Alarmsysteme zu speisen oder tiefere Analysen durchzuführen als das im Produkt integrierte Health-Dashboard.
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. Anfrage-/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, immer mit vollständigen Anfrage-/Antwortkörpern für tiefgehende Fehlerbehebung.
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 Connectoren. 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 Umgehungslösung; überprüfen Sie die Connector-Benennung und Beschreibung, 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 Connectoren 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 Connectoren nur in einer Produktionsumgebung vollständig getestet werden. Verwenden Sie Test-Benutzerprofile in der Produktion für sicheres Testen.
Der Data Connector execution webhook wird nicht ausgelöst, wenn der Connector als Teil eines Vorschau-Gesprächs 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 eines Emojis führt beim Speichern zu einem Fehler.
Hinweis: Es gibt kein vom Kunden konfigurierbares Timeout-Feld. Das Standard-Timeout beträgt 15 Sekunden. Für Data Connectoren, die innerhalb von Fin Procedures in berechtigten Workspaces verwendet werden, wird das Timeout auf 30 Sekunden verlängert.
Fehlerbehebung bei Data Connectoren
So verwenden Sie Data Connector-Protokolle
Alle Antwortdaten von Data Connectoren, 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 Connectoren, 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 Connectoren 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 eines Vorschau-Gesprächs aktiviert wird.