Zum Hauptinhalt springen

Fin Messenger: HubSpot Einrichtung

Erfahren Sie, wie Sie Fin Messenger mit HubSpot einrichten, um Website-Anfragen zu bearbeiten und komplexe Probleme nahtlos an Ihre HubSpot inbox weiterzuleiten.

Diese Anleitung behandelt die Einrichtung von Fin Messenger mit HubSpot Übergabe. Kunden chatten über den Fin Messenger auf Ihrer Website mit Fin; wenn Fin das Problem nicht lösen kann, wird es entweder an Ihre HubSpot Agentenwarteschlange weitergeleitet oder ein neues HubSpot ticket mit dem vollständigen Gesprächsprotokoll erstellt.


Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie Folgendes haben:

  • HubSpot über OAuth verbunden: Wenn Sie noch nicht verbunden sind, gehen Sie zu Connect in der Hauptnavigation, um Fin den Zugriff auf HubSpot zu autorisieren – überspringen Sie diesen Schritt, wenn Sie bereits verbunden sind.

  • Website-Zugang: Zugriff auf Ihren Website- oder App-Code, um den Fin Messenger-Snippet zu installieren.

  • HubSpot-Berechtigungen: Admin-Zugriff auf Ihr HubSpot-Konto, um einen inbox-Kanal hinzuzufügen.

Tipp: Erstellen Sie einen dedizierten Benutzer – z. B. „Fin AI“ – anstatt ein persönliches Konto zu verwenden. So bleibt die ticket-Zugehörigkeit von Fin getrennt von den Warteschlangen Ihrer Teammitglieder und die Integration ist leichter zu verwalten, falls Sie sie pausieren oder widerrufen müssen.


Teil 1: Verbindung zu HubSpot herstellen

Gehen Sie zu Connect in der Hauptnavigation, um die Verbindung zu HubSpot herzustellen. Die Verbindung wird für HubSpot Tickets und Fin Messenger gemeinsam genutzt – wenn Sie bereits für HubSpot Tickets verbunden sind, überspringen Sie diesen Schritt.

Mit HubSpot verbinden

Verbinden Sie Ihr HubSpot-Konto, um Fin Zugriff auf Gespräche zu geben und KI-gestützten Support zu ermöglichen.

  • Klicken Sie auf die Schaltfläche „Connect“.

    Connect-Button zu HubSpot im Fin-Arbeitsbereich
  • Sie werden zur Authentifizierung zu HubSpot weitergeleitet.

  • Nach der Authentifizierung werden Sie zurück zu Fin weitergeleitet, um fortzufahren.

  • Mit der Verbindung von Fin zu HubSpot stimmen Sie unseren Drittanbieter-Plattformbedingungen zu.

Auf der Deploy › Fin Messenger-Seite sehen Sie die Schritte zur Einrichtung des Fin Messenger.

Deploy › Fin Messenger-Seite mit vollständiger Übersicht der Einrichtungsschritte

Installieren Sie den Fin Messenger-Kanal in Ihrem HubSpot-Portal.

Verbinden Sie den Fin Messenger-Kanal in Ihrem HubSpot helpdesk, damit Fin eingehende Fragen beantworten kann.

  1. Gehen Sie zu Ihrem HubSpot-Portal.

  2. Navigieren Sie zu CRM → Inbox → Einstellungen.

    HubSpot CRM Inbox-Einstellungsseite mit Option zur Kanalverbindung

  3. Klicken Sie auf Connect a channel.

  4. Wählen Sie Ihr Fin Messenger-Konto aus der Liste, um Fin Messenger-Gespräche in Ihrer HubSpot inbox zu empfangen.

    Fin Messenger-Kontoauswahl in der HubSpot-Kanalliste

  5. Klicken Sie auf Connect with Fin messenger, um die Einrichtung fortzusetzen.

    Connect with Fin Messenger-Button in der HubSpot-Kanal-Einrichtung

  6. Klicken Sie auf Connect, um die Einrichtung abzuschließen und Ihren Fin Messenger-Kanal mit Ihrem HubSpot Helpdesk zu verbinden.

    Connect-Button zum Abschluss der Fin Messenger-Verbindung zu HubSpot
  7. Optional können Sie Auto assign conversations aktivieren, um eingehende Gespräche automatisch an einen Teamkollegen weiterzuleiten.

    Auto assign conversations-Schalter in den HubSpot Fin Messenger-Kanaleinstellungen
  8. Nach der Installation kehren Sie zu Ihrem Fin-Arbeitsbereich zurück und klicken auf Refresh status, um fortzufahren.

