Data connectors sind No‑Code und tief eingebettete Integrationen, die Ihre Live-Externdaten mit Intercom verbinden können. Diese Live‑Daten können genutzt werden, um Fin, Workflows und die Inbox zu unterstützen, sodass Ihre Kunden ihre Anfragen automatisch selbst bearbeiten können.
Ein guter Einstieg ist, sich häufige Fragen vor Augen zu führen, die Ihre Kollegen 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 aus einem externen System abrufen möchten, wie „Wie ist der Status meiner Bestellung?“, oder eine Data connector‑Aktion durchführen möchten, z. B. „Lieferung neu terminieren“ oder „Rückerstattung verarbeiten“ 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.
Einen Data connector erstellen
Navigieren Sie zuerst zu Einstellungen > Integrationen > Data connectors.
Hier richten Sie alle 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 ausführen wird (z. B. „Bestell-ID abrufen“). Verwenden Sie das Beschreibungsfeld, um Kollegen zu erklären, wann dieser Data connector verwendet werden sollte und welche Informationen er abrufen kann (z. B. „Bestellung für eine angegebene ID abrufen. Bestell‑ID sollte in Conversation CDA gespeichert sein“).
Um Fin zu ermöglichen, diesen Connector direkt zu verwenden, wechseln Sie zur Registerkarte Fin und setzen Sie How should Fin use this connector? auf Enabled (direct trigger). Wenn Sie möchten, dass er nur innerhalb eines Workflow, einer Task, Procedure oder Macro verwendet wird, setzen Sie ihn auf Disabled (manual trigger).
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 festlegen, welchen Data connector diese Anfrage ausführen 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 lassen wir die Anfrage die Bestell‑ID per GET von der API abrufen 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 Events als Vorlagenwerte in der URL und im Request‑Body von POST‑ und PUT‑Methoden einfügen. Verwenden Sie bereits eingerichtete benutzerdefinierte Datenattribute in Ihrem Workspace. Oder nutzen Sie für größere Datenflexibilität Custom Objects.
Data connectors konvertieren XML‑Antworten automatisch in JSON. Wenn Ihre API XML zurückgibt, geben Sie den Endpunkt wie gewohnt ein — Intercom übernimmt die Konvertierung und zeigt das resultierende JSON im Test‑Response‑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 Key value pair hinzufügen klicken und dann unter HTTP Headers Key value pair auswählen:
Authentifizierung
Data connectors unterstützen sowohl feste als auch dynamische Tokens für die Authentifizierung. Unter den HTTP‑Headern können Sie das Authentifizierungs‑Token auswählen, das Sie in der Anfrage verwenden möchten; dieses wird dann dem Header hinzugefügt.
Hinweis: Sie können mehrere Tokens an einen einzelnen Data connector anhängen. Stellen Sie sicher, dass Sie jedes Token mit einem anderen Header‑Key konfigurieren. Alle angehängten Tokens werden mit der Anfrage gesendet.
Request‑Body
Wenn Sie eine POST‑ oder PUT‑Anfrage durchführen, haben Sie die Möglichkeit, einen Request‑Body anzugeben, um beliebige Daten einzuschließen, die Sie in der Anfrage senden möchten:
Stellen Sie sicher, dass Sie die vom API geforderten HTTP‑Header angeben (z. B. accept: application/json und Content-Type: application/json). Wenn Sie einen JSON‑Body senden, muss Content-Type: application/json ausdrücklich hinzugefügt werden — ohne ihn wird die API den Request‑Body nicht parsen und alle Felder als ungültig ablehnen, auch 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 aus dem Drittanbietersystem abgerufen werden.
Wichtig: Das Testen dieser Anfrage stellt eine Verbindung mit der API her und führt die von Ihnen erstellte Data connector aus. Wenn Sie sie z. B. zum Löschen von Daten in der API aufgefordert haben, werden diese Informationen gelöscht. Testen Sie nach Möglichkeit mit einer GET‑Anfrage, um sicherzustellen, dass Sie nur Informationen lesen und nichts ändern.
Klicken Sie auf Test request, um zu prüfen, ob der Data connector korrekt konfiguriert ist. Sie sollten ein grünes Häkchen sehen und die Details der Anfrage, wenn die Verbindung mit der API validiert wurde.
Das sind alle Informationen, die Sie nun verwenden können, um Ihre Workflows zu betreiben und Kunden schnelle Antworten zu geben, wie z. B. den Bestellstatus.
Tipp: Data connectors konvertieren XML‑Antworten automatisch in JSON. Wenn Ihre API XML zurückgibt, geben Sie den Endpunkt wie gewohnt ein — Intercom übernimmt die Konvertierung und zeigt das resultierende JSON im Test‑Response‑Schritt an. Sie können die Daten dann wie bei einer nativen JSON‑API zuordnen und verwenden.
Daten‑Transformation
Standardmäßig kann Fin auf die vollständigen Antwortdaten zugreifen, um Antworten zu generieren. Wählen Sie Manuell Zugriff einschränken, wenn Sie die Daten begrenzen möchten, auf die Fin zugreifen kann. Markieren Sie dann die Datenfelder, denen Sie Fin Zugriff gewähren möchten.
Sie können die einzelnen Datenelemente auch bearbeiten, indem Sie auf das Bearbeiten-Symbol klicken, um Ihren Antwortdaten einen kundenfreundlichen Namen zu geben und eventuell Transformationen an den Daten anzuwenden.
Wenn die API‑Antwort beispielsweise einen Kontostand von 0 zurückgibt, kann Fin anstatt anzugeben, der unbezahlte Saldo sei 0, antworten, dass derzeit kein unbezahlter Saldo vorhanden ist.
Code zur Filterung oder Transformation der Antwort verwenden
Mit Code‑Blöcken für Data connectors befähigen wir Sie, API‑Antworten direkt mit Python innerhalb Ihrer Connector‑Konfiguration zu transformieren und zu manipulieren.
Objekt‑Mapping
Dieser Schritt ist optional. Er gibt dem Data connector an, wo diese Informationen in Intercom gespeichert werden sollen, damit sie Kunden in Ihren Workflows als Antworten auf ihre Fragen bereitgestellt werden können.
Typische Szenarien, in denen Sie die Daten nicht speichern müssen, sind Data connector‑Anfragetypen PUT, POST, DELETE. Bei allen GET‑Anfragen, wenn Sie die Daten in Bots verwenden möchten, müssen Sie diese Daten in Intercom speichern.
Beim Erstellen von Data connectors für Fin müssen Antwortdaten nicht auf Intercom-Attribute oder -Objekte gemappt werden. Stattdessen interpretiert Fin die JSON-Antwort direkt und kann sie zur Beantwortung von Fragen verwenden. Die Antwort wird auf Basis des Abschnitts „Test response“ erzeugt. Jede Zeile entspricht einem Datenpunkt in der JSON-Antwort.
JSON-Antwortdaten können gespeichert werden in:
Standardobjekte: Benutzer- und Gesprächsattribute.
Custom Objects: Objektattribute, die Sie in Intercom erstellt haben.
Wählen Sie das Intercom-Objekt und mappen Sie es dann mit dem externen API-Objekt.
Alle custom attributes und custom objects 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. Beispielsweise wählten wir „Order“ als Intercom-Objekt und dann „root“ als API-Objekt im externen System und mappten es mit dem API-Attribut „currency":
Externe Daten können nur in benutzerdefinierten Datenattributen und nicht in den Standard-Intercom-Datenattributen gespeichert werden.
Zuordnung von Antwortdaten zu Custom Objects
Beim Mappen mit Custom Objects müssen Sie die ID dem Feld external_id zuordnen, andernfalls werden bei jedem GET-Request Duplikate erstellt. Erfahren Sie mehr über das Einrichten der richtigen Verweise für Custom Objects
Aktualisierung von Verweisen von Personen oder Gesprächen
Als Nächstes wählen Sie aus, welche Verweise von Personen oder Gesprächen sich auf Ihr zu aktualisierendes Custom Object beziehen.
Live schalten
Sobald Sie Ihren Data connector erfolgreich getestet haben, können Sie ihn live schalten.
Hinweis: Data connectors verwenden ein Entwurf-/Live-Versionssystem. Alle Änderungen, die Sie vornehmen – einschließlich der Einstellung des Fin-Triggers unter dem Reiter Fin – werden als Entwurf gespeichert und beeinflussen den Live-Connector erst, wenn Sie auf Set live klicken. Wenn der Connector nach einer Änderung unerwartet zu funktionieren scheint, 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-Limit für Data connectors beträgt 15 Sekunden und ist nicht kundenkonfigurierbar. Für Data connectors, die innerhalb von Fin Procedures in berechtigten Arbeitsbereichen verwendet werden, wird das Timeout auf 30 Sekunden verlängert.
Tipp: Wenn Sie mehr Echtzeit-Einblick in Erfolgs- und Fehlerquoten Ihrer Data Connectors wünschen, können Sie den Data Connector Execution Webhook nutzen. Dies kann nützlich sein, um Ausführungsereignisse für die Erstellung von Echtzeit-Dashboards, Warnungen und SLA-Überwachung in Ihren externen Diensten zu erhalten.
Anzeige von Data connector-Abhängigkeiten
Um Ihre Data connectors sicher 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 „Used by":
Die Spalte Used by ist möglicherweise standardmäßig ausgeblendet. So zeigen Sie sie an:
Navigieren Sie zu Einstellungen > Integrationen > Data connectors.
Klicken Sie oben rechts in der Tabelle auf das Menü (drei horizontale Linien).
Aktivieren Sie das Kontrollkästchen neben Used by.
Diese Spalte bietet eine Live-, klickbare Liste von Verweisen. Ein Klick auf einen Eintrag führt Sie direkt zu dieser Quelle.
Sie verfolgt die Nutzung von Data connectors in:
Workflows
Procedures & Tasks
Custom Answers
Macros
Überwachung der Data connector-Gesundheit
Sobald Ihr Data connector live ist, können Sie seine Leistung direkt unter Einstellungen > Integrationen > Data connectors überwachen.
Indikatoren zum Gesundheitszustand
Eine Health-Spalte zeigt den Betriebszustand jedes Connectors basierend auf seinen jüngsten Erfolgsraten und der Latenz an.
Status | Criteria | Implication |
Healthy | Erfolgsrate > 95% und normale Latenz.
| Funktioniert optimal.
|
Degraded | Erfolgsrate zwischen 80–95 % ODER die Latenz ist 2x der historischen Basis.
| Probleme vorhanden, aber noch teilweise funktionsfähig.
|
Unhealthy | Erfolgsrate 80 % oder darunter.
| Kritische Probleme, die sofortige Aufmerksamkeit erfordern. |
Fahren Sie mit der Maus über ein beliebiges Gesundheitsstatus-Badge, um eine detaillierte Aufschlüsselung der jüngsten Leistung anzuzeigen:
Field Name | Beschreibung |
Erfolgsrate | Prozentsatz erfolgreicher Ausführungen an der Gesamtzahl der analysierten. |
Externe Latenz | Antwortzeit des externen API/Service (p90, p50, Mittelwert, min, max in ms).
Hinweis: Nur erfolgreiche Ausführungen sind enthalten.
|
Interne Latenz | Interner Verarbeitungsaufwand (Zeit, die im System von Intercom zur Ausführung des Data Connectors verbracht wird) (p90, p50, Mittelwert, min, max in ms). |
Intercom-Latenz | Gesamtausführungszeit, berechnet als Externe Latenz + Interne Latenz (p90, p50, Mittelwert, 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“), nach Häufigkeit sortiert, mit Anzahl und Prozentsatz. Gibt null zurück, wenn keine Fehler aufgetreten sind. |
Anzahl der Ausführungen | Die tatsächliche Anzahl der im aktuellen Zeitraum analysierten Ausführungen. |
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 Connector, um dessen dediziertes Gesundheits-Dashboard zu öffnen, und wählen Sie dann die Registerkarte 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 zu erweitern.
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.
Verschieben eines Data connectors in den Entwurfsmodus
Wenn Sie alte Data connectors, die nicht mehr benötigt werden, abkündigen möchten, können Sie sie in den Entwurfszustand 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 Als Entwurf festlegen.
Während Intercom Sie daran hindert, einen Connector mit aktiven Abhängigkeiten in den Entwurf zu versetzen, können Sie diese jetzt proaktiv mithilfe der Spalte 'Used by' verwalten. Diese Spalte liefert eine Live-, indexierte Liste jeder Workflow, Procedure, Task, Macro, and Custom Answer, die auf die Aktion verweist. Sie können direkt auf einen Eintrag in dieser Liste klicken, um zu dieser spezifischen Automation 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 statt live ist. Beheben Sie alle Connector-Referenzen — einschließlich derjenigen in pausierten Procedures — bevor Sie versuchen, den Connector in den Entwurf zu setzen.