Zum Hauptinhalt springen

Fin und Data connectors FAQs

Erfahren Sie, wie Sie Data connectors sicher mit Fin nutzen und darauf zugreifen.

Verfasst von Beth-Ann Sher

Zugriff und Verfügbarkeit

Enthält mein Plan Data connectors für Fin?

Data connectors können von Fin in allen pricing plans verwendet werden und Sie werden pro Ergebnis berechnet.

Kann Fin Data connectors in regional gehosteten Workspaces verwenden?

Data connectors sind in allen US-, EU- und AU-hosted workspaces verfügbar.

Was ist mit Custom Actions passiert?

Actions oder „Custom Actions“ wurden einfach in „Data connectors“ umbenannt. Es gibt keine Änderungen an Funktionalität oder Einstellungen.

  • Funktionalität: Fähigkeit, API-Aufrufe in externen Systemen auszulösen. Diese können entweder direkt von Fin ausgelöst werden, um personalisierte Antworten mit Echtzeitdaten zu generieren (z. B. „Bestellstatus abrufen“). Oder sie können zu Workflows oder Fin Procedures hinzugefügt und nach Erfüllung bestimmter Bedingungen ausgelöst werden (z. B. „Bestellung stornieren“ nur verwenden, wenn die Bestellung noch nicht versandt wurde).

  • Navigation: Einstellungen > Integrationen > Data connectors


Datenschutz und Sicherheit

Wie werden sensible Daten in Gesprächen mit Fin behandelt?

Intercom bietet eine PAN-Redaktionsfunktion, die Gesprächsinhalte nach Zahlen durchsucht, die wie Kreditkartennummern aussehen und eine Luhn-Prüfung bestehen. Wird eine passende Nummer gefunden, wird sie bis auf die letzten 4 Ziffern maskiert, und Kunden sehen eine redigierte Version im Web Messenger sowie in den iOS- und Android-SDKs. Die Nummer erscheint auch redigiert im Gespräch im Inbox.

Für zusätzliche Kontrolle können Sie die Strac-App installieren, um sensible Daten aus Intercom-Nachrichten und Anhängen zu erkennen und zu redigieren. So können Sie eine Liste sensibler Datenelemente (SSN, DoB, Führerschein, Reisepass, Kreditkarte, Debitkarte, API-Schlüssel usw.) konfigurieren, die redigiert werden sollen.

Wie verhindere ich, dass sich böswillige Akteure als jemand anderes ausgeben?

Um Identitätsdiebstahl zu verhindern, wird dringend empfohlen, Ihren Messenger durch Erzwingen von Messenger-Sicherheit mit JWTs abzusichern. So wird sichergestellt, dass Daten nur verifizierten Users zugänglich sind. Wenn Sie die Authentifizierung nicht aktivieren, könnten böswillige Akteure möglicherweise unautorisierte Aktionen ausführen oder Data connectors in Ihrem Workspace auslösen.

Für Leads oder für Gespräche, die von anderen Kanälen als dem Messenger stammen, gilt die Messenger-Authentifizierung nicht. In diesen Fällen sollten Sie Einmal-Passcodes (OTP) oder eine andere sichere Verifizierungsmethode verwenden, bevor Sie Benutzerdaten freigeben.

Beeinflusst das Testen eines Data connectors meine Daten?

Ja, wenn Sie beim Testen eines Data connectors die Methoden POST, PUT oder DELETE verwenden, werden diese Aktionen an Ihren Daten ausgeführt. Das Testen eines DELETE-Aufrufs für einen Benutzer löscht diesen also tatsächlich.

Wie stelle ich sicher, dass Fin keine persönlichen Daten mit jemandem teilt, der nicht der User ist?

Es gibt zwei mögliche Wege, wie dies passieren könnte. Siehe Tabelle für die empfohlenen Einstellungen zur besten Risikominderung:

Anwendungsfall

Risiko

Beste Praxis zur Risikominderung

Fin ruft personalisierte Daten für einen Kunden basierend auf einer in einem Intercom CDA gespeicherten User-ID ab.

Ein böswilliger Akteur könnte den CDA-Wert manipulieren, um Fin dazu zu bringen, Daten von einem anderen Konto abzurufen.