Tipp: Testen Sie den Messenger in einer QA-Umgebung, bevor Sie ihn in der Produktion installieren.

Daten von HubSpot synchronisieren

Dieser Schritt ist optional, Sie müssen zuerst die Verbindung zu HubSpot herstellen, um Daten zu synchronisieren. Verwenden Sie diese Daten, um Ihre Inhalte auf verschiedene Zielgruppen auszurichten, tickets automatisch zu klassifizieren und Verzweigungen in workflows zu erstellen.

Konfigurieren Sie Ihre Verbindung zu HubSpot

Klicken Sie auf der Deploy › Fin Messenger-Seite auf Configure your connection to HubSpot. Es öffnet sich eine Einstellungsseite mit zwei Aufgaben: Wählen Sie den HubSpot-Benutzer aus, den Fin repräsentiert (verwenden Sie ein dediziertes Konto – z. B. ‚Fin AI‘ – statt eines persönlichen), und wählen Sie dann Ihre Pipeline aus und ordnen Sie deren Phasen den Fin-Zuständen zu.

Deploy › Fin Messenger-Seite mit dem Schritt Configure your connection to HubSpot

Fin-Zustand

Was es bedeutet

Standard-Support-Pipeline-Phase

Neues ticket

Die Phase, die Fin überwacht, um neue tickets zu erfassen

Neu

Warten auf Kunde

Fin verschiebt das ticket hierhin, während auf eine Kundenantwort gewartet wird

Warten auf Kontakt

Warten auf Ihr Team

Fin verschiebt das ticket hierhin, wenn es an einen menschlichen Teamkollegen übergeben wird

Warten auf uns

Gelöst

Fin verschiebt das ticket hierhin, wenn es ein Gespräch abschließt

Geschlossen

Hinweis: Um Ihre Pipeline- und Stadiennamen in HubSpot zu finden, gehen Sie zu Einstellungen > Datenverwaltung > Objekte > Tickets > Pipelines und klicken Sie auf Ihren Pipeline-Namen. Diese Konfiguration wird für alle Ihre HubSpot-Kanäle geteilt – wenn Sie sie bereits für HubSpot Tickets eingerichtet haben, können Sie diesen Schritt überspringen. Um diese Konfiguration zukünftig zu aktualisieren, gehen Sie zu Einstellungen > Kanäle > Fin Messenger.

Fin für HubSpot Messenger Einstellungsseite konfigurieren mit dem Fin HubSpot Agenten-Auswahlfeld und Abschnitt zur Zuordnung der Pipeline-Stadien


Teil 2: Erstellen Sie Ihren workflow

Passen Sie an, wie Fin Kunden begrüßt und antwortet oder übergibt, wenn er nicht helfen kann. Klicken Sie auf der Deploy › Fin Messenger-Seite in Ihrem Fin-Arbeitsbereich auf Workflow hinzufügen, um das Erlebnis anzupassen und live zu schalten.

Ein workflow mit dem Auslöser wenn ein Kunde ein neues Gespräch im Fin Messenger öffnet wird automatisch mit einem Standardablauf gefüllt. Der Standardworkflow beinhaltet:

  • Ein Fin-Triage-Schritt – Fin versucht, die Frage des Kunden mit Ihrer knowledge base und Inhalten zu lösen

  • Ein Lösungsweg – wenn Fin die Anfrage löst, wird das Gespräch geschlossen

  • Ein Übergabepfad – wenn Fin es nicht lösen kann, wird das Gespräch an Ihre HubSpot-Agentenwarteschlange eskaliert oder ein neues HubSpot ticket mit dem vollständigen Transkript erstellt

