Daten-Connectoren sind No-Code- und tief integrierte Verbindungen, 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, an häufige Fragen zu denken, die Ihre Teamkollegen viel Zeit kosten, und die Informationen verwenden, die derzeit in Intercom nicht verfügbar sind.
Dies können Fragen sein, bei denen Ihre Kunden einfach Informationen erhalten möchten, die Sie in einem externen System speichern, wie z. B. „Wie ist mein Bestellstatus?“ oder eine Daten-Connector-Aktion wie „Lieferung neu terminieren“ oder „Rückerstattung bearbeiten“ in Ihrem externen System ausführen.
Wenn Sie wissen, welche Fragen Sie lösen möchten, ist es überraschend einfach und schnell, einen Daten-Connector mit wenig bis keiner technischer Expertise einzurichten.
Erstellen eines Daten-Connectors
Navigieren Sie zuerst zu Einstellungen > Integrationen > Daten-Connectoren.
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, Daten-Connectoren für Fin zu verwenden.
Name und Beschreibung
Geben Sie Ihrem Daten-Connector einen eindeutigen Namen, der genau erklärt, welchen Daten-Connector er verwenden wird (z. B. „Bestell-ID abrufen“). Verwenden Sie das Beschreibungsfeld, um Teamkollegen mitzuteilen, wann dieser Daten-Connector verwendet werden soll und welche Informationen er abrufen kann (z. B. „Bestellung für eine bestimmte ID abrufen. Die 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 Macros 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 Daten-Connector diese Anfrage verwenden soll, indem Sie die Methode auswählen:
GET - Informationen vom 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 Anfrage auf, die Bestell-ID von der API mit GET abzurufen und geben die URL ein.
Um eine Anfrage zu stellen, muss die URL eine HTTPS-Adresse sein.
Tipps:
Sie können Attribute von Benutzer, Konversation, Unternehmen 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.
Daten-Connectoren 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
Daten-Connectoren 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 Daten-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, an die Sie die Anfrage stellen (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 analysieren und alle Felder als ungültig ablehnen, selbst wenn das JSON korrekt formatiert ist.
Antwort testen
Als Nächstes müssen Sie die Antwort für diesen Daten-Connector 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 Daten-Connector abgeschlossen wird. Wenn Sie beispielsweise Daten mit DELETE aus der API löschen lassen, werden diese Informationen gelöscht. Testen Sie 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 Daten-Connector korrekt konfiguriert wurde. Sie sollten ein grünes Häkchen erhalten und die Details dieser 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: Daten-Connectoren 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.
Daten-Transformation
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 Transformationen der Daten anzugeben.
Wenn die API-Antwort beispielsweise einen Kontostand von 0 zurückgibt, kann Fin anstatt zu sagen, dass der unbezahlte Kontostand 0 ist, antworten, dass derzeit kein unbezahlter Kontostand mehr vorhanden ist.
Code verwenden, um die Antwort zu filtern oder zu transformieren
Mit Codeblöcken für Daten-Connectoren 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 gibt dem Daten-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.
Häufige Szenarien, in denen Sie Daten möglicherweise nicht speichern müssen, sind Daten-Connector-Anfragetypen PUT, POST, DELETE. Für alle 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 für die 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 ausgewählt und es mit dem API-Attribut „currency“ zugeordnet:
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
Aktualisierung von Verweisen aus Personen oder Gesprächen
Der nächste Schritt besteht darin, auszuwählen, welche Verweise aus Personen oder Gesprächen sich auf Ihr benutzerdefiniertes Objekt beziehen, das Sie aktualisieren möchten.
Live schalten
Sobald 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 nicht vom Kunden 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.
Anzeigen von Data connector-Abhängigkeiten
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 „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 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 Verweisen. Ein Klick auf einen Eintrag führt Sie direkt zur Quelle.
Sie verfolgt die Nutzung von Data connectors in:
Workflows
Prozesse & 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 Gesundheit-Spalte zeigt den Betriebsstatus jedes Connectors basierend auf den jüngsten Erfolgsraten und der Latenzzeit an.
Status | Kriterien | Auswirkung |
Gesund | Erfolgsrate > 95 % und normale Latenz.
| Funktioniert optimal.
|
Verschlechtert | Erfolgsrate zwischen 80–95 % ODER Latenz ist doppelt so hoch wie der historische Durchschnitt.
| Probleme, aber noch teilweise funktionsfähig.
|
Ungesund | Erfolgsrate liegt bei 80 % oder darunter.
| Kritische Probleme, die sofortige Aufmerksamkeit erfordern. |
Fahren Sie mit der Maus über ein Gesundheitsstatus-Symbol, um eine detaillierte Aufschlüsselung der jüngsten Leistung anzuzeigen:
Feldname | Beschreibung |
Erfolgsrate | Prozentsatz erfolgreicher Ausführungen von der Gesamtanzahl der analysierten. |
Externe Latenz | Antwortzeit der externen API/Service (p90, p50, Durchschnitt, Minimum, Maximum in ms).
Hinweis: Nur erfolgreiche Ausführungen sind enthalten.
|
Interne Latenz | Interner Verarbeitungsaufwand (Zeit, die im Intercom-System für die Ausführung des Datenconnectors aufgewendet wird) (p90, p50, Durchschnitt, Minimum, Maximum in ms). |
Intercom-Latenz | Gesamtausführungszeit, berechnet als Externe Latenz + Interne Latenz (p90, p50, Durchschnitt, Minimum, Maximum 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. |
Zeitfilter
Verwenden Sie den Zeitfilter oben im Dashboard, um das Berichtsfenster anzupassen. Verfügbare Optionen: 1h, 6h, 24h, 7d oder 14d.
Logs
Klicken Sie auf einen beliebigen Connector, um dessen dediziertes Gesundheits-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 zu erweitern.
Sie können Logs filtern nach:
Ausführungs-ID
Konversation
Status (Erfolg oder Fehler)
Fehlertyp
Hinweis: Logs 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, außer Betrieb nehmen möchten, können Sie diese in den Entwurfsmodus verschieben.
Gehen Sie zu Einstellungen > Integrationen > Data connectors und klicken Sie auf den Data connector, den Sie in den Entwurfsmodus 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 Entwurfsmodus zu versetzen, können Sie diese jetzt proaktiv mit der Spalte ‚Used by‘ verwalten. Diese Spalte bietet eine Live-Indexliste aller Workflow, 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 Entwurfsmodus wird blockiert, selbst wenn jede verweisende 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 Entwurfsmodus zu versetzen.