Wir empfehlen, dass Sie verhindern, dass users diese Attribute über den Messenger aktualisieren können. Dies hilft sicherzustellen, dass böswillige Akteure keinen Zugriff auf Daten erhalten, die ihnen nicht gehören. Um dies einzurichten, navigieren Sie zu Einstellungen > Daten > Personen, wählen Sie das relevante Attribut aus und aktivieren Sie „Updates über den Messenger verhindern“.

Fin ruft personalisierte Daten für einen Kunden basierend auf einem von Fin gesammelten Datenwert ab.

Ein böswilliger Akteur könnte Fin einen Wert für ein Konto geben, auf das er keinen Zugriff haben sollte.

Wir empfehlen, dass Sie Prüfungen auf der API-Server-Seite durchführen, um sicherzustellen, dass der User Zugriffskontrolle für die angeforderten Daten hat.

Fin ruft personalisierte Daten für einen Kunden basierend auf einem von Fin gesammelten Datenwert ab.

Fin halluziniert einen Wert für einen anderen Kunden und ruft die falschen Daten ab.

Das Risiko dieser Halluzination ist zwar nicht null, aber gering.

Wir empfehlen jedoch, dass Sie Prüfungen auf der API-Server-Seite durchführen, um sicherzustellen, dass der User Zugriffskontrolle für die angeforderten Daten hat.

Wie stelle ich sicher, dass Fin nicht versehentlich Informationen von einem anderen User teilt?

Fin kann nur auf Daten zugreifen, für die Sie im Vorschau-Tab Zugriff gewährt haben. Fin verwendet diese Daten, um Antworten basierend auf der Frage eines Users zu generieren. Wenn es sensible interne Daten gibt, auf die Fin nicht zugreifen soll, wählen Sie Beschränkter Datenzugriff und geben Sie nur Zugriff auf Felder, die Fin zur Antwortgenerierung verwenden soll. Zusätzlich können Sie die Antwortdaten mit kundenorientierten Namen und Werten transformieren. Zum Beispiel können Sie den Antragsstatus „Pending four eyes check“ in eine für Ihre Kunden verständlichere Sprache wie „Ausstehende Prüfung“ umwandeln.


Speicherung, Autorisierung und Ausführung

Wie werden Tokens in Data connectors gespeichert?

Tokens werden als Teil der Header-Konfiguration gespeichert. Für diese Werte verschlüsseln wir Daten im Ruhezustand. Mehr zu Sicherheit bei Intercom.

Welche Authentifizierungsoptionen unterstützen Data connectors?

Data connectors unterstützen sowohl feste als auch dynamische Tokens zur Authentifizierung. Sie können Ihre Authentifizierungs-Tokens einrichten und verwalten, die Sie in der Anfrage verwenden möchten, welche dann dem Header hinzugefügt werden können.

Wie werden Anfragen in Data connectors ausgeführt?

  • Alle Anfragekonfigurationen (Body, URL und Header) sind im Ruhezustand verschlüsselt.

  • Unser Backend sendet alle Anfragen. Das bedeutet, dass wir keine API-Aufrufe vom Browser aus tätigen. Wenn ein User eine Aktion auslöst, wird diese Aktion vom Intercom-System und nicht von der UI ausgelöst.

    Wichtig: Daten von Drittanbietern werden von Intercom nicht validiert, und Ihr Data connector kann Daten überschreiben, die Sie in Intercom gespeichert haben. Sie sollten sicherstellen, dass Sie den von einem Data connector zurückgegebenen Daten vertrauen.

Kann ich basierend auf API-Fehlercodes verzweigen (z. B. 4xx oder 5xx)?

Fehlerbehandlung in workflows: Derzeit können Sie nicht direkt auf bestimmte API-Fehlercodes verzweigen, die von einem Data connector zurückgegeben werden (wie 4xx- oder 5xx-Antworten). Workflows können nur basierend darauf verzweigen, ob ein Data connector-Auslöser erfolgreich ist oder fehlschlägt. Je nach API-Design kann es jedoch eine Umgehung geben. Wenn die API Antwortdetails im JSON-Payload zurückgibt (z. B. ein Statusfeld), können Sie diesen Wert als Conversation Data Attribute (CDA) speichern. Diesen gespeicherten Wert können Sie dann verwenden, um die Verzweigungslogik in späteren Schritten Ihres workflows zu steuern.