Innerhalb des workflows können Sie anpassen:

  • Die Begrüßungsnachricht, die Fin sendet, wenn ein Kunde ein Gespräch öffnet

  • Die Übergabebedingungen – wann Fin an einen Teamkollegen weiterleitet vs. ein ticket erstellt und an welchen HubSpot inbox oder welche Warteschlange weitergeleitet wird. Es gibt zwei Übergabemodi zur Auswahl: Übergabe an Agenten in HubSpot (wenn der Fin Messenger-Kanal in Ihrem HubSpot inbox installiert ist) oder Übergabe an ticket in HubSpot (wenn nicht).

Vier Fin HubSpot workflows, angezeigt in den HubSpot Automatisierungseinstellungen


Teil 3: Installieren Sie den Fin Messenger

Installieren Sie Fin Messenger für das Web

Für die Web-Installation:

  • Wählen Sie Ihre Installationsmethode (Code-Snippet, React, Angular, Vue, Ember, Shopify)

  • Folgen Sie den methodenspezifischen Anweisungen – kopieren Sie das NPM-Paket/Code-Snippet und fügen Sie es vor dem Tag auf jeder Seite ein, auf der der Messenger erscheinen soll

  • Verwenden Sie Installation prüfen, um zu überprüfen, ob es funktioniert

Installieren Sie Fin Messenger für Mobilgeräte

Für die mobile Installation:

  • Wählen Sie Ihre Plattform (iOS, Android oder React Native)

  • Initialisieren Sie Fin in Ihrem Code und folgen Sie den plattformspezifischen Schritten

  • Generieren Sie Ihren iOS SDK API-Schlüssel, wenn Sie iOS verwenden

  • Verwenden Sie Installation prüfen, um zu überprüfen

  • Optional: Push-Benachrichtigungen einrichten


Teil 4: Testen

Testen Sie die Integration

  • Verwenden Sie das Fin Test-Dashboard: Navigieren Sie zum Test-Tab in der Fin-Seitenleiste, um die Antwortqualität zu prüfen und Eskalationspfade zu verifizieren, ohne Ihre Live-Seite zu beeinflussen.

  • Steuern Sie, wo der Messenger angezeigt wird: Der Fin Messenger erscheint nur dort, wo Sie das Code-Snippet installieren. Für Tests installieren Sie es auf einer Staging-URL oder verwenden URL-Regeln im Deploy-Bereich, um es auf eine bestimmte Testseite (z. B. yoursite.com/test) zu beschränken, bevor Sie es für alle Besucher freigeben.

Teil 5: Gehen Sie mit Fin Messenger live

Wenn Sie bereit sind, klicken Sie im Deploy-Ablauf auf Live gehen. Dadurch werden alle vier HubSpot workflows aktiviert und Fin beginnt sofort, Gespräche basierend auf dem konfigurierten workflow und der knowledge base zu bearbeiten. Ihre Eskalationseinstellungen hängen davon ab, ob Sie den Fin Messenger-Kanal in Ihrem HubSpot inbox installiert haben.

Übergabe an Agenten in HubSpot

Verwenden Sie diese Option, wenn der Fin Messenger-Kanal in Ihrem HubSpot inbox installiert ist. Wenn Fin ein Gespräch nicht lösen kann, aktualisiert es das ticket auf Ihre zugeordnete Warten-auf-Team-Phase und weist Fin ab, damit ein Teamkollege es in HubSpot übernehmen kann.

Übergabe an ticket in HubSpot

Verwenden Sie diese Option, wenn der Fin Messenger-Kanal nicht in Ihrem HubSpot inbox installiert ist. Fin bearbeitet das gesamte Gespräch in Ihrem workspace ohne Synchronisierung mit HubSpot. Bei Eskalation wird ein neues HubSpot ticket mit dem vollständigen Transkript erstellt.

Wichtig: Wenn Sie die Benutzerverifizierung (OTP) bei der Übergabe an ticket deaktivieren, werden angemeldete users vor der Erstellung eines HubSpot tickets nicht mehr verifiziert. Ohne JSON Web Token (JWT)-Identitätsprüfung könnte ein Kunde in HubSpot eine andere Person imitieren – dies ist ein ernstes Sicherheitsrisiko. Deaktivieren Sie OTP nur, wenn Sie Ihrer bestehenden Authentifizierung voll vertrauen. Erfahren Sie mehr über die Verifizierung der Kundenidentität mit dem E-Mail-OTP-Workflow-Schritt.

