HubSpot Telefonie Integration einrichten
HubSpot Telefonie Integration Schritt für Schritt einrichten: Mit Voice-AI, Webhooks, CRM-Mapping und Kalender-Sync inklusive DSGVO-Tipps.

Ein SDR ruft einen Lead an, führt ein gutes Gespräch und wechselt danach direkt zum nächsten Kontakt. Im CRM bleibt entweder nur eine Telefonnummer sichtbar oder eine handschriftliche Notiz wie „Interesse vorhanden“. Der Gesprächsinhalt, der nächste Schritt und die Qualität des Setters verschwinden damit aus dem Vertriebsprozess.
Genau hier entscheidet sich, ob eine HubSpot Telefonie Integration nur technisch funktioniert oder im Tagesgeschäft tatsächlich Umsatz unterstützt. Rufnummer, Kontakt, Gesprächsnotiz, Recording, Deal-Phase und Follow-up müssen in einem nachvollziehbaren Ablauf zusammenarbeiten. Besonders bei einer Voice-AI-Lösung wie malma darf die Anbindung nicht bei einem Webhook enden. Sie muss auch Opt-ins, Datenfelder, Terminbuchung und Verantwortlichkeiten abbilden.
Warum eine saubere Telefonie-Anbindung in HubSpot den Unterschied macht
Ein Vertriebsteam verliert keine Leads, weil ihm grundsätzlich zu wenig Telefonie zur Verfügung steht. Es verliert sie, weil Gespräche nicht sauber erfasst werden und niemand sicher weiß, was danach passieren soll. Ein eingehender Anruf landet beim falschen Kontakt, der Termin wird nicht in die Pipeline geschrieben oder der Setter markiert ein Gespräch als „qualifiziert“, ohne dass die Kriterien nachvollziehbar bleiben.
HubSpot dokumentiert, dass Anrufe über eine eigene HubSpot-Nummer, eine registrierte bestehende Nummer oder eine Calling-Integration eingerichtet werden können. Aufgezeichnete Anrufe lassen sich automatisch in Kontaktdatensätzen protokollieren und in Berichte zu Anrufkennzahlen überführen, wie die deutsche HubSpot-Dokumentation zu Click-to-Call beschreibt. Für Teams mit höherem Telefoniebedarf ist außerdem relevant, dass HubSpot Drittanbieter-Telefonsysteme und bidirektionale CRM-Integrationen mit Partnern wie Aircall, JustCall oder Dialpad unterstützt.
Was im Vertriebsprozess zusammengehört
Ein brauchbares Setup verbindet mindestens diese Ebenen:
- Kontaktaktivität: Der Call wird dem richtigen Kontakt zugeordnet und erscheint in der Aktivitätshistorie.
- Gesprächsergebnis: Outcome, Qualifizierungsstatus, Einwand und nächster Schritt werden strukturiert gespeichert.
- Pipeline-Logik: Ein gebuchter Termin oder ein qualifizierter Lead aktualisiert den Deal, statt nur eine lose Notiz zu erzeugen.
- Transparenz: Teamleitungen können Gesprächsverläufe, Aufzeichnungen und Auswertungen prüfen, sofern die nötigen Einwilligungen vorliegen.
Eine blosse Rufnummernzuweisung reicht deshalb nicht. Ohne Activity-Log bleibt die Historie lückenhaft. Ohne definierte Properties kann ein Workflow nicht zuverlässig reagieren. Und ohne Recording-Opt-in darf ein Unternehmen nicht einfach davon ausgehen, dass jede Gesprächsaufzeichnung zulässig ist.
Praxisregel: Jede Telefonie-Aktion braucht ein klares CRM-Ergebnis. Wenn nach dem Call niemand weiß, welches Feld aktualisiert, welcher Workflow ausgelöst und wer für das Follow-up zuständig wird, ist die Integration noch nicht fertig.
Der Nutzen geht über Telefonie hinaus. HubSpot richtet seine KI-gestützte CRM-Umgebung auf das zentrale Erfassen von E-Mails, Website-Besuchen, Anrufen, Meetings und Tickets aus. Für Unternehmen, die zusätzlich Prozesse wie invoicing tool integrations mit ihrer Systemlandschaft verbinden, gilt dasselbe Prinzip: Geschäftsdaten müssen an der Stelle ankommen, an der Teams Entscheidungen treffen.
Voraussetzungen und Telefonieoptionen in HubSpot
Vor der Einrichtung sollte ein Administrator drei Dinge klären: Welche HubSpot-Berechtigungen sind vorhanden, welche Rufnummer soll verwendet werden und welcher Telefonieanbieter passt zum Gesprächsvolumen? Die verfügbare Calling-Funktion hängt von Produkt, Tarif und Anbieter ab. Prüfe deshalb die aktuelle HubSpot-Konfiguration, bevor du einen Marketplace-Connector oder eine individuelle API-Anbindung planst.
Für eine native Lösung brauchst du eine HubSpot-Nummer oder eine registrierte bestehende Nummer. Eine dritte Möglichkeit ist die Verbindung eines externen Anbieters über den Marketplace oder über eine eigene Entwicklung. HubSpot beschreibt für Länder und Szenarien außerhalb der nativen Calling-Unterstützung ausdrücklich die Verwendung von Drittanbieter-Calling-Apps. Wer die technischen Grundlagen von SIP besser einordnen möchte, findet eine verständliche Einführung in der Erklärung zum SIP-Trunking.
Die Auswahl nach Prozess, nicht nach Produktname
| Option | Einrichtung | Geeignet für | Schnittstellen |
|---|---|---|---|
| HubSpot Calling | Nummer in HubSpot einrichten und Benutzern zuweisen | Teams mit überschaubarem Telefonieprozess innerhalb des CRM | HubSpot-Kontakte, Aktivitäten, Anrufberichte |
| Calling-Provider | App aus dem Marketplace installieren und Provider konfigurieren | Teams mit Routing, bestehenden Rufnummern oder spezialisiertem Call-Centre-Bedarf | Provider-App, CRM-Aktivitäten, Notizen und je nach Anbieter Recording |
| Externe Voice-AI | API-Zugang, Webhook-Logik und Feldmapping definieren | Automatisierte Erstqualifizierung, Terminierung und eingehende Anrufe | API, Webhooks, Contact-, Call- und Deal-Objekte |
Native HubSpot-Telefonie ist oft der schnellste Start, aber nicht automatisch die flexibelste Wahl. Ein spezialisierter Provider kann bessere Routing- oder Teamfunktionen liefern, bringt dafür eine zusätzliche Systemebene mit. Eine Voice-AI kann Gespräche automatisiert qualifizieren und Termine buchen, verlangt aber besonders saubere Regeln für Datenqualität, Eskalation und Datenschutz.
Lege vor dem technischen Setup fest, ob ein Gespräch beim Kontakt, beim Deal oder bei beiden Objekten gespeichert werden soll. Entscheide außerdem, ob ein Anbieter das Recording, die Transkription und die Gesprächsauswertung vollständig an HubSpot zurückgeben kann. Diese Entscheidung beeinflusst später deine Workflows stärker als die Wahl des Telefonie-Widgets.
Schritt-für-Schritt Setup mit HubSpot Calling und Voice-AI
Starte nicht mit der Voice-AI, sondern mit der CRM-Struktur. Öffne in HubSpot die Einstellungen und prüfe unter Allgemein den Bereich für Anrufe und Anrufaufzeichnung. Wenn Aufzeichnungen verwendet werden, muss dort ein verständlicher DSGVO-Opt-in-Text hinterlegt sein. Der genaue Wortlaut sollte vor dem Go-Live rechtlich geprüft werden.

HubSpot Calling einrichten
- Berechtigungen prüfen: Gib dem Administrator Zugriff auf Einstellungen, Marketplace-Apps, Workflows und benutzerdefinierte Eigenschaften.
- Calling aktivieren: Wähle die gewünschte Nummernoption und ordne die Rufnummer den zuständigen Benutzern oder Teams zu.
- Recording konfigurieren: Aktiviere die Aufzeichnung nur gemeinsam mit einem klaren Hinweis und einem dokumentierten Einwilligungsprozess.
- Custom Property erstellen: Lege etwa
call_outcome,ai_intent,lead_scoreundappointment_bookedals passende Kontakt- oder Aktivitätseigenschaften an. - Standardwerte definieren: Nutze feste Auswahlwerte wie „qualifiziert“, „nicht qualifiziert“, „Rückruf“ oder „Termin vereinbart“, statt freie Textfelder zu überlassen.
Für die Anbindung einer externen Voice-AI brauchst du anschließend einen API-Key und einen eingehenden Webhook. Im beschriebenen Setup sendet malma die Gesprächsdaten an den Endpunkt /api/v1/communication/calls. Das Mapping sollte contactId, phone, recordingUrl, transcript und outcome auf die HubSpot-Objekte Contact, Call und Engagement verteilen.
Eine praktische Übersicht zu Authentifizierung, Payloads und Fehlerbehandlung findest du in der Anleitung zur API-Anbindung. Lege das Recording nicht nur als URL in einer Notiz ab. Verknüpfe es, sofern die verwendeten Systeme und Berechtigungen das erlauben, nachvollziehbar mit der Call-Aktivität und dem relevanten Deal.
Routing und Testkontakt
Definiere eine Inbound-Routing-Regel für neue und bekannte Telefonnummern. Existiert bereits ein Kontakt, soll die Aktivität über eine stabile Telefonnummernzuordnung gefunden werden. Ist kein Kontakt vorhanden, muss der Prozess festlegen, ob HubSpot einen neuen Datensatz anlegt oder die Voice-AI zunächst nur die Gesprächsdaten zurückgibt.
Teste danach mit Dummy-Kontakten. Prüfe jeweils Kontaktzuordnung, Call-Dauer, Notiz, Recording-Link, Transkript, Outcome und Deal-Verknüpfung. Ein Test gilt erst dann als bestanden, wenn auch ein negatives Gespräch und ein abgebrochener Anruf korrekt verarbeitet werden.
Webhooks, Kalender-Sync und Follow-up-Automation verbinden
Die Telefonie wird erst wertvoll, wenn der Datenfluss nach dem Gespräch stabil bleibt. Ein Call-Ende sollte deshalb einen definierten Prozess auslösen: Daten sammeln, Payload validieren, Kontakt aktualisieren, Terminstatus prüfen und anschließend die passende Folgeaktion starten.
Lege für den Webhook eine eindeutige Authentifizierung fest und dokumentiere die Rate Limits des jeweiligen Anbieters. Als Pflichtparameter eignen sich conversation_id, outcome, lead_score und appointment_booked. Ergänze bei Bedarf contactId, dealId, recordingUrl, transcript und einen Zeitstempel, damit Support und Vertrieb später nachvollziehen können, was passiert ist.

Der Ablauf nach Gesprächsende
Ein Workflow sieht so aus:
- Anruf beendet: Die Voice-AI übergibt Gesprächskennung, Rufnummer, Outcome und gewünschte CRM-Aktion.
- Webhook validiert: Der Endpunkt prüft Authentifizierung, Pflichtfelder und das erwartete Datenformat.
- Kontakt aktualisiert: HubSpot sucht den Datensatz über
contactIdoder eine sauber normalisierte Telefonnummer. - Deal verarbeitet: Bei qualifiziertem Ergebnis wird ein bestehender Deal aktualisiert oder nach einer klaren Regel neu angelegt.
- Follow-up ausgelöst: Der Workflow erstellt eine Aufgabe, versendet eine zulässige Nachricht oder weist den Fall einem Mitarbeiter zu.
Verbinde anschließend Google Calendar oder Microsoft Outlook über HubSpot Meetings. Der Kalender-Sync sollte nicht nur einen Termin anzeigen. Er muss auch das Feld appointment_booked setzen und, falls fachlich gewollt, die Deal-Phase auf „Termin vereinbart“ verschieben. Eine Anleitung zum Google Calendar Sync hilft bei der praktischen Verbindung von Kalender und Terminprozess.
Achte auf Idempotenz. Derselbe Webhook darf bei einer Wiederholung keinen zweiten Deal und keine doppelten Follow-up-Aufgaben erzeugen. Speichere deshalb conversation_id oder eine vergleichbare externe Kennung und prüfe sie vor jeder Neuanlage.
Ein Webhook ist kein Workflow. Er liefert nur Daten. Erst die CRM-Regeln machen daraus eine verlässliche Vertriebsaktion.
Best Practices für Skripte, A/B-Tests und Lead-Tracking
Eine technisch korrekte Telefonie-Integration kann trotzdem schlechte Ergebnisse liefern, wenn das Gesprächsskript keine klare Qualifizierung ermöglicht. Voice-AI, menschlicher Setter und Vertriebsleitung müssen dieselben Definitionen verwenden. „Interessiert“ ist kein belastbarer Status, wenn niemand weiß, ob damit Bedarf, Budget, Entscheidungsbefugnis oder nur Gesprächsbereitschaft gemeint ist.
Versioniere Skripte und speichere die verwendete Variante als Property, zum Beispiel in call_variant. Ergänze ai_intent für das erkannte Anliegen und objection_level für die Einordnung von Einwänden. So kannst du Deals und Aktivitäten später filtern, ohne Transkripte manuell durchsuchen zu müssen.
Vergleich der Gesprächsvarianten
| Kennzahl | Skript A klassisch | Skript B Pain-Frame |
|---|---|---|
| Gesprächseinstieg | Offene Frage zur aktuellen Situation | Problem und mögliche Auswirkung früh benennen |
| Qualifizierung | Bedarf über mehrere Rückfragen erfassen | Schmerzpunkt bestätigen und priorisieren |
| Terminübergang | Einladung nach ausführlichem Austausch | Termin als konkreten nächsten Schritt anbieten |
| Auswertung | Gesprächsnotiz und Outcome | Outcome, Einwandstufe und Terminstatus |
Der Test sollte nicht nur auf gebuchten Terminen basieren. Prüfe auch, ob die Termine tatsächlich zur Zielgruppe passen, ob nach dem ersten Pitch häufig abgesagt wird und ob das Gespräch den erwarteten Deal-Status erzeugt. Die durchschnittliche Gesprächsdauer kann als Diagnose dienen, ist aber kein Qualitätsurteil an sich. Ein kurzes Gespräch kann eine saubere Qualifizierung bedeuten, ein langes Gespräch kann lediglich auf ein unpräzises Skript hindeuten.
Welche Properties wirklich helfen
call_variant: Macht die Zuordnung zur Skriptversion sichtbar.ai_intent: Trennt Anliegen wie Beratung, Rückruf, Support oder Terminwunsch.objection_level: Zeigt, ob ein Einwand leicht, klärungsbedürftig oder abbruchrelevant war.appointment_booked: Verbindet Gesprächsergebnis und Kalenderaktion.outcome: Liefert die Basis für Workflows, Aufgaben und Reports.
Erstelle Saved Reports für diese Felder und bewerte Varianten erst, wenn genügend vergleichbare Gespräche vorliegen. Der interne Vorschlag, mindestens 50 Calls pro Variante zu testen, stammt aus der Setup-Anforderung, ist aber keine allgemeingültige statistische Schwelle. Entscheidend sind saubere Vergleichsbedingungen, konsistente Lead-Quellen und eine eindeutige Definition von „Erfolg“.
Tests, Troubleshooting und typische Fehlerquellen
Ein Go-Live-Test sollte nicht nur einen erfolgreichen Anruf simulieren. Lege drei Dummy-Kontakte mit unterschiedlichen Rufnummernformaten an, etwa mit und ohne Ländervorwahl sowie für Mobil- und Festnetznummern. Prüfe nach jedem Anruf in der Kontaktchronik, ob Aktivität, Dauer, Aufnahmelink und Notiz am richtigen Datensatz erscheinen.
Fehler systematisch eingrenzen
Falscher Kontakt: Die Telefonnummer ist doppelt vorhanden oder der Provider ordnet über eine unzuverlässige Identifikation zu. Prüfe zuerst Normalisierung und Matching-Regel, danach die HubSpot-Aktivitätszuordnung.
Termin ohne Deal: Der Kalender-Sync zeigt den Termin, aber der Workflow findet die erwartete Property nicht. Kontrolliere interne Property-Namen, Datentypen und die Reihenfolge der Workflow-Aktionen.
Webhook mit 401: Häufig wurde der API-Key geändert, abgelaufen oder im falschen Header übertragen. Vergleiche die Authentifizierung im Sender, im Endpoint und in den HubSpot-Logs.
Kein brauchbares Transkript: Prüfe Audioformat, Sprachkonfiguration und die Übergabe des Recording-Links. Die in der technischen Vorgabe genannte Opus-Konfiguration mit 16 kHz solltest du nur übernehmen, wenn Voice-AI-Anbieter und Endpunkt sie tatsächlich verlangen.
Doppelte Aktivitäten: Wiederholte Webhook-Zustellungen können dieselbe Unterhaltung mehrfach speichern. Nutze eine eindeutige conversation_id und verhindere Duplikate vor der Erstellung neuer CRM-Objekte.
Dokumentiere jeden Fehler in einem internen Runbook. Die Tabelle sollte Fehlerbild, Prüfpunkt, verantwortliche Rolle und Eskalationsweg enthalten. So weiß der Vertrieb, wer Logs prüft, wer den Voice-AI-Support kontaktiert und wer betroffene Leads informiert.
DSGVO, EU-AI-Act und Checkliste für den Go-Live
Eine deutsche Telefonie-Integration ist nicht automatisch DSGVO-konform, nur weil HubSpot eine EU-Datenspeicherung oder Consent-Funktionen anbietet. HubSpot beschreibt deutsche Calling-Unterstützung und Drittanbieter-Apps, während die rechtliche Bewertung von Aufzeichnung, Einwilligung, Aufbewahrung und Datenfluss beim Unternehmen bleibt. Die Hinweise zur Unterstützung von Calling-Ländern und Drittanbieter-Apps ersetzen deshalb keine Prüfung von AVV, SCC, Dokumentation und gegebenenfalls Betriebsratsanforderungen.
Vor dem Go-Live müssen Verantwortliche festlegen, welche Rechtsgrundlage für die Verarbeitung gilt. Für Gesprächsmitschnitte ist ein verständlicher Hinweis vor Beginn des Recordings nötig. Außerdem sollten Voice-AI-Anbieter, Hosting, Unterauftragsverarbeiter, Transkription, Löschfristen und Exportmöglichkeiten in das Verzeichnis der Verarbeitungstätigkeiten aufgenommen werden.