Fehlerbehandlung in Fin Procedures: Fin Procedures behandeln Datenconnector-Fehler nicht automatisch. Wenn ein Connector eine Zeitüberschreitung hat oder einen Fehler zurückgibt, versucht Fin nicht, die Anfrage erneut zu senden oder sich eigenständig zu erholen. Ohne explizite Fallback-Anweisungen kann Fin unerwartet stoppen oder Antworten generieren, die nicht auf Ihrer Konfiguration basieren.

Um dies zu vermeiden, stellen Sie sicher, dass Ihre Procedure klare Anweisungen für Fehlerszenarien enthält, z. B.: „Wenn die Abfrage fehlschlägt, entschuldigen Sie sich und eskalieren Sie an einen menschlichen Agenten.“ Wenn Sie ein fortgeschritteneres Fallback-Verhalten benötigen, sollten Sie den Data connector-Aufruf in eine Sub-Prozedur einbetten, um die Fehlerbehandlung besser steuern zu können. Für fortgeschrittene Fehlerbehandlung wird der status_code, der von einem Data connector-Aufruf zurückgegeben wird, jetzt als Ausgabeattribut angezeigt. Sie können diesen in einem Bedingungsschritt referenzieren, um auf bestimmte HTTP-Antwortcodes zu verzweigen – zum Beispiel eine 404 (nicht gefunden) anders zu behandeln als eine 500 (Serverfehler). Siehe Beispiele für Code-Bedingungen in Fin Procedures.

Kann ich das Brand-Attribut über die API beim Erstellen einer Konversation festlegen?

Nein, das Brand-Attribut kann beim Erstellen einer Konversation nicht über die API festgelegt werden. Die Markenassoziation wird automatisch basierend auf der Messenger-Oberfläche bestimmt, die der Kunde verwendet, oder durch Ihre Workflow-Einstellungen — nicht durch die API-Anfrage. Wenn eine Konversation mit einer bestimmten Marke verknüpft werden soll, stellen Sie sicher, dass der Kunde die Konversation über den richtigen gebrandeten Messenger startet oder konfigurieren Sie Ihren Workflow so, dass die entsprechende Marke basierend auf den Konversationsbedingungen zugewiesen wird.

Hinweis: Der Versuch, einen Markenwert im API-Anfragekörper zu übergeben, hat keine Wirkung. Der Wert wird ignoriert und die Markenassoziation wird weiterhin aus der Messenger- oder Workflow-Konfiguration ermittelt.

Können Data connectors mit APIs arbeiten, die XML zurückgeben?

Ja, Data connectors wandeln jetzt automatisch XML-Antworten von APIs in JSON um. So können Sie problemlos eine größere Bandbreite an APIs anbinden und die Daten in Fin, Workflows und Inbox verwenden, ohne das Datenformat manuell konvertieren zu müssen.

Von welchen IP-Adressen sendet Intercom Data connector-Anfragen?

Möglicherweise müssen Sie die folgenden Intercom-IP-Adressen auf die Positivliste setzen (von denen wir Data connector-, Canvas Kit- und webhook-Anfragen senden), um Intercom-Anfragen auf Ihrer Seite zu akzeptieren. Diese sind wie folgt:

USA:

34.231.68.152

34.197.76.213

35.171.78.91

35.169.138.21

52.70.27.159

52.44.63.161

Europa:

54.217.125.63

54.246.173.113

54.216.9.3

Australien:

52.63.36.185

3.104.68.152

52.64.2.165

Ist Fin nur eine informative KI oder kann es auch Aktionen wie Kontoaktualisierungen ausführen?

Fin ist mehr als nur informativ. Während es Fragen basierend auf Ihren Support-Inhalten beantworten kann, kann es auch so konfiguriert werden, dass es Aktionen ausführt. Mit Fin Procedures können Sie Fin beibringen, mehrstufige Prozesse wie Kontoaktualisierungen zu bearbeiten. Mit Data connectors kann Fin sicher Daten in externen Systemen abrufen oder aktualisieren (z. B. den Bestellstatus ändern oder Benutzerdetails aktualisieren).


