HubSpot

HubSpot wird über einen Service Key verbunden, den Sie in Ihrem HubSpot-Konto erstellen. Danach begrüßt der Agent bekannte Kunden mit Namen und hat ihren letzten Deal parat, legt einen Kontakt und einen Deal an, wenn jemand eine Anfrage hinterlässt, und trägt das Ergebnis jedes Anrufs in den Datensatz des Kunden ein.

Was der Agent kann

• Anrufer erkennen — zu Beginn eines Anrufs sucht er die Telefonnummer in HubSpot und erhält Name, E-Mail und Unternehmen des Kontakts sowie seinen letzten Deal (Name, Phase, Betrag).
• Deal anlegen — findet den Kontakt über die Telefonnummer oder legt einen neuen an und erstellt dann einen Deal in der gewählten Pipeline und Phase. Die Anfrage, die Lieferadresse, die Produkte und die Anzeige, über die der Kunde gekommen ist, landen als Notiz im Deal.
• Anrufe protokollieren — nach jedem Anruf fügt er dem Kontakt und seinem Deal eine Notiz hinzu: Richtung, Dauer, Ergebnis, Zusammenfassung, Link zur Aufzeichnung und auf Wunsch das vollständige Transkript.

Bevor Sie beginnen

• HubSpot-Konto, in dem Sie Schlüssel verwalten können (Super Admin oder ein Benutzer, der Schlüssel erstellen darf).
• HAPP-Workspace mit mindestens einem Agenten.
• HubSpot für Ihren Workspace freigeschaltet — die Integration wird pro Unternehmen freigeschaltet. Bitten Sie den HAPP-Support um die Aktivierung.

Service Key erstellen

1. Öffnen Sie in HubSpot Development > Keys > Service keys und klicken Sie auf Create service key.
2. Geben Sie ihm den Namen HAPP und fügen Sie diese Scopes hinzu:
   • crm.objects.contacts.read, crm.objects.contacts.write
   • crm.objects.deals.read, crm.objects.deals.write
   • crm.objects.owners.read
3. Erstellen Sie den Schlüssel und kopieren Sie ihn.

Ein vorhandenes Private-App-Token (Settings > Integrations > Private apps) mit denselben Scopes funktioniert ebenfalls. HubSpot stellt die Erstellung neuer Private Apps im Oktober 2026 ein; verwenden Sie für neue Verbindungen daher einen Service Key.

Verbinden

1. Öffnen Sie in HAPP Integrationen und suchen Sie HubSpot unter CRM hinzufügen.
2. Klicken Sie auf Verbinden, fügen Sie den Schlüssel ein und bestätigen Sie.
3. HubSpot erscheint unter Meine Integrationen als „HubSpot <Konto-ID>“.

Einstellungen

Klicken Sie im Tab Integrationen des Agenten auf das Zahnradsymbol der Karte.

• Suchen — den Anrufer anhand der Telefonnummer erkennen.
• Erstellen — Deals anlegen. Wählen Sie Pipeline, Phase und Verantwortlich; ohne diese Angaben landet der Deal in der ersten Phase Ihrer ersten Pipeline.
• Anrufnotizen — eine Notiz nach jedem Anruf. Vollständiges Transkript fügt den Gesprächstext hinzu.

Einschränkungen

• HubSpot speichert Telefonnummern so, wie sie eingegeben wurden; der Agent vergleicht die letzten 9 Ziffern, daher gelten 050 111 22 33 und +380501112233 als derselbe Kunde.
• Zu einer Nummer, die es in HubSpot nicht gibt, wird keine Anrufnotiz angelegt — es gibt keinen Datensatz, dem sie zugeordnet werden könnte.
• Gehört die E-Mail des Kunden bereits zu einem anderen Kontakt, wird der Deal diesem Kontakt zugeordnet.

Fehlerbehebung

Trennen

Trennen Sie die Karte in HAPP und löschen Sie den Schlüssel unter Development > Keys > Service keys. Kontakte, Deals und Notizen, die bereits in HubSpot sind, bleiben erhalten.

Weiter

• CRM — alle CRM-Integrationen
• Tools — was der Agent während des Gesprächs aufruft