HubSpot-Integration einrichten
Mit der HubSpot-Integration sendet dein AI-Agent erfasste Kontaktdaten direkt an dein HubSpot CRM. Sobald ein Besucher seinen Namen, seine E-Mail-Adresse oder Telefonnummer teilt, wird automatisch ein neuer Kontakt angelegt oder ein bestehender Kontakt aktualisiert. Kein manuelles Abtippen, keine CSV-Dateien.
Kurz gesagt
Heyloha verbindet sich über eine Private App mit HubSpot. Kontaktdaten werden direkt auf die Standard-HubSpot-Kontakteigenschaften gemappt. Bestehende Kontakte werden automatisch anhand der E-Mail-Adresse aktualisiert.
Was wird synchronisiert?
Alle Kontaktfelder, die du in Heyloha auswahlst, werden automatisch an die Standard-HubSpot-Kontakteigenschaften gesendet. Keine Konfiguration von Custom Fields erforderlich.
- Vorname und Nachname
- E-Mail-Adresse
- Telefonnummer
- Adresse, Postleitzahl, Stadt und Land
Heyloha nutzt HubSpots Upsert-Endpunkt: Existiert bereits ein Kontakt mit derselben E-Mail-Adresse, werden die Daten aktualisiert statt ein Duplikat zu erstellen.
Was brauchst du?
- Ein HubSpot-Konto mit API-Zugang (verfügbar bei allen bezahlten und kostenlosen CRM-Plänen).
- Eine Private App in HubSpot mit den richtigen Berechtigungen.
- Ein aktives Heyloha-Konto mit mindestens einem AI-Agenten.
Private App in HubSpot erstellen
Gehe zu Private Apps
Melde dich bei HubSpot an und gehe zu Einstellungen > Integrationen > Private Apps.
Erstelle eine neue Private App
Klicke auf 'Create a Private App' und gib der App einen erkennbaren Namen, z.B. 'Heyloha'.
Berechtigungen einstellen
Gehe zum Tab 'Scopes' und aktiviere diese beiden Berechtigungen: crm.objects.contacts.write und crm.objects.contacts.read.
Access Token kopieren
Nach dem Erstellen der App erscheint ein Access Token. Kopiere ihn, du brauchst ihn gleich in Heyloha.
Bewahre den Access Token sicher auf. Teile ihn nicht mit Dritten. In Heyloha wird der Token verschlüsselt gespeichert und nie in Logs angezeigt.
Integration in Heyloha einrichten
Öffne deinen AI-Agenten
Gehe zum Heyloha-Dashboard und klicke auf den AI-Agenten, den du verbinden möchtest.
Einstellungen > Erweitert > Integrationen
Klicke auf 'Integration hinzufugen', um eine neue Verbindung zu erstellen.
Wähle 'HubSpot' als Plattform
Wähle HubSpot aus der Liste. Das Formular passt sich automatisch an.
Access Token einfugen
Fuge den Private App Access Token ein, den du in HubSpot kopiert hast. Keine URL notig.
Integration benennen
Wähle einen erkennbaren Namen, z.B. 'HubSpot Lead Sync'.
Kontaktfelder auswählen
Wähle, welche Daten dein AI-Agent erfassen soll. Wähle mindestens eine E-Mail-Adresse.
Event-Trigger wählen
Wähle, wann die Integration ausgelost werden soll: bei Kontaktdatenerfassung, Terminbuchung oder Zielerreichung.
Verwendungsanweisung beschreiben
Gib eine kurze Anweisung, wann der AI diese Integration aktivieren soll.
Speichern und aktivieren
Setze die Integration auf 'Aktiv' und klicke auf Speichern. Vergiss nicht, auch den AI-Agenten zu speichern.
Verbindung testen
Nach dem Speichern kannst du die Verbindung direkt über die Schaltfläche 'Verbindung testen' auf der Integrationskarte testen. Ein Testkontakt wird an HubSpot gesendet.
- Grun 'Verbunden': deine Zugangsdaten sind gültig und HubSpot hat den Testkontakt akzeptiert.
- Rote Fehlermeldung: etwas stimmt nicht. Die Fehlermeldung zeigt an, was falsch ist.
HubSpot Notes mit Gesprächszusammenfassung
Wenn du "Gesprächszusammenfassung mitsenden" aktivierst, erstellt Heyloha automatisch eine Note auf dem HubSpot-Kontakt mit einer Zusammenfassung des Chatgesprächs. So hat dein Vertriebsteam sofort Kontext.
Zustellungslog
Jeder Zustellungsversuch wird im Zustellungslog festgehalten. Das Log zeigt Zeitstempel, Event, Status und Anzahl der Versuche. Heyloha versucht jede Zustellung bis zu 4 Mal (1 direkter Versuch + 3 Hintergrundversuche mit exponentiellem Backoff) erneut.
Ein kurzer HubSpot-Ausfall führt nicht zu verlorenen Leads, da Heyloha automatisch bis zu 4 Mal erneut versucht.
Häufig gestellte Fragen
Welchen HubSpot-Plan brauche ich?
Du brauchst einen HubSpot-Plan mit API-Zugang und dem Scope crm.objects.contacts.write. Dies ist bei allen bezahlten und kostenlosen CRM-Plänen verfügbar. Hinweis: Developer-Testkonten haben diesen Scope nicht immer. Verwende ein kostenloses CRM-Konto oder einen bezahlten Plan.
Werden Duplikate verhindert?
Ja. Heyloha nutzt HubSpots Upsert-Endpunkt. Existiert bereits ein Kontakt mit derselben E-Mail, werden die Daten aktualisiert.
Kann ich HubSpot mit anderen Integrationen kombinieren?
Ja. Jeder AI-Agent kann mehrere Integrationen haben. Du kannst z.B. gleichzeitig an HubSpot und ActiveCampaign senden.
Generische Webhook-Integration einrichtenActiveCampaign-Integration einrichten