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, zu beantworten, und die Informationen verwenden, die derzeit nicht in Intercom verfügbar sind.
Dies 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 eine Data 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 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 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. 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 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 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 User, Conversation, Company und Events 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 Testantwortschritt 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 Authentifizierungstoken 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 entsprechend der API, an die Sie die Anfrage stellen (z. B. accept: application/json und content-type: application\json), einschließen.
Antwort testen
Als Nächstes müssen Sie die Antwort für diesen Data 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 Data 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 nicht ä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 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: 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 Testantwortschritt 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 die Daten, die Fin lesen kann, 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 Umwandlungen 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 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 gibt dem Data connector an, wo diese Informationen in Intercom gespeichert werden sollen, damit sie Kunden in Ihren Workflows als Antworten auf ihre Fragen gegeben werden können.
Häufige Szenarien, in denen Sie Daten möglicherweise nicht speichern müssen, sind Data connector-Anfragetypen PUT, POST, DELETE. Für alle GET-Anfragen müssen Sie die Daten in Intercom speichern, wenn Sie die Daten in Bots verwenden möchten.
Beim Erstellen von Data connectors für Fin ist es nicht notwendig, 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 werden, 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 dem Feld external_id zuordnen, 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.
Das aktuelle Timeout-Limit für Data connectors beträgt 15 Sekunden.
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 kann nützlich sein, 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
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 Spalte Health 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.
| Erlebt Probleme, ist 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 beliebiges Gesundheitsstatus-Symbol, um eine detaillierte Aufschlüsselung der jüngsten Leistung anzuzeigen:
Feldname | Beschreibung |
Erfolgsquote | Prozentsatz der erfolgreichen Ausführungen von der Gesamtzahl der analysierten. |
Externe Latenz | Antwortzeit des 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). |
HTTP-Statusverteilung | Verteilung der von dem externen Service zurückgegebenen HTTP-Statuscodes (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.
Protokolle
Klicken Sie auf einen beliebigen Connector, um dessen dediziertes Gesundheits-Dashboard zu öffnen, und wählen Sie dann den Logs-Tab, 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. 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 Entwurfsstatus 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 Auf 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.