Verhalten von Fin

Wie Fin mit Procedures, Guidance, Data connectors und Workflows arbeitet

Funktion

Was es tut

Wann zu verwenden

Hinweise

Procedures

Bringen Sie Fin bei, spezifische, mehrstufige Prozesse wie Rückerstattungen oder Kontoaktualisierungen mit natürlicher Sprache und regelbasierten Schritten zu bearbeiten.

Wenn Sie möchten, dass Fin komplexe, mehrstufige Prozesse verwaltet, die durch natürliche Sprache ausgelöst werden.

Am besten für aufwändige, logikgesteuerte Anfragen. Volle Kontrolle mit Gesprächsfluss.

Guidance

Trainieren Sie Fin, genaue Antworten zu liefern und Probleme basierend auf Ihrem Kommunikationsstil und Ihren Richtlinien zu eskalieren.

Wenn Sie möchten, dass Fin Ihren Ton trifft, Eskalationsregeln anwendet und richtlinienkonformen Support sicherstellt.

Führt keine Aktionen aus, steuert aber, wie Fin spricht, klärt und eskaliert.

Data connectors

Ermöglichen Sie Fin den Zugriff auf Daten in externen Systemen (z. B. API-Aufrufe), ausgelöst durch Fin Procedures oder Workflows.

Wenn Sie möchten, dass Fin externe Daten als Teil eines Fin Procedures-, Workflow- oder Inbox-Workflows abruft oder aktualisiert.

Wird von Fin direkt verwendet, um personalisierte Antworten zu generieren. Wird auch innerhalb von Procedures oder Workflows verwendet.

Workflows

Automatisieren Sie operative Workflows wie ticket-Triage, Lead-Qualifizierung und proaktiven Support mit fest codierten Pfaden.

Wenn Sie standardisierte Support-Operationen automatisieren, die keine Flexibilität erfordern, sondern strukturierten, bekannten Pfaden folgen.

Kann schwer skalierbar und wartbar werden, wenn Randfälle zunehmen.

Fin Procedures vs. Workflows

Verwenden Sie einen Workflow, wenn Sie starre, vorbestimmte Automatisierungspfade benötigen (wie Routing, Tagging oder das Senden geplanter Nachrichten), die durch bestimmte Ereignisse oder Schaltflächenauswahlen ausgelöst werden. Verwenden Sie ein Fin Procedure, wenn Sie möchten, dass Fin konversationelle, mehrstufige Prozesse (wie Fragen zur Terminbuchung, Informationssammlung oder Fehlerbehebung) bearbeitet, bei denen Fin sich dynamisch an natürliche Sprachbefehle und Kundenreaktionen anpasst.

Fin Procedures vs. Data connectors

Data connectors rufen einen Bestellstatus ab, um eine personalisierte Antwort zu generieren, während ein Fin Procedure eine Bestellstornierung verarbeitet, die Rückerstattungsberechtigung prüft und die Rückerstattung gegebenenfalls abschließt.

Fin Procedures vs. Fin Guidance

Fin Guidance stellt sicher, dass Fin besonders höflich auf eine Rückerstattungsanfrage reagiert, während ein Fin Procedure den Rückerstattungsprozess basierend auf Berechtigungsregeln automatisiert.

Warum wurde meine Auto-Close-Nachricht nicht gesendet, als Fin eine ausstehende Unterhaltung geschlossen hat?

Wenn Sie Auto-close pending Fin conversations in einem Let Fin Handle Workflow-Schritt aktivieren, können Sie eine Nachricht auswählen, die Fin vor dem Schließen der Unterhaltung senden soll. In einigen Fällen kann Fin die Unterhaltung jedoch schließen, ohne diese Nachricht zu senden.

Fin überspringt das Senden der Auto-Close-Nachricht wenn der Kunde während eines laufenden Jobs inaktiv wird oder während Fin auf eine Antwort des Kunden auf ein interaktives Element (wie Antwort-Buttons) wartet. In diesen Fällen schließt Fin die Unterhaltung wie erwartet, aber stillschweigend.

