Data connectors ermöglichen Fin den Zugriff auf Live-Daten aus Ihren externen Systemen mitten im Gespräch, wie Bestelldetails, Kontostatus und Abonnementinformationen, ohne dass ein Mensch etwas nachschlagen muss. Dieser Artikel ist Ihr Inhaltsverzeichnis für den kompletten Einrichtungsprozess. Folgen Sie den Abschnitten der Reihe nach, wenn Sie von Grund auf neu starten, oder springen Sie zu einem bestimmten Thema, wenn Sie eine Auffrischung benötigen.
Bevor Sie beginnen
Lesen Sie zuerst die konzeptionelle Übersicht. Sie erklärt, was Data connectors und benutzerdefinierte Objekte sind, wie sie zusammenhängen und wann Sie das eine oder das andere benötigen:
Data connectors und Custom Objects erklärt – behandelt die Kernkonzepte, die Beziehung zwischen Connectors und Custom Objects sowie den Unterschied zwischen Fin connectors und Workflow connectors.
Schritt 1: APIs entwerfen und Ihren Connector konfigurieren
Beginnen Sie mit dem Entwurf Ihrer APIs, dann erstellen Sie den Data connector und definieren, wie er Ihre API aufruft.
APIs entwerfen und mit Data connectors verwenden – behandelt, wie Sie Ihre API-Endpunkte so strukturieren, dass sie gut mit Fin data connectors funktionieren, bevor Sie mit der Connector-Konfiguration beginnen.
So richten Sie Data connectors ein – behandelt alle vier Einrichtungsphasen im Detail, einschließlich der API (Dateneingaben und API-Endpunkte), Daten (Formung der API-Antwort), Fin (wie Fin den Connector auslöst) und Sicherheit (Zugriffskontrolle und Live-Schaltung).
Data connector-Vorlagen verwenden – starten Sie schnell mit einer Data connector-Vorlage, die Drittanbieter-Apps verwendet, die in Ihrem Workspace installiert sind.
Schritt 2: Authentifizierung und Sicherheit
Konfigurieren Sie vor dem Live-Gang, wie Ihr Connector sich bei Ihrer externen API authentifiziert und ob Kunden verifiziert werden müssen, bevor Daten für sie sichtbar sind.
Einrichten der Authentifizierung für Data connectors – behandelt Authentifizierungstoken-Typen (Text, OAuth, JWT), die Anmeldeseite und wie Sie die Kunden-Authentifizierung für einzelne Connectors aktivieren.
Data connectors mit Einmal-Passcode sichern – erzwingt OTP-Verifizierung, bevor Fin Kundendaten freigibt.
Best Practices bei der Verwendung von Data connectors mit Fin – behandelt die integrierten Sicherheitsprüfungen auf der Registerkarte Sicherheit, häufige Risiken und Empfehlungen vor dem Live-Gang.
Wichtig: Wenn Sie keine Kunden-Authentifizierung erzwingen, könnten böswillige Akteure Ihre users imitieren und auf deren Daten zugreifen. Überprüfen Sie mindestens die integrierten Prüfungen auf der Registerkarte Sicherheit, bevor Sie einen Connector live schalten.
Schritt 3: Antwortschemas, Objekte und Arrays
Die Form der API-Antwort bestimmt, wie Fin die zurückgegebenen Daten liest und verwendet. Dieser Abschnitt behandelt den Umgang mit verschiedenen Antwortstrukturen.
JSON-Objekte und Arrays, die für die Antwortzuordnung von Data connectors unterstützt werden – behandelt flache Objekte, verschachtelte Objekte, Arrays und XML-Antworten (automatisch in JSON konvertiert). Lesen Sie dies, wenn Ihre API komplexe oder verschachtelte Daten zurückgibt.
Schritt 4: Benutzerdefinierte Objekte und Eigenschaften
Custom Objects ermöglichen es Ihnen, strukturierte, mehrwertige Daten in Intercom zu speichern, wie Bestellungen, Abonnements oder Termine, die nicht durch Standard-Kontakt- oder Gesprächsattribute erfasst werden. Sie füllen sie typischerweise, indem Sie die Antwortdaten eines Connectors auf das Objekt abbilden.
Einrichten eines Custom Object – behandelt das Erstellen von Objekttypen, das Definieren von Eigenschaften, das Befüllen des Objekts über einen Data connector und das Einrichten von Referenzen zu Personen- und Gesprächsobjekten.
Schritt 5: Objektzuordnungen
Die Objektzuordnung sagt dem Connector, wo in Intercom die API-Antwortdaten gespeichert werden sollen. Sie können auf Standardobjekte (Kontakt- und Gesprächsattribute) oder Custom Objects abbilden.
Einrichten von Referenzen mit Custom Objects – behandelt, wie API-Antwortfelder direkt auf Intercom-Kontakt- oder Firmenattribute abgebildet werden, um Daten automatisch von Ihrem externen System in Ihren Intercom-Workspace zu synchronisieren.
So richten Sie Data connectors für Workflows und Inbox ein – enthält zusätzliche Details zur Zuordnung zu Custom Objects, einschließlich der Anforderung für external_id.
Schritt 6: Testen
Jeder Connector verfügt über ein integriertes Testwerkzeug, mit dem Sie den API-Aufruf und die Antwortform vor dem Live-Gang validieren können. Verwenden Sie die Schaltfläche Test connection auf der Registerkarte Data des Connectors, um die vollständige Anfrage und Antwort zu bestätigen. Für End-to-End-Tests, wie Fin den Connector in einem Gespräch verwendet, nutzen Sie Zielgruppenregeln, um den Connector auf Ihre eigene user-E-Mail zu richten.
So führen Sie Data connectors sicher ein – erklärt, wie Sie Ihre Data connectors überwachen und verwalten und die Aktivität der Data connectors im inbox anzeigen.
Schritt 7: Verwendung von Data connectors in Fin-Prozeduren
Fin kann einen Data connector direkt aufrufen, um eine Kundenfrage zu beantworten, aber Connectors sind auch ein Kernbaustein für komplexere, mehrstufige Prozeduren – zum Beispiel eine Bestellung nachschlagen, dann ein Update anbieten und schließlich die Änderung bestätigen.
So verwenden Sie Data connectors in Fin Procedures – zeigt, wie Fin externe API-Daten lesen und darauf reagieren und automatisierte Aktionen während Kundengesprächen ausführen kann.
Fehlerbehebung und FAQs
Wenn Ihr Connector nicht wie erwartet funktioniert, beginnen Sie mit dem Artikel zur Fehlerbehebung. Für Sicherheits- und Datenschutzfragen behandelt der FAQs-Artikel die häufigsten Anliegen.
Verstehen von Data connector-Fehlern – zeigt, wie Sie Data connector-Protokolle lesen und interpretieren, die Ursache von Connector-Fehlern identifizieren und die richtigen Schritte zur Behebung unternehmen.
Fehlerbehebung bei Fin Procedures und Data connectors – behandelt die häufigsten Fehlerbilder, einschließlich Connectors, die Tests bestehen, aber in einer Live-Prozedur fehlschlagen, Eingabefehler und Probleme bei der Antwortanalyse.
Data connectors FAQs – behandelt Datenschutz, Sicherheit, Risiken der Nachahmung und andere häufig gestellte Fragen.
Schnellreferenz: alle Data connector-Artikel
Verwenden Sie diese Tabelle, um direkt zu jedem Artikel in der Data connectors-Dokumentation zu springen.
Artikel | Was es abdeckt |
Kernkonzepte und wann man welches verwendet | |
Strukturierung Ihrer API-Endpunkte für eine gute Zusammenarbeit mit Fin | |
Primäre Connector-Einrichtungsanleitung, behandelt alle vier Einrichtungsphasen im Detail | |
Schnellstartvorlagen mit Drittanbieter-Apps | |
Auth-Tokens, Anmeldedaten, Kunden-Authentifizierung | |
Sicherheitsprüfungen, Best Practices vor dem Live-Gang | |
Antwortschemas, verschachtelte Objekte, Arrays, XML | |
Typen benutzerdefinierter Objekte, Eigenschaften, Befüllung über Connector | |
API-Antwortzuordnung zu Intercom-Attributen | |
Fin-Nutzung und Gesundheitsindikatoren | |
Anwendungsfälle und Beispiele für Data connectors | |
Fin kann externe API-Daten lesen und darauf reagieren | |
Workflow/Inbox-Anwendungsfall, Details zur Objektzuordnung | |
Data connector-Protokolle und Fehler | |
Häufige Fehler und Lösungen | |
Datenschutz, Sicherheit und häufige Fragen |