Benutzerverifizierung

Wenn Sie Übergabe an ticket in HubSpot verwenden, können Sie verlangen, dass users ihre E-Mail-Adresse verifizieren, bevor ein ticket erstellt wird. Dies fügt eine zusätzliche Identitätsbestätigung beim Eskalationszeitpunkt hinzu.

  • Durchsetzung der E-Mail-Verifizierung vor Übergabe an ticket: Wenn aktiviert, müssen users ihre E-Mail erfolgreich verifizieren, bevor ein HubSpot ticket in ihrem Namen erstellt wird.

  • OTP erforderlich, wenn Messenger nicht sicher ist: Wenn der Messenger nicht mit JSON Web Token (JWT)-Identitätsprüfung gesichert ist, müssen users ihre E-Mail-Adresse mit einem Einmalpasswort (OTP) verifizieren, bevor die Übergabe fortgesetzt wird. Dies verhindert, dass nicht verifizierte users Tickets unter einer anderen Identität erstellen.

Tipp: Die sicherste Einrichtung ist die Implementierung der JWT-Identitätsprüfung in Ihrem Messenger. OTP ist eine Rückfalloption für unsichere Messenger-Installationen – kein Ersatz für eine ordnungsgemäße Identitätsprüfung.

Hinweis: Während der Messenger-Übergabe wird, falls der Kunde noch nicht als Kontakt in HubSpot existiert, automatisch ein neuer Kontakt mit den während des Gesprächs gesammelten Informationen erstellt.


Zielgruppen- & Inhaltsausrichtung

Wenn Sie mehrere Standorte oder Marken bedienen, richten Sie separate Audiences in Fin für jede ein und fügen Sie die relevanten Snippets und Web-Synchronisationen jeder Audience hinzu.

Wie Zielgruppen kombiniert werden

  • Zielgruppen haben keine Prioritätsreihenfolge, und eine spezifischere Zielgruppe überschreibt keine allgemeinere. Fin kann ein Inhaltselement für jeden Besucher verwenden, der mindestens einer der zugeordneten Zielgruppen entspricht.

  • Zum Beispiel, wenn die Zielgruppe eines allgemeinen Snippets "URL enthält example.com" ist, passt es auch zu Besuchern auf example.com/london, sodass Fin es zusammen mit Ihrem London-spezifischen Inhalt verwenden kann.

  • Um allgemeinen Inhalt von standortspezifischen Seiten fernzuhalten, fügen Sie der allgemeinen Zielgruppe eine Bedingung hinzu, die diese ausschließt, wie z. B. "URL enthält nicht /london".

Wichtig: Beim Aktualisieren der Zielgruppen von Inhalten nach dem Synchronisieren löschen Sie den Inhalt und synchronisieren Sie erneut. Das einfache Aktualisieren der Zielgruppe bei bereits synchronisiertem Inhalt wird möglicherweise nicht korrekt angewendet. Dies ist ein bekanntes Verhalten – keine dauerhafte Einschränkung – prüfen Sie auf Updates.

Hinweis: Fin kann Inhalte direkt von Ihren Website-URLs synchronisieren. Wenn Sie Inhalte auf einer synchronisierten Seite aktualisieren, müssen Sie diese erneut synchronisieren, damit Fin die Änderungen erkennt – Fin erkennt Seitenaktualisierungen nicht automatisch.


Deaktivieren vs. widerrufen

Wenn Sie die HubSpot-Integration pausieren oder entfernen müssen, haben Sie zwei Optionen, und es ist wichtig, den Unterschied zu verstehen.

  • Deaktivieren pausiert die Integration, ohne Ihre Einrichtung zu zerstören. Alle von Fin erstellten HubSpot workflows sind deaktiviert, und Gespräche werden nicht mehr über Fin geleitet. Ihre Konfiguration, OAuth-Verbindung und HubSpot-Eigenschaften bleiben erhalten. Sie können jederzeit reaktivieren und dort weitermachen, wo Sie aufgehört haben.

  • Widerrufen ist ein vollständiger Abbau. Die OAuth-Verbindung wird zerstört, alle 4 von Fin erstellten HubSpot workflows werden dauerhaft gelöscht, und Ihre Fin-Konfiguration wird entfernt. Sie müssen den gesamten Einrichtungsprozess erneut durchlaufen, wenn Sie die Verbindung wiederherstellen möchten.