Fin ist so konzipiert, um den Workflow nicht zu unterbrechen. Wenn Fin während eines aktiven Jobs oder eines interaktiven Schritts eine Auto-Close-Nachricht senden würde:

  • Die Auto-Close-Nachricht würde in der Unterhaltung erscheinen und alle Antwort-Buttons entfernen.

  • Aber Fin würde immer noch darauf warten, dass der Kunde eine dieser Antwortoptionen auswählt.

  • Dies würde dazu führen, dass der Workflow hängen bleibt.

Um dies zu vermeiden, führt Fin das Schließen im Hintergrund durch und sendet die Auto-Close-Nachricht nicht, während ein Workflow mitten in einem Job ist oder auf eine Antwort-Button-Auswahl wartet.

Hinweis: Auch wenn die Nachricht übersprungen wird, wird Fin dennoch:

  • Erkennen, dass der Kunde inaktiv geworden ist.

  • Die Unterhaltung automatisch schließen.

  • Das Schließen in den Unterhaltungsevents protokollieren.


Häufige Fin-Automatisierungsprobleme

Dieser Abschnitt behandelt häufige Probleme mit Fin Chat, E-Mail, Terminplanung und ausgehender Automatisierung – und wie man sie löst.

Fin Chat-Unterhaltungsautomatisierung

Warum schließt Fin Unterhaltungen vorzeitig?

Fin kann Unterhaltungen automatisch aufgrund von Auto-Close-Einstellungen oder Workflow-Konfigurationen schließen. Häufige Ursachen:

  • Wenn der Workflow einen Endschritt erreicht, nachdem bestätigt wurde, dass der Kunde keine weiteren Fragen hat, wird die Unterhaltung geschlossen.

  • Auto-Close-Einstellungen können so konfiguriert sein, dass die Unterhaltung einige Minuten nach der letzten Nachricht von Fin geschlossen wird. Um vorzeitige Schließungen zu verhindern, klicken Sie auf den Let Fin handle-Schritt in Ihrem Workflow und passen Sie den Auto-Close-Timer auf eine längere Dauer an.

Warum antwortet Fin nicht auf Kundenanfragen?

Fin antwortet möglicherweise aus folgenden Gründen nicht auf Kundenanfragen:

  • Erreichen des Nutzungslimits, das von Ihrem Workspace festgelegt wurde. Überprüfen Sie die Fin Usage-Seite und erhöhen Sie das Limit bei Bedarf.

  • Workflow-Konfigurationen, die die Weiterleitung an menschliche Agenten anstelle von Fin priorisieren. Überprüfen und passen Sie Ihre Workflow-Auslöser an, um sicherzustellen, dass Fin angemessen verwendet wird.

Warum eskaliert Fin Anfragen unnötig an menschliche Agenten?

Fin eskaliert Anfragen möglicherweise unnötig an menschliche Agenten, wenn das von Ihrem Workspace festgelegte Lösungs-Limit erreicht wurde. Navigieren Sie zu Einstellungen > Abrechnung > Nutzung und überprüfen Sie das Lösungsdiagramm. Erhöhen Sie das Limit bei Bedarf.

Warum schließt Fin eine Unterhaltung, nachdem nach weiteren Informationen gefragt wurde?

Wenn ein Kunde keine Eskalation anfordert, nachdem Fin keine zufriedenstellende Antwort geben konnte, kann die Unterhaltung geschlossen werden. Kunden können Fin auch nach dem Schließen einer Unterhaltung weitere Fragen stellen – Fin öffnet sie wieder, wenn sie antworten.

Warum antwortet Fin, ohne dass eine Frage gestellt wurde?

Fin berücksichtigt alle vorherigen Eingaben in der Unterhaltung – einschließlich der Auswahl von Quick Reply-Buttons – bei der Formulierung seiner Antwort. Wenn Sie möchten, dass Fin nur auf explizite Fragen antwortet, aktualisieren Sie seine Guidance-Anweisungen, um dieses Verhalten zu spezifizieren.

Warum antwortet Fin nicht auf Kunden, die auf Outbound-Nachrichten antworten?

