Data connectors sind No-Code- und tief integrierte Integrationen, die Ihre Live-Externdaten mit Intercom verbinden können. Diese Live-Daten können verwendet werden, um Fin, Workflows und die Inbox zu unterstützen, sodass Ihre Kunden ihre Anfragen automatisch selbst bedienen können.
Ein guter Einstieg ist, sich häufige Fragen zu überlegen, die Ihre Teamkollegen viel Zeit kosten und für die Informationen verwendet werden, die derzeit nicht in Intercom verfügbar sind.
Das können Fragen sein, bei denen Ihre Kunden einfach Informationen abrufen möchten, die Sie in einem externen System speichern, wie z. B. „Wie ist mein Bestellstatus?“ oder Data connector wie „Lieferung neu terminieren“ oder „Rückerstattung bearbeiten“ in Ihrem externen System.
Wenn Sie wissen, welche Fragen Sie lösen möchten, ist es überraschend einfach und schnell, einen Data connector mit wenig bis keiner technischen Expertise einzurichten.
Erstellen eines Data connectors
Navigieren Sie zunächst zu Einstellungen > Integrationen > Data connectors.
Hier richten Sie alle verschiedenen Verbindungen zu externen Daten ein (z. B. Shopify, Salesforce usw.), je nach Anwendungsfall. Klicken Sie auf + Neu.
Tipp: Es ist auch möglich, Data connectors für Fin zu verwenden.
Name und Beschreibung
Geben Sie Ihrem Data connector einen eindeutigen Namen, der genau erklärt, welchen Data connector er verwenden wird (z. B. „Bestell-ID abrufen“). Verwenden Sie das Beschreibungsfeld, um Teamkollegen mitzuteilen, wann dieser Data connector verwendet werden soll und welche Informationen er abrufen kann (z. B. „Bestellung für eine bestimmte ID abrufen. Bestell-ID sollte im Conversation CDA gespeichert sein“).
Um Fin die direkte Nutzung dieses Connectors zu ermöglichen, navigieren Sie zum Fin-Tab und stellen Sie Wie soll Fin diesen Connector verwenden? auf Aktiviert (direkter Auslöser). Wenn Sie ihn nur innerhalb eines Workflows, Tasks, Verfahrens oder Macro verwenden möchten, stellen Sie ihn auf Deaktiviert (manueller Auslöser).
API-Verbindung
Füllen Sie als Nächstes die Anfragedetails aus. Hier müssen Sie die HTTPS-URL des Drittanbietersystems eingeben, mit dem Sie sich verbinden (z. B. Shopify, Salesforce usw.).
API-Anfrage
Sie können angeben, welchen Data connector diese Anfrage verwenden soll, indem Sie die Methode auswählen:
GET - Informationen aus dem Drittanbietersystem lesen und speichern.
POST - Informationen im Drittanbietersystem erstellen oder hinzufügen.
PUT - Informationen im Drittanbietersystem aktualisieren.
DELETE - Informationen aus dem Drittanbietersystem entfernen.
PATCH - Informationen im Drittanbietersystem aktualisieren.
In diesem Beispiel fordern wir die Bestellung-ID per GET von der API an und geben die URL ein.
Um eine Anfrage zu stellen, muss die URL eine HTTPS-Adresse sein.
Tipps:
Sie können Attribute von User, Conversation, Company und Ereignissen als Vorlagenwerte in der URL und im Anfragetext von POST- und PUT-Methoden einfügen. Verwenden Sie benutzerdefinierte Datenattribute, die Sie bereits in Ihrem Workspace eingerichtet haben. Oder für viel größere Datenflexibilität versuchen Sie, benutzerdefinierte Objekte zu verwenden.
Data connectors konvertieren XML-Antworten automatisch in JSON. Wenn Ihre API XML zurückgibt, geben Sie einfach wie gewohnt den Endpunkt ein – Intercom übernimmt die Konvertierung und zeigt das resultierende JSON im Test-Antwort-Schritt an. Sie können die Daten dann wie bei einer nativen JSON-API zuordnen und verwenden.
HTTP-Header
Sie können dieser Anfrage zusätzliche Parameter hinzufügen, indem Sie auf Schlüssel-Wert-Paar hinzufügen klicken und dann unter HTTP-Header Schlüssel-Wert-Paar auswählen:
Authentifizierung
Data connectors unterstützen sowohl feste als auch dynamische Tokens zur Authentifizierung. Unter den HTTP-Headern können Sie das Authentifizierungs-Token auswählen, das Sie in der Anfrage verwenden möchten, das dann dem Header hinzugefügt wird.
Hinweis: Sie können mehrere Tokens an einen einzelnen Data connector anhängen. Stellen Sie sicher, dass Sie jedes Token mit einem anderen Header-Schlüssel konfigurieren. Alle angehängten Tokens werden mit der Anfrage gesendet.
Anfragetext
Wenn Sie eine POST- oder PUT-Anfrage stellen, haben Sie die Möglichkeit, einen Anfragetext bereitzustellen, um alle Daten einzuschließen, die Sie in der Anfrage senden möchten:
Stellen Sie sicher, dass Sie die erforderlichen HTTP-Header hinzufügen, die von der API verlangt werden (z. B. accept: application/json und Content-Type: application/json). Wenn Sie einen JSON-Text senden, muss Content-Type: application/json explizit hinzugefügt werden – ohne diesen wird die API den Anfragetext nicht parsen und alle Felder als ungültig ablehnen, selbst wenn das JSON korrekt formatiert ist.
Antwort testen
Als Nächstes müssen Sie die Antwort dieses Data connectors testen, um sicherzustellen, dass die richtigen Daten vom Drittanbietersystem abgerufen werden.
Wichtig: Das Testen dieser Anfrage stellt eine Verbindung mit der API her, sodass der von Ihnen erstellte Data connector abgeschlossen wird. Wenn Sie beispielsweise Daten per DELETE aus der API löschen lassen, werden diese Informationen gelöscht. Testen Sie am besten mit einer GET-Anfrage, um sicherzustellen, dass Sie nur Informationen lesen und nichts ändern.
Klicken Sie auf Anfrage testen, um zu überprüfen, ob der Data connector korrekt konfiguriert wurde. Sie sollten ein grünes Häkchen erhalten und die Details der Anfrage sehen, wenn die Verbindung mit der API validiert wurde.
Dies sind alle Informationen, die Sie jetzt verwenden können, um Ihre Workflows zu unterstützen und Kunden schnelle Antworten zu geben
Tipp: Data connectors konvertieren XML-Antworten automatisch in JSON. Wenn Ihre API XML zurückgibt, geben Sie einfach wie gewohnt den Endpunkt ein – Intercom übernimmt die Konvertierung und zeigt das resultierende JSON im Test-Antwort-Schritt an. Sie können die Daten dann wie bei einer nativen JSON-API zuordnen und verwenden.
Datenumwandlung
Standardmäßig kann Fin auf die vollständigen Antwortdaten zugreifen, um Antworten zu generieren. Wählen Sie Zugriff manuell einschränken, wenn Sie den Datenzugriff von Fin begrenzen möchten. Wählen Sie dann die Datenfelder aus, auf die Fin Zugriff haben soll.
Sie können auch einzelne Datenelemente bearbeiten, indem Sie auf das Bearbeiten-Symbol klicken, um Ihren Antwortdaten einen kundenorientierten Namen zu geben und beliebige Datenumwandlungen anzugeben.
Wenn die API-Antwort beispielsweise einen Kontostand von 0 zurückgibt, kann Fin statt zu sagen, dass der unbezahlte Kontostand 0 ist, antworten, dass derzeit kein unbezahlter Kontostand vorhanden ist.
Code zur Filterung oder Umwandlung der Antwort verwenden
Mit Codeblöcken für Data connectors ermöglichen wir Ihnen, API-Antworten direkt mit Python zu transformieren und zu manipulieren – direkt in Ihrer Connector-Einrichtung.
Objektzuordnung
Dieser Schritt ist optional. Er teilt dem Data connector mit, wo diese Informationen in Intercom gespeichert werden sollen, damit sie Kunden in Ihren Workflows als Antworten auf ihre Fragen bereitgestellt werden können.
Häufige Szenarien, in denen Sie Daten nicht speichern müssen, sind Data connector-Anfragetypen PUT, POST, DELETE. Bei allen GET-Anfragen müssen Sie die Daten in Intercom speichern, wenn Sie sie in Bots verwenden möchten.
Beim Erstellen von Data connectors für Fin ist es nicht erforderlich, Antwortdaten auf Intercom-Attribute oder -Objekte abzubilden. Stattdessen interpretiert Fin die JSON-Antwort direkt und kann sie dann zur Beantwortung von Fragen verwenden. Die Antwort wird basierend auf dem Abschnitt „Test response“ generiert. Jeder Posten entspricht einem Datenpunkt in der JSON-Antwort.
JSON-Antwortdaten können gespeichert werden in:
Standardobjekte: Benutzer- und Gesprächsattribute.
Benutzerdefinierte Objekte: Objektattribute, die Sie in Intercom erstellt haben.
Wählen Sie das Intercom-Objekt aus und ordnen Sie es dann dem externen API-Objekt zu.
Alle benutzerdefinierten Attribute und benutzerdefinierten Objekte müssen erstellt sein, bevor sie hier zur Antwortspeicherung verwendet werden können.
Wählen Sie nun die Datenattribute in Intercom aus, in denen Sie diese Informationen speichern möchten. Zum Beispiel haben wir „Order“ als Intercom-Objekt ausgewählt und dann „root“ als API-Objekt im externen System und es mit dem API-Attribut „currency“ verknüpft:
Externe Daten können nur in benutzerdefinierten Datenattributen und nicht in den Standard-Intercom-Datenattributen gespeichert werden.
Antwortdaten auf benutzerdefinierte Objekte abbilden
Beim Abbilden mit benutzerdefinierten Objekten müssen Sie die ID auf das Feld external_id abbilden, sonst werden bei jeder GET-Anfrage Duplikate erstellt. Erfahren Sie mehr über das Einrichten der richtigen Verweise mit benutzerdefinierten Objekten
Referenzen von Personen oder Gesprächen aktualisieren
Der nächste Schritt ist die Auswahl, welche Referenzen von Personen oder Gesprächen sich auf Ihr benutzerdefiniertes Objekt beziehen, das Sie aktualisieren möchten.
Live schalten
Nachdem Sie Ihren Data connector erfolgreich getestet haben, sind Sie bereit, ihn live zu schalten.
Hinweis: Data connectors verwenden ein Entwurf-/Live-Versionierungssystem. Alle Änderungen, die Sie vornehmen – einschließlich der Fin-Auslöser-Einstellung unter dem Fin-Tab – werden als Entwurf gespeichert und wirken sich erst aus, wenn Sie auf Live schalten klicken. Wenn der Connector nach einer Änderung unerwartet reagiert, prüfen Sie, ob die aktualisierte Version live geschaltet wurde. Die Connector-Liste in den Einstellungen zeigt den aktuellen Status jedes Connectors (live oder Entwurf).
Das Timeout für Data connectors beträgt 30 Sekunden und ist für Kunden nicht konfigurierbar.
Tipp: Wenn Sie eine Echtzeitübersicht über Erfolgs- und Fehlerquoten Ihrer Data Connectors wünschen, können Sie den Data Connector Execution Webhook verwenden. Dies ist nützlich, um Ausführungsereignisse für die Erstellung von Echtzeit-Dashboards, Warnungen und SLA-Überwachung in Ihren externen Diensten zu erhalten.
Abhängigkeiten von Data connectors anzeigen
Um Ihre Data connectors sicher und in großem Umfang zu verwalten oder zu bearbeiten, können Sie proaktiv prüfen, wo jeder Data Connector oder MCP-Aktion in Intercom verwendet wird.
So aktivieren Sie die Ansicht „Verwendet von“:
Die Spalte Used by ist möglicherweise standardmäßig ausgeblendet. So zeigen Sie sie an:
Navigieren Sie zu Einstellungen > Integrationen > Data connectors.
Klicken Sie auf das Menü (drei horizontale Linien) oben rechts in der Tabelle.
Aktivieren Sie das Kontrollkästchen neben Used by.
Diese Spalte bietet eine Live-Liste mit anklickbaren Referenzen. Ein Klick auf einen Eintrag führt Sie direkt zur Quelle.
Sie verfolgt die Nutzung von Data connectors in:
Workflows
Prozeduren & Aufgaben
Benutzerdefinierte Antworten
Macros
Überwachung der Data connector-Gesundheit
Sobald Ihr Data connector live ist, können Sie seine Leistung direkt unter Einstellungen > Integrationen > Data connectors überwachen.
Gesundheitsstatus-Anzeigen
Eine Health-Spalte zeigt den Betriebsstatus jedes Connectors basierend auf den jüngsten Erfolgsraten und der Latenz.
Status | Kriterien | Auswirkung |
Gesund | Erfolgsrate > 95 % und normale Latenz.
| Optimaler Betrieb.
|
Verschlechtert | Erfolgsrate zwischen 80–95 % ODER Latenz ist doppelt so hoch wie der historische Durchschnitt.
| Probleme, aber noch teilweise funktionsfähig.
|
Ungesund | Erfolgsrate von 80 % oder weniger.
| Kritische Probleme, die sofortige Aufmerksamkeit erfordern. |
Fahren Sie mit der Maus über ein Gesundheitsstatus-Symbol, um eine detaillierte Aufschlüsselung der jüngsten Leistung zu sehen:
Feldname | Beschreibung |
Erfolgsrate | Prozentsatz erfolgreicher Ausführungen von der Gesamtanzahl der analysierten. |
Externe Latenz | Antwortzeit des externen API/Service (p90, p50, Durchschnitt, min, max in ms).
Hinweis: Es werden nur erfolgreiche Ausführungen berücksichtigt.
|
Interne Latenz | Interner Verarbeitungsaufwand (Zeit, die im Intercom-System für die Ausführung des Datenconnectors aufgewendet wird) (p90, p50, Durchschnitt, min, max in ms). |
Intercom-Latenz | Gesamtausführungszeit, berechnet als Externe Latenz + Interne Latenz (p90, p50, Durchschnitt, min, max in ms). |
HTTP-Statusverteilung | Verteilung der HTTP-Statuscodes, die vom externen Service zurückgegeben werden (z. B. 200, 500, Timeout) mit Anzahl und Prozentsatz. Gibt null zurück, wenn keine Ausführungen vorhanden sind. |
Verteilung der Fehlertypen | Aufschlüsselung der Fehlertypen (z. B. „Connection Timeout“, „Authentication Failed“), sortiert nach Häufigkeit, mit Anzahl und Prozentsatz. Gibt null zurück, wenn keine Fehler aufgetreten sind. |
Anzahl der Ausführungen | Die tatsächlich analysierte Anzahl der Ausführungen im aktuellen Zeitraum. |
HTTP-Status im Zeitverlauf
Das Health-Dashboard enthält ein gestapeltes Diagramm, das zeigt, wie sich die von der externen API zurückgegebenen HTTP-Statuscodes im ausgewählten Zeitraum entwickelt haben. Jeder Bereich im Diagramm repräsentiert eine Statusklasse:
2xx — erfolgreiche Antworten
3xx — Weiterleitungen
4xx — Client-Fehler (z. B. Authentifizierungsfehler, fehlerhafte Anfragen)
5xx — Serverfehler
Keine Antwort — Anfragen, die zeitlich überschritten wurden oder keine Antwort erhielten
Über dem Diagramm zeigt eine Zusammenfassungszeile die Gesamtanzahl der Anfragen und die Gesamtfehlerquote für den ausgewählten Zeitraum. Das Diagramm teilt sich eine Zeitachse mit dem Ausführungslatenz-Diagramm, sodass Sie Spitzenwerte bei Fehlercodes mit Änderungen der Antwortzeit korrelieren können.
Zeitfilter
Verwenden Sie den Zeitfilter oben im Dashboard, um das Berichtsfenster anzupassen. Verfügbare Optionen: 1h, 6h, 24h, 7d oder 14d.
Protokolle
Klicken Sie auf einen beliebigen Connector, um dessen dediziertes Health-Dashboard zu öffnen, und wählen Sie dann den Tab Logs, um eine zeitgestempelte Aufzeichnung jeder Ausführung zu sehen. Jeder Eintrag zeigt den Kanal, auf dem er ausgeführt wurde, und ob er erfolgreich war oder fehlgeschlagen ist – klicken Sie auf einen Eintrag, um die vollständigen Ausführungsdetails anzuzeigen.
Sie können Protokolle filtern nach:
Ausführungs-ID
Konversation
Status (Erfolg oder Fehler)
Fehlertyp
Hinweis: Protokolle werden bis zu 14 Tage aufbewahrt. Um ein kürzeres 7-Tage-Fenster anzufordern, kontaktieren Sie unser Support-Team. Für programmgesteuerten Zugriff auf Ausführungsdaten außerhalb des Dashboards siehe API access to execution results.
Einen Data connector in den Entwurfsmodus verschieben
Wenn Sie alte Data connectors, die nicht mehr benötigt werden, außer Betrieb nehmen möchten, können Sie diese in den Entwurfsstatus verschieben.
Gehen Sie zu Einstellungen > Integrationen > Data connectors und klicken Sie auf den Data connector, den Sie in den Entwurf verschieben möchten, und wählen Sie dann In Entwurf setzen.
Während Intercom Sie daran hindert, einen Connector mit aktiven Abhängigkeiten in den Entwurf zu setzen, können Sie diese jetzt proaktiv mit der Spalte ‚Used by‘ verwalten. Diese Spalte bietet eine Live-Indexliste aller Workflows, Procedure, Task, Macro und Custom Answer, die auf die Aktion verweisen. Sie können direkt auf jeden Eintrag in dieser Liste klicken, um zu dieser spezifischen Automatisierung zu springen und die Abhängigkeit zu lösen.
Hinweis: Eine Procedure im pausierten Zustand zählt weiterhin als aktive Abhängigkeit. Das Verschieben eines Connectors in den Entwurf wird blockiert, selbst wenn jede referenzierende Procedure pausiert und nicht aktiv ist. Lösen Sie alle Connector-Verweise – einschließlich der in pausierten Procedures – bevor Sie versuchen, den Connector in den Entwurf zu setzen.