Übernahme eines Gesprächs von Fin

Wenn Sie eingreifen müssen, während Fin aktiv ein Messenger-Gespräch führt, weisen Sie Fin nicht manuell ab, bevor Sie antworten. Wenn Sie Fin zuerst abweisen, verarbeitet es keine eingehenden Nachrichten mehr, da es nicht mehr zugewiesen ist.

Antworten Sie stattdessen direkt in HubSpot, ohne die Zuweisung zu ändern. Fin erkennt, dass ein Teammitglied geantwortet hat, und zieht sich automatisch zurück – es sendet keine weiteren Antworten und entfernt die Fin-Tags, um die Übergabe widerzuspiegeln.


FAQs

Kann ich verhindern, dass der Fin Messenger beim Zurückkehren eines Besuchers automatisch geöffnet wird?

Derzeit gibt es keine native Einstellung, um zu verhindern, dass Fin beim Zurückkehren eines Besuchers die Seite erneut öffnet. Der Besucher müsste das Messenger-Symbol manuell anklicken, um es wieder zu öffnen. Kontaktieren Sie Ihr Fin-Kundenteam, um die Nachfrage für diese Funktion zu verfolgen.

Kann ich die Nachricht „Ihr Gespräch wurde übertragen“ anpassen?

Die Bestätigungsnachricht zur Übertragung („Ihr Gespräch wurde an ein support ticket übertragen. Sie erhalten Updates per E-Mail.“) ist eine Systemnachricht und kann nicht bearbeitet werden.

Fin Messenger wird auf der Website nicht angezeigt

Bestätigen Sie, dass der Messenger-Code-Snippet korrekt auf Ihrer Website installiert ist, und prüfen Sie, ob der Messenger in Ihren Fin-Arbeitsbereichs-Deploy-Einstellungen auf Live gesetzt ist. Es gibt ein standardmäßiges „Brauchen Sie Hilfe?“ Pop-out, das nach 6 Sekunden erscheint. Dieses Verhalten kann derzeit nicht vollständig deaktiviert werden.

Doppelte tickets werden in HubSpot erstellt

Doppelte tickets werden erstellt, wenn beide Übergabemodi gleichzeitig aktiv sind. So beheben Sie es je nach Einrichtung: Wenn Sie Hand-off to agent in HubSpot verwenden: Entfernen Sie die Fin Messenger-App aus Ihrem HubSpot inbox (gehen Sie zu Einstellungen → Inboxes in HubSpot). Die gleichzeitige Installation des Fin Messenger-Kanals in HubSpot führt dazu, dass jede Eskalation zwei tickets erzeugt. Wenn Sie Hand-off to ticket in HubSpot verwenden: Installieren Sie den Fin Messenger-Kanal nicht gleichzeitig in Ihrem HubSpot inbox. Der Fin Messenger-Kanal erstellt bereits ein ticket bei der Übergabe – das Hinzufügen eines Hand-off to ticket in HubSpot-Schritts dupliziert dies. Es sollte immer nur eine Übergabemethode gleichzeitig aktiv sein.

Fin gibt für einen bestimmten Standort falsche Antworten

Überprüfen Sie Folgendes:

  • Bestätigen Sie, dass Ihre Audiences korrekt konfiguriert sind. Audiences haben keine Prioritätsreihenfolge. Wenn eine allgemeine Audience auch auf die Seiten des Standorts passt, fügen Sie eine Bedingung hinzu, die diese Seiten ausschließt (z. B. "URL enthält nicht /london").

  • Bestätigen Sie, dass die relevanten Snippets und Web-Synchronisationen der richtigen Audience zugeordnet sind, nicht der allgemeinen.

  • Verwenden Sie die Test-Funktion von Fin, um einen Besucher von einer bestimmten URL zu simulieren und zu überprüfen, welche Inhalte Fin abruft.

Hat dies deine Frage beantwortet?