Die Option, dass Fin auf Antworten von Outbound-Nachrichten reagiert, funktioniert nur mit einer Simple-Deployment-Konfiguration. Wenn Sie Advanced Deployment mit Workflows verwenden, wird Fin nicht automatisch auf diese Antworten reagieren. Wechseln Sie zu einer Simple-Deployment-Konfiguration oder bearbeiten Sie Antworten über einen Advanced Workflow mit einem Let Fin handle-Schritt.

Warum schließt Fin eine Unterhaltung, anstatt sie zu eskalieren?

Fin kann bestimmte Nachrichten – wie „thank you for escalating this issue“ – als Lösungssignal interpretieren und die Unterhaltung schließen, anstatt sie zu eskalieren. Aktualisieren Sie Ihre Fin Guidance, um Fin explizit anzuweisen, wie mit Eskalationssprache umzugehen ist und sicherzustellen, dass Dankesnachrichten nicht als gelöst behandelt werden.

Fin Terminplanung und Betriebszeiten

Warum teilt Fin dem Kunden mit, dass er außerhalb der Arbeitszeiten kontaktiert hat?

Fin sendet eine Nachricht außerhalb der Arbeitszeiten, wenn eine Unterhaltung außerhalb Ihrer konfigurierten Bürozeiten gestartet wird. Überprüfen und passen Sie die Bürozeiten in Ihren Kontoeinstellungen an, um Ihren Betriebsplan widerzuspiegeln. Beachten Sie, dass Workflows nur die Standard-Bürozeiten verwenden – nicht die benutzerdefinierten Bürozeiten, die für einzelne Teams festgelegt sind.

Fin E-Mail-Antwortkonfiguration

Warum beantwortet Fin E-Mails nicht wie erwartet?

Fin beantwortet E-Mails möglicherweise aus folgenden Gründen nicht wie erwartet:

  • Test-E-Mails von einer E-Mail-Adresse senden, die nicht als Teammitglieds-E-Mail in Intercom eingerichtet ist. Stellen Sie sicher, dass Sie eine korrekt konfigurierte Testadresse verwenden.

  • Workflow-Zuweisungsregeln, die die Unterhaltung nach der ersten Antwort von Fin einem Teammitglied zuweisen. Überprüfen Sie Ihren Workflow, um sicherzustellen, dass Zuweisungsschritte nicht mit der E-Mail-Automatisierung von Fin kollidieren.

Warum antwortet Fin auf E-Mails, die es umgehen sollten?

Legacy Fin Profiles können mit neueren Bereitstellungsmethoden in Konflikt stehen, wodurch Fin auf E-Mails antwortet, die es umgehen sollte. Pausieren Sie alle aktiven Fin Profiles und setzen Sie Fin nur über Workflows oder Simple Deployment ein, um dies zu verhindern.


Fin AI Agent deaktivieren

Wie deaktiviere ich den Fin AI Agent?

Um den Fin AI Agent zu deaktivieren, gehen Sie zur Fin AI Agent Deploy-Seite für den Kanal, in dem Sie Fin deaktivieren möchten, und schalten Sie ihn aus. Befolgen Sie diese Schritte, um sicherzustellen, dass Fin vollständig deaktiviert ist:

  1. Gehen Sie zur Fin AI Agent Deploy-Seite und deaktivieren Sie Fin für den entsprechenden Kanal. Die grünen Punkte neben den Einstellungen für 'Chat' und 'Email' sollten beim Deaktivieren gelb werden.

  2. Entfernen Sie Fin aus allen aktiven Workflows.

  3. Deaktivieren Sie alle aktiven Profiles oder Workflows, bei denen Fin aktiviert ist — Fin kann weiterhin mit Kunden über aktive Workflows interagieren, auch wenn die Hauptkanäle pausiert sind.

  4. Überprüfen Sie alle Einsatzbereiche (Chat, E-Mail, Profiles, Workflows), um sicherzustellen, dass Fin nirgendwo aktiv ist.

Hinweis: Das Pausieren eines Kanals deaktiviert Fin nicht vollständig. Wenn Fin in einem Workflow oder Profile noch aktiv ist, kann es weiterhin mit Kunden interagieren.

Hat dies deine Frage beantwortet?