Jitterbit Lead Ops Agent
Übersicht
Jitterbit stellt den Lead Ops Agent Kunden über den Jitterbit Marketplace zur Verfügung. Dieser Agent automatisiert die Anreicherung von Leads, indem er HubSpot-Formularübermittlungen mit Salesforce und ZoomInfo verbindet, wodurch Organisationen genaue und vollständige Lead-Daten ohne manuellen Aufwand aufrechterhalten können.
Der Agent ruft Formularübermittlungen von HubSpot ab, überprüft, ob übereinstimmende Lead-Datensätze in Salesforce vorhanden sind, und ergänzt diese Datensätze mit zusätzlichen Kontakt- und Unternehmensdaten von ZoomInfo. Aktualisierte Daten werden in Salesforce zurückgeschrieben, und Slack-Benachrichtigungen halten Ihr Team über den Ausführungsstatus und Fehler informiert.
Der Agent führt die folgenden Aufgaben aus:
- Ruft verfügbare Formulare und Übermittlungsdaten von HubSpot ab.
- Fragt Salesforce ab, um zu überprüfen, ob ein übereinstimmender Lead-Datensatz mit der Email-Adresse der Übermittlung vorhanden ist.
- Aktualisiert den bestehenden Salesforce-Lead-Datensatz mit Daten aus der HubSpot-Übermittlung.
- Authentifiziert sich bei ZoomInfo, um ein JWT-Token für Anreicherungs-API-Aufrufe zu erhalten.
- Ergänzt den Salesforce-Lead-Datensatz mit zusätzlichen Kontakt- und Unternehmensdaten von ZoomInfo.
- Schreibt die angereicherten Lead-Daten zurück in Salesforce.
- Sendet Slack-Benachrichtigungen nach erfolgreicher Ausführung, einschließlich des Operationnamens, des Ausführungszeitstempels und des Integrationsstatus.
Dieses Dokument erklärt, wie man diesen KI-Agenten einrichtet und betreibt. Es behandelt die Architektur und Voraussetzungen sowie die Schritte zur Installation, Konfiguration und zum Betrieb des KI-Agenten.
Architektur des KI-Agenten
Dieser KI-Agent verbindet HubSpot, Salesforce und ZoomInfo, um Lead-Datensätze zu sammeln, zu aktualisieren und anzureichern. Ein typischer Workflow folgt diesen Schritten:
- Die Operationen des Agents laufen stündlich nach einem Zeitplan. Der Agent ruft alle verfügbaren Formulare von HubSpot ab und holt dann die Übermittlungsdatensätze für jedes Formular.
- Für jede Übermittlung fragt der Agent Salesforce mit der Email-Adresse der Übermittlung ab, um zu überprüfen, ob ein übereinstimmender Lead-Datensatz vorhanden ist.
- Wenn ein übereinstimmender Lead vorhanden ist, mappt der Agent die HubSpot-Übermittlungsfelder auf die Salesforce-Lead-Felder und führt eine Upsert-Operation durch.
- Der Agent authentifiziert sich bei ZoomInfo, um ein JWT-Token zu erhalten, und sendet dann die aktualisierten Salesforce-Lead-Daten an die ZoomInfo Enrichment API, um zusätzliche Kontakt- und Unternehmensdaten abzurufen.
- Der Agent schreibt die angereicherten Daten zurück in Salesforce und aktualisiert den Lead-Datensatz mit zusätzlichen Kontakt- und Unternehmensinformationen von ZoomInfo.
- Nach erfolgreicher Ausführung sendet der Agent eine Slack-Benachrichtigung mit dem Operationnamen, dem Ausführungszeitstempel und dem Integrationsstatus.
- Jeder Schritt protokolliert seine Eingabe- und Ausgabe-Payload, um die Fehlersuche und die Prüfung zu unterstützen.
Workflow-Diagramm
Das folgende Diagramm zeigt, wie der Agent Lead-Daten von HubSpot über Salesforce und ZoomInfo überträgt.
Die beiden aufeinanderfolgenden API-Aufrufe von HubSpot (Abrufen von Formularen und dann von Einreichungen) werden zur Klarheit als ein einzelner Austausch dargestellt. Die Authentifizierungs- und Anreicherungsaufrufe von ZoomInfo werden als separate Knoten angezeigt, da sie unterschiedliche API-Endpunkte verwenden.
Jitterbit Lead Ops
Agent" } HS[fab:fa-hubspot
HubSpot] SF[fab:fa-salesforce
Salesforce] ZIA[ZoomInfo Auth REST call] ZIE@{ shape: hex, label: "ZoomInfo Enrichment API" } SLK[fab:fa-slack
Slack] JSP -->|1. Get form submissions| HS HS -->|2. Submission data| JSP JSP -->|3. Query lead by email| SF SF -->|4. Lead record| JSP JSP -->|5. Upsert lead| SF JSP -->|6. Auth request| ZIA ZIA -->|7. JWT token| JSP JSP -->|8. Enrichment request| ZIE ZIE -->|9. Augmented lead data| JSP JSP -->|10. Update lead| SF JSP -->|11. Success notification| SLK
Voraussetzungen
Sie benötigen die folgenden Komponenten, um diesen KI-Agenten zu verwenden.
Harmony-Komponenten
Sie müssen über eine Jitterbit Harmony-Lizenz mit Zugriff auf die folgenden Komponenten verfügen:
- Jitterbit Studio
- Jitterbit API Manager
- Lead Ops-Agent, der als Lizenz-Add-On erworben wurde
Unterstützte Endpunkte
Der KI-Agent verbindet sich mit den folgenden externen Diensten. Sie können andere Systeme unterstützen, indem Sie die Endpunktkonfigurationen und Workflows des Projekts anpassen.
HubSpot
Der Agent verwendet die HubSpot API, um Formulardefinitionen und Einreichungsdatensätze abzurufen. Sie müssen über ein HubSpot-Konto mit API-Zugriff und einem gültigen API-Schlüssel verfügen.
Salesforce
Der Agent verwendet die Salesforce REST API, um Lead-Datensätze abzufragen und zu aktualisieren. Sie müssen über ein Salesforce-Konto mit Anmeldeinformationen verfügen, die die Berechtigung zum Lesen und Schreiben von Lead-Objekten haben.
ZoomInfo
Der Agent verwendet die ZoomInfo API, um Lead-Daten anzureichern. Sie müssen über ein ZoomInfo-Konto mit einer Client-ID und einem Client-Geheimnis verfügen, die die Berechtigung zum Aufrufen der Anreicherungs-API haben.
Benachrichtigungsdienst
Der Agent verwendet Slack, um Erfolgs- und Fehlermeldungen zu senden. Sie müssen eine Slack Webhook-URL für den Kanal konfiguriert haben, in dem die Benachrichtigungen gesendet werden sollen. Sie können Slack durch einen anderen Benachrichtigungsdienst ersetzen, indem Sie die Endpunktkonfigurationen des Projekts anpassen und die Workflows an das Schema anpassen, das von Ihrem gewählten Dienst benötigt wird.
Installation, Konfiguration und Betrieb
Befolgen Sie diese Schritte, um diesen KI-Agenten zu installieren, zu konfigurieren und zu betreiben:
- Projekt herunterladen und installieren
- Projektvariablen konfigurieren
- Verbindungen testen
- Projekt bereitstellen
- Projekt-Workflows überprüfen
- Projekt-Workflows auslösen
Für Anleitungen zur Fehlersuche siehe Fehlerbehebung.
Projekt herunterladen und installieren
Befolgen Sie diese Schritte, um das Studio-Projekt für den KI-Agenten herunterzuladen und zu installieren:
-
Melden Sie sich im Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie den Marktplatz.
-
Suchen Sie den KI-Agenten mit dem Namen Jitterbit Lead Ops Agent. Um den Agenten zu finden, verwenden Sie die Suchleiste oder wählen Sie im Bereich Filter unter Typ KI-Agent aus, um die Anzeige auf KI-Agenten zu beschränken.
-
Klicken Sie auf den Link Dokumentation des KI-Agenten, um dessen Dokumentation in einem separaten Tab zu öffnen. Halten Sie den Tab zur Referenz geöffnet.
-
Klicken Sie auf Projekt starten, um einen zweistufigen Konfigurationsdialog zu öffnen, um den KI-Agenten als Studio-Projekt zu importieren.
Hinweis
Wenn Sie den KI-Agenten noch nicht gekauft haben, wird stattdessen Diesen Agenten erhalten angezeigt. Klicken Sie darauf, um einen Informationsdialog zu öffnen, und klicken Sie dann auf Absenden, damit sich ein Vertreter mit Ihnen in Verbindung setzt, um den KI-Agenten zu kaufen.
-
Wählen Sie im Konfigurationsschritt 2, Neues Projekt erstellen, eine Umgebung aus, in der das Studio-Projekt erstellt werden soll, und klicken Sie dann auf Projekt erstellen.
-
Ein Fortschrittsdialog wird angezeigt. Sobald er anzeigt, dass das Projekt erstellt wurde, verwenden Sie den Dialoglink Gehe zu Studio oder öffnen Sie das Projekt direkt von der Studio-Seite Projekte.
Projektvariablen konfigurieren
Im im Marktplatz installierten Studio-Projekt müssen Sie Werte für die folgenden Projektvariablen festlegen.
Um Projektvariablen zu konfigurieren, verwenden Sie das Projekt-Toolbar Aktionsmenü, um Projektvariablen auszuwählen und eine Schublade am unteren Rand der Seite zu öffnen, in der Sie Werte überprüfen und festlegen können.
HubSpot
| Variablenname | Beschreibung |
|---|---|
Hubspot_API_Key |
API-Schlüssel, der zur Authentifizierung von HubSpot-API-Aufrufen verwendet wird. |
Salesforce
| Variablenname | Beschreibung |
|---|---|
Salesforce_Username |
Benutzername für das Salesforce-Konto, das von der Integration verwendet wird. |
Salesforce_Password |
Passwort für das Salesforce-Konto, das von der Integration verwendet wird. |
ZoomInfo
| Variablenname | Beschreibung |
|---|---|
ZoomInfo_Client_ID |
Client-ID, die zur Authentifizierung von ZoomInfo-API-Aufrufen verwendet wird. |
ZoomInfo_Client_Secret |
Client-Geheimnis, das zur Authentifizierung von ZoomInfo-API-Aufrufen verwendet wird. |
Slack
| Variablenname | Beschreibung |
|---|---|
Slack_Webhook_URL |
Webhook-URL für den Slack-Kanal, in dem Benachrichtigungen gesendet werden. |
Testverbindungen
Testen Sie die Endpunktkonfigurationen, um die Konnektivität mit den konfigurierten Projektvariablenwerten zu überprüfen.
Um Verbindungen zu testen, gehen Sie zum Projektendpunkte und -connectoren Tab der Design-Komponentenpalette, fahren Sie mit der Maus über jeden Endpunkt und klicken Sie auf Testen.
Projekt bereitstellen
Projekt bereitstellen das Studio-Projekt.
Um das Projekt bereitzustellen, verwenden Sie das Projekt-Toolbar Aktionsmenü, um Bereitstellen auszuwählen.
Projekt-Workflows überprüfen
Jeder Workflow erfüllt eine spezifische Funktion im Datenfluss zwischen HubSpot, ZoomInfo und Salesforce.
| Workflow | Beschreibung |
|---|---|
| HubSpot Forms Data Extraction | Ruft verfügbare Formulare von HubSpot ab. |
| Form Submission Processing | Holt und transformiert die Daten der Formularübermittlung. |
| Salesforce Lead Lookup | Abfrage von Salesforce nach einem passenden Lead anhand der Email-Adresse. |
| Salesforce Lead Update | Fügt die HubSpot-Übermittlungsdaten in den passenden Salesforce-Lead ein. |
| ZoomInfo Authentication | Authentifiziert sich bei ZoomInfo, um ein JWT-Token abzurufen. |
| Token Extraction | Extrahiert das JWT-Token aus der Antwort der ZoomInfo-Authentifizierung. |
| Data Enrichment via ZoomInfo | Sendet Lead-Daten an ZoomInfo und ruft angereicherte Informationen ab. |
| Post-Enrichment Salesforce Update | Schreibt die angereicherten ZoomInfo-Daten zurück in Salesforce. |
| Success Slack Notification | Sendet eine Erfolgsbenachrichtigung an den konfigurierten Slack-Kanal. |
HubSpot Forms Data Extraction
Dieser Workflow initialisiert die Integration und ruft alle verfügbaren Formulare von HubSpot ab. Die Operationen im Workflow sind so konfiguriert, dass sie stündlich mit Betriebsplänen ausgeführt werden. Der Workflow filtert und bereitet die Formulardaten für die Verwendung im folgenden Workflow zur Verarbeitung von Übermittlungen vor.
Form Submission Processing
Dieser Workflow ruft die Übermittlungsdatensätze für jedes im vorherigen Workflow erhaltene Formular ab. Der Workflow konvertiert die HubSpot-Übermittlungsdaten in das erforderliche Integrationsformat und speichert die transformierte Nutzlast zur Verwendung im Salesforce-Lead-Abfrage-Workflow.
Salesforce Lead Lookup
Dieser Workflow fragt das Salesforce-Objekt Lead unter Verwendung der Email-Adresse der Übermittlung als Primärschlüssel ab, um zu überprüfen, ob ein passender Lead-Datensatz vorhanden ist. Der Workflow speichert die Abfrageergebnisse zur Verwendung im nachfolgenden Lead-Update-Workflow.
Salesforce Lead Update
Dieser Workflow ordnet die HubSpot-Übermittlungsfelder den Salesforce-Lead-Feldern zu und führt eine Upsert-Operation auf dem übereinstimmenden Lead-Datensatz durch. Der Workflow speichert die Salesforce-Antwort zur Verwendung im ZoomInfo-Anreicherungs-Workflow.
ZoomInfo Authentication
Dieser Workflow authentifiziert sich bei ZoomInfo, um ein JWT-Token zu erhalten, das für Anreicherungs-API-Aufrufe erforderlich ist. Der Workflow sendet eine Authentifizierungsanfrage an die ZoomInfo Auth API und speichert die Antwort zur Verwendung im Token-Extraktions-Workflow.
Token Extraction
Dieser Workflow liest die ZoomInfo-Authentifizierungsantwort und extrahiert das JWT-Token. Der Workflow speichert das Token in globalen Variablen zur Verwendung im Datenanreicherungs-Workflow.
Data Enrichment via ZoomInfo
Dieser Workflow liest die aktualisierten Salesforce-Lead-Daten und sendet eine Anreicherungsanfrage an die ZoomInfo Enrichment API. Der Workflow speichert die angereicherte Antwort zur Verwendung im Salesforce-Update-Workflow nach der Anreicherung.
Post-Enrichment Salesforce Update
Dieser Workflow liest die ZoomInfo-Anreicherungsantwort, ordnet die angereicherten Felder dem Salesforce-Lead-Objekt zu und aktualisiert den Lead-Datensatz in Salesforce mit den angereicherten Daten.
Success Slack Notification
Dieser Workflow sendet eine Erfolgsmeldung an den konfigurierten Slack-Kanal, nachdem alle Workflows erfolgreich abgeschlossen wurden. Die Benachrichtigung enthält den Namen der Operation, den Zeitstempel der Ausführung und den Integrationsstatus.
Projekt-Workflows auslösen
Der Agent wird automatisch nach einem stündlichen Zeitplan ausgeführt. Sie können Workflows auch manuell auslösen.
Um eine Operation manuell auszuführen, fahren Sie mit der Maus über den Namen der Operation im Studio und wählen Sie die Ausführen-Option.
Tipp
Um die Häufigkeit des Zeitplans zu ändern, öffnen Sie das Aktionsmenü des geplanten Vorgangs und wählen Sie Einstellungen > Zeitpläne.
Slack-Benachrichtigungen
Nach erfolgreicher Ausführung sendet der Agent eine Slack-Benachrichtigung an den im Slack_Webhook_URL Projektvariable konfigurierten Kanal.
Jede Benachrichtigung enthält die folgenden Informationen:
- Name der Operation
- Ausführungszeitstempel
- Integrationsstatus
Fehlersuche
Wenn Sie auf Probleme stoßen, überprüfen Sie die folgenden Ressourcen für detaillierte Informationen zur Fehlersuche:
Für zusätzliche Unterstützung kontaktieren Sie Jitterbit-Support.