HubSpot-Integration: Der Nodale-Agent synchronisiert Leads

Diese Seite richtet sich an den Admin eines Nodale-Workspace, der HubSpot verbindet. Sie beschreibt, was Nodale von HubSpot anfragt, was Nodale dort schreibt und was es zurückliest.

Die Integration installieren

Sie müssen Admin Ihres Nodale-Workspace sein und ein HubSpot-Nutzer, der in Ihrem Portal Apps installieren darf. Andere Mitglieder des Workspace sehen die Verbindung, können sie aber nicht ändern.

1. Öffnen Sie in Nodale Settings, dann Workspace, dann Integrations, und wählen Sie die Karte HubSpot.
2. Klicken Sie auf Connect HubSpot. HubSpot öffnet seine Zustimmungsseite.
3. Wählen Sie das Portal, das verbunden werden soll, lesen Sie die Scopes (unten aufgeführt) und akzeptieren Sie sie.
4. HubSpot leitet Sie zurück zu Nodale, wo folgende Meldung steht: „HubSpot is connected. Your portal is shown below.“

Die Verbindungskarte zeigt danach das Portal, den Zeitpunkt der Verbindung und die letzte Synchronisierung. Ein Nodale-Workspace verbindet genau ein HubSpot-Portal.

Beim Verbinden legt Nodale in Ihrem Portal eine versteckte Unternehmenseigenschaft an, Nodale record ID (nodale_external_id), in einer Eigenschaftsgruppe namens Nodale. Damit findet Nodale die Unternehmen wieder, die es angelegt hat.

Die Scopes, die Nodale anfragt

HubSpot zeigt diese Scopes auf seiner Zustimmungsseite. Alle sind erforderlich.

Scope	Wofür Nodale ihn nutzt
oauth	Identifiziert das verbundene Portal.
crm.objects.contacts.read	Findet einen Kontakt anhand der E-Mail und liest die zugeordneten Eigenschaften.
crm.objects.contacts.write	Erstellt und aktualisiert Kontakte und verknüpft einen Kontakt mit seinem Unternehmen.
crm.objects.companies.read	Findet ein Unternehmen anhand der Domain oder seiner Verknüpfung mit dem Kontakt und liest seine zugeordneten Eigenschaften.
crm.objects.companies.write	Erstellt und aktualisiert Unternehmen.
crm.objects.deals.read	Listet Ihre Deal-Pipelines auf und findet die offenen Deals des Kontakts, um die Notiz anzuhängen.
crm.objects.deals.write	Wird mit den CRM-Scopes angefragt. Nodale erstellt und bearbeitet keinen Deal.
crm.schemas.contacts.read	Listet die Kontakteigenschaften auf, die Sie zuordnen können.
crm.schemas.contacts.write	Erstellt eine Kontakteigenschaft, wenn Sie sie aus Nodale heraus anfordern.
crm.schemas.companies.read	Listet die Unternehmenseigenschaften auf, die Sie zuordnen können.
crm.schemas.companies.write	Erstellt eine Unternehmenseigenschaft, wenn Sie sie anfordern, sowie die Eigenschaft Nodale record ID.
crm.schemas.deals.read	Wird mit den CRM-Scopes angefragt. Nodale ordnet keine Deal-Eigenschaft zu.
crm.schemas.deals.write	Wird mit den CRM-Scopes angefragt. Nodale erstellt keine Deal-Eigenschaft.
scheduler.meetings.meeting-link.read	Liest Ihre HubSpot-Meeting-Links, damit der Agent darin Termine buchen kann (siehe unten).

Kontakte und Unternehmen

Wann Nodale in HubSpot liest und schreibt

• Sobald der Besucher eine E-Mail angibt, liest Nodale den Kontakt und sein Unternehmen in HubSpot, damit der Agent weiß, was Ihr CRM bereits über ihn weiß. Beim Lesen wird nie etwas in HubSpot geschrieben.
• Nach jeder Konversation, sobald Nodale seine Zusammenfassung geschrieben hat, sendet es den Lead an HubSpot. Ein Lead wird gesendet, wenn er eine E-Mail hat, ob qualifiziert oder nicht.
• Leads aus der Zeit vor der Verbindung werden nicht gesendet.

Wie Nodale den Kontakt und das Unternehmen findet

• Der Kontakt: der, den Nodale bereits verknüpft hat, sonst der mit derselben E-Mail, sonst legt Nodale ihn an. Ein archivierter Kontakt bleibt unberührt.
• Das Unternehmen: das primäre Unternehmen des Kontakts in HubSpot, sonst das, das Nodale bereits verknüpft hat, sonst das Unternehmen mit derselben Domain, sonst legt Nodale es mit dieser Domain an und verknüpft den Kontakt damit. Für eine private E-Mail-Adresse (zum Beispiel Gmail) wird kein Unternehmen gesucht.

Die Felder zuordnen

Öffnen Sie den Tab Mapping der HubSpot-Seite. Jede Zeile sendet ein Nodale-Feld an eine HubSpot-Eigenschaft.

• Always sent here: Die E-Mail geht an email des Kontakts, die Unternehmensdomain an domain des Unternehmens. Sie füllen die Eigenschaft, wenn sie leer ist.
• Identity: Vorname, Nachname, Jobtitel.
• Context: UTM source, UTM medium, UTM campaign und verweisende Website, aus dem ersten Besuch des Leads.
• Qualification: die Elemente des Qualifizierungs-Frameworks Ihres Agenten.
• Custom: die benutzerdefinierten Felder Ihres Workspace, am Kontakt oder am Unternehmen.

Beim ersten Mal schlägt Nodale eine Zuordnung vor: Identitäts- und Kontextfelder, verbunden mit gleichnamigen HubSpot-Eigenschaften. Bestätigen Sie sie oder beginnen Sie leer.

Änderungen bleiben ein Entwurf, bis Sie auf Validate klicken. Das Entfernen einer Zuordnung löscht weder ein Nodale-Feld noch eine HubSpot-Eigenschaft. Ein fehlerhaftes Feld wird erst gesendet, wenn Sie es korrigiert haben; alles andere wird weiter synchronisiert.

Eine HubSpot-Eigenschaft erstellen. Wählen Sie für ein Feld ohne Eigenschaft Create a HubSpot property: Beim Bestätigen legt Nodale sie in HubSpot in der Gruppe Nodale an (benannt nodale_...) und sendet das Feld dorthin.

HubSpot-Eigenschaften importieren. Add HubSpot properties to Nodale macht die HubSpot-Eigenschaften, die Sie ankreuzen, zu Nodale-Feldern, die ihnen zugeordnet sind. Ein Dropdown wird zu einem Auswahlfeld, eine Checkbox zu einem Ja/Nein-Feld, alles andere zu Text.

Die Werte abgleichen. Bei einem Auswahlfeld, das an ein Dropdown gesendet wird, muss jeder Wert einer HubSpot-Option zugeordnet sein. Es wird erst gesendet, wenn jeder Wert eine hat.

Die Sync-Richtung wählen

Jedes zugeordnete Feld hat eine Sync-Richtung. Standard ist Bi-sync on create, HubSpot priority on update. Ein leerer Nodale-Wert leert HubSpot nie.

Sync-Richtung	Erste Übertragung des Leads	Spätere Übertragungen	Beide haben einen Wert
Bi-sync	Jede Seite füllt den leeren Wert der anderen; ein gefüllter HubSpot-Wert setzt sich durch	Die Seite, die sich seit der letzten Synchronisierung geändert hat, wird übernommen	Erste Übertragung: HubSpot setzt sich durch. Danach die Seite, die sich seit der letzten Synchronisierung geändert hat; HubSpot, wenn sich beide geändert haben
Bi-sync on create, HubSpot priority on update (Standard)	Jede Seite füllt den leeren Wert der anderen	HubSpot setzt sich durch, wenn es einen Wert hat, sonst füllt Nodale ihn	Bei der ersten Übertragung behält jede Seite ihren Wert, danach setzt sich HubSpot durch
HubSpot priority	Der HubSpot-Wert fließt zurück in Nodale; Nodale schreibt nie	Ebenso	HubSpot setzt sich durch
Nodale priority	Nodale schreibt, auch über einen vorhandenen Wert	Ebenso; nichts fließt zurück	Nodale setzt sich durch
Deactivate sync	Nichts fließt	Nichts fließt	Jede Seite behält ihren Wert

Ein Beispiel: In HubSpot steht „Marketing Manager“ als Jobtitel, und der Besucher sagt dem Agenten „Head of Growth“. Mit dem Standard behält HubSpot „Marketing Manager“. Mit Nodale priority erhält HubSpot „Head of Growth“.

HubSpot sendet Werte nur für Vorname, Nachname, Jobtitel und die Qualifizierungsfelder an Nodale zurück. Eine schreibgeschützte HubSpot-Eigenschaft kann nur auf HubSpot priority oder deaktiviert stehen.

Die Notiz zu jeder Konversation

Jede Konversation wird zu einer Notiz in HubSpot, angehängt an den Kontakt, sein Unternehmen und die offenen Deals des Kontakts. Sie wird einmal geschrieben und nie aktualisiert. Ihr Datum ist der Beginn der Konversation.

Was sie enthält, legen Sie im Tab Note fest. In dieser Reihenfolge:

Block	Was er enthält	Abschaltbar
Summary	Weshalb der Besucher kam und wie die Konversation verlief.	Nein
Next step	Was der Agent als nächsten Schritt empfiehlt.	Ja
Qualification criteria	Die zu Ihren Kriterien erfassten Werte.	Ja
Qualification framework	Eine kurze Zeile pro Säule Ihres Frameworks (standardmäßig MEDDIC; SPICED, BANT, CHAMP oder NEAT), aus der Konversation geschrieben. Nicht angezeigt, wenn Sie mit Ihrer eigenen Liste qualifizieren.	Ja
Demos shown	Welche Demos abgespielt wurden.	Ja
Pages visited	Die Seiten, die vor und während der Konversation angesehen wurden.	Ja
Open the lead in Nodale	Ein Link zum Lead.	Nein
Full transcript	Die gesamte Konversation, Zeilen beginnend mit „Visitor:“ oder „Agent:“.	Ja

Alle Blöcke sind standardmäßig aktiv. Eine Notiz bleibt unter der Größengrenze von HubSpot: Zuerst wird das Transkript gekürzt („Transcript shortened, the full conversation is in Nodale.“), dann entfallen die letzten Blöcke. Die Zusammenfassung und der Link bleiben immer. Sobald der Inhalt einer Konversation nicht mehr aufbewahrt wird, geht ihre Notiz ohne Transkript hinaus.

Deals

Nodale erstellt keinen Deal und ändert keinen: keinen Betrag, keine Phase, keine Deal-Eigenschaft.

Es hängt die Notiz jeder Konversation an die offenen Deals des Kontakts: die Deals des Kontakts in Ihrer Standard-Pipeline (oder, wenn diese keine offene Phase hat, in der ersten Pipeline mit einer offenen Phase), deren Phase nicht geschlossen ist. Ein Kontakt, den Nodale gerade angelegt hat, hat noch keinen Deal, daher geht seine erste Notiz nur an den Kontakt und das Unternehmen.

Termine mit HubSpot Meetings buchen

Der Agent kann während der Konversation Termine in Ihren HubSpot-Meeting-Links buchen. Er nutzt dieselbe HubSpot-Verbindung: Es gibt nichts weiter zu installieren. Ein Portal, das vor dieser Funktion verbunden wurde, zeigt bei seinen Buchungs-Outcomes To reconnect: Verbinden Sie HubSpot einmal neu, um den Scope für die Meeting-Links zu gewähren.

1. Öffnen Sie in Nodale Agents, dann den Tab Outcomes, und erstellen Sie ein New outcome vom Typ Meeting booking.
2. Wählen Sie einen Meeting type. Jeder HubSpot-Meeting-Link, persönlich oder für ein Team, wird einmal pro Dauer aufgeführt, zum Beispiel „HubSpot Meetings · Intro call · 30 min“.
3. Verknüpfen Sie jede required question des Meeting-Links mit einem Element, das der Agent erfasst. Name und E-Mail werden automatisch ausgefüllt. Eine Telefonfrage wird nicht unterstützt: Machen Sie sie in HubSpot optional.

Wenn der Besucher eine geschäftliche E-Mail angegeben hat und der Moment passt, bietet der Agent Zeiten in seiner Zeitzone und Sprache an und bucht die, die er wählt. HubSpot legt den Termin mit Name, E-Mail, Zeitzone und Antworten des Besuchers an, nach den Regeln des Links (Zeiten, Vorlaufzeit, wer im Team frei ist). Wurde die Zeit inzwischen vergeben, bietet der Agent neue an.

Nodale sagt keine Termine ab und verschiebt keine: Das geschieht in HubSpot.

Daten und Trennung

• Nodale schreibt nur die zugeordneten Eigenschaften, die Notiz und die Unternehmenseigenschaft Nodale record ID.
• Das Trennen löscht nichts in HubSpot. Auch das Löschen eines Leads in Nodale löscht nichts in HubSpot.
• Fragen: support@nodale.ai.

Fehlerbehebung

Meldung in Nodale	Was passiert ist
HubSpot was not connected: access was refused on the HubSpot page.	Die Zustimmungsseite wurde geschlossen oder abgelehnt.
The HubSpot connection link expired or was already used. Start again from this page.	Der Link ist zehn Minuten lang und nur einmal gültig. Klicken Sie erneut auf Connect HubSpot.
HubSpot did not answer. Please try again in a few minutes.	HubSpot war nicht erreichbar.
HubSpot refused the connection. Please try again, or contact support if it keeps happening.	HubSpot hat die Anfrage abgelehnt.
Couldn’t connect HubSpot. Please try again.	Jeder andere Fehler.