Die priorisierte Prüfung
- Rechtsgrundlage: Art. 6 DSGVO, Zweck und Verantwortlichkeit schriftlich festlegen.
- Recording-Opt-in: Hinweistext, Einwilligungslogik und Nachweis im CRM prüfen.
- Datenverträge: AVV, SCC-Prüfung und Unterauftragsverarbeiter mit dem Anbieter klären.
- Mitarbeiterdaten: Betriebsrat und Beschäftigteninformation einbeziehen, sofern interne Gespräche oder Leistungsdaten verarbeitet werden.
- KI-Transparenz: Prüfen, wie das System nach dem EU-AI-Act einzuordnen ist und welche Hinweise Gesprächsteilnehmer erhalten müssen.
- Löschung: Fristen für Recording, Transkript und Auswertung definieren und technisch umsetzen.
- Auskunft: Datenexport, Berichtigung und Löschung für Kontakt- und Aktivitätsdaten testen.
- Berechtigungen: Zugriff auf Aufnahmen und Transkripte nach Rollen begrenzen.
- Monitoring: Fehler, Opt-in-Status, Webhook-Zustellungen und Anrufertransparenz überwachen.
In HubSpot sollten nur Felder landen, die der Vertriebsprozess wirklich benötigt. Dazu gehören typischerweise Kontaktzuordnung, Gesprächszeitpunkt, Outcome, nächster Schritt, Terminstatus und eine Referenz auf Recording oder Transkript. Freie Volltextfelder mit unnötigen sensiblen Details erschweren Löschung, Auskunft und Zugriffskontrolle.
malma.ai kann als Voice-AI-Telefonsetter neue Leads qualifizieren, Termine im Gespräch buchen und Gesprächsdaten per HubSpot-Anbindung zurück ins CRM schreiben. Wenn du deine Telefonie mit Webhooks, strukturierten Properties und einem belastbaren Opt-in-Prozess verbinden möchtest, besuche malma.ai und prüfe, wie der Ansatz zu deinem Vertriebsprozess passt.



