CRM & Vertrieb
HubSpot mit einem autonomen KI-Agenten verbinden
Ein mit HubSpot verbundener Atako-Agent kann Kontakte, Unternehmen, Deals und Tickets lesen und aktualisieren, aber nur die Objekte und Aktionen, die sein Grant abdeckt.
Mögliche Workflows
Anreicherung und Qualifizierung eingehender Leads
Sobald ein Kontakt im CRM eingeht, ruft ihn der Agent mit get_contact ab, gleicht verfügbare Informationen ab, aktualisiert seine Eigenschaften (update_contact), hält eine Qualifizierungsnotiz fest (create_note) und erstellt eine Nachfassaufgabe für den zuständigen Vertriebler (create_task). Der Vertriebler behält die Kontrolle über Anruf oder E-Mail, der Agent erspart ihm nur die Eingabe und Recherche, die normalerweise vor einem ersten nützlichen Kontakt stehen und mangels Zeit im Tagesgeschäft oft aufgeschoben werden.
Nachfassen bei stagnierenden Deals in der Pipeline
Der Agent sucht Deals ohne Bewegung seit mehreren Tagen (search_deals, list_pipelines für die Phasen), erstellt eine Nachfassaufgabe für den über list_owners identifizierten Deal-Verantwortlichen und kann den Status aktualisieren, wenn eine klare Regel das rechtfertigt (update_deal). Nichts wird verschoben, ohne eine im CRM einsehbare Spur zu hinterlassen, was aufgeblähte Pipelines mit Deal-Leichen vermeidet, die niemand wirklich nachfasst.
Erstellung von Support-Tickets mit Kontobezug
Ausgehend von einem per E-Mail oder Slack eingegangenen Signal erstellt der Agent ein Ticket (create_ticket), verknüpft es mit dem richtigen Kontakt und Unternehmen (create_association) und verfolgt dann seinen Fortschritt, um es im Verlauf des Gesprächs zu aktualisieren (update_ticket). Das Ticket bleibt für das Support-Team wie jedes andere sichtbar und bearbeitbar, mit der bereits bei der Erstellung verknüpften vollständigen Konto-Historie.
Aktionen des Connectors
get_contact (Lesen)
Ruft einen CRM-Kontakt über eine Kennung ab.
search_contacts (Lesen)
Sucht Kontakte per Text oder Eigenschaftsfilter.
get_deal (Lesen)
Ruft einen CRM-Deal über eine Kennung ab.
list_deals (Lesen)
Listet CRM-Deals auf, paginiert.
list_pipelines (Lesen)
Listet Pipelines und ihre Phasen auf (Deals oder Tickets).
list_owners (Lesen)
Listet CRM-Verantwortliche auf, filterbar nach E-Mail.
create_contact (Schreiben)
Erstellt einen CRM-Kontakt.
update_contact (Schreiben)
Aktualisiert die Eigenschaften eines Kontakts.
create_deal (Schreiben)
Erstellt einen CRM-Deal.
update_deal (Schreiben)
Aktualisiert einen Deal (Phase, Betrag).
create_ticket (Schreiben)
Erstellt ein Support-Ticket.
create_task (Schreiben)
Erstellt eine CRM-Aufgabe (Nachfassen, Anruf).
create_note (Schreiben)
Hält eine Notiz fest, zur Verknüpfung mit einem Eintrag.
create_association (Schreiben)
Verknüpft zwei CRM-Einträge miteinander.
Voraussetzungen
- HubSpot-Konto mit Super-Admin-Recht zum Erstellen einer Private App.
- Eine Private App unter Settings, dann Integrations, dann Private Apps erstellen.
- Die benötigten Scopes auswählen (contacts, companies, deals, tickets, owners in Lesen/Schreiben).
- Das nach der Erstellung angezeigte Zugriffstoken kopieren (Präfix pat-).
- In Atako ein Recht zur Verwaltung der Integrationen, um den Grant an den Agenten zu erteilen.
So verbinden Sie
- 1
Die HubSpot-Private-App erstellen
Unter Settings, dann Integrations, dann Private Apps eine App erstellen, benennen und dann ihre Scopes im dafür vorgesehenen Tab wählen.
- 2
Token erzeugen und kopieren
Nach Erstellung der App das Zugriffstoken (pat-...) anzeigen und kopieren, nur einmal angezeigt.
- 3
HubSpot in Atako verbinden
Unter Einstellungen, dann Integrationen das Zugriffstoken einfügen.
- 4
Den Grant an den Agenten erteilen
Auf der Seite des Agenten oder der Verbindung die präzisen erlaubten Aktionen und ihren Umfang auswählen (nur Lesen oder Lesen und Schreiben).
Warum einen autonomen Agenten mit HubSpot verbinden
HubSpot bündelt die Kontakte, Deals und Tickets eines Vertriebs- oder Support-Teams. Die dazugehörige repetitive Arbeit, eine Karte anreichern, einen liegen gebliebenen Deal nachfassen, eine Verfolgungsaufgabe anlegen, geschieht meist nebenbei, wenn jemand daran denkt. Ein über Tool-Calling mit HubSpot verbundener Atako-Agent erledigt diese Arbeit fortlaufend, in seiner eigenen Umgebung, ohne darauf zu warten, dass ein Vertriebler seine Aufgabenliste am Morgen öffnet.
Der Unterschied zu einem klassischen Automatisierungsszenario: Der Agent läuft dauerhaft und trifft eine Entscheidung, nicht nur eine isolierte Aktion. Er kann ein Signal per E-Mail oder Slack erhalten, den betroffenen Kontakt oder Deal in HubSpot suchen, entscheiden, ob eine Aufgabe erstellt oder eine Eigenschaft aktualisiert werden muss, und dies dann tun, im genauen Rahmen der ihm erteilten Aktionen.
Der HubSpot-Konnektor deckt laut Atako-Dokumentation 37 Aktionen ab (17 Lesen, 20 Schreiben), von der Kontaktsuche bis zur Erstellung benutzerdefinierter Eigenschaften. Der direkteste Produktanwendungsfall: ein Agent zur Automatisierung von RevOps, der die Pipeline überwacht, Leads anreichert und Datenanomalien meldet, ohne ständigen manuellen Eingriff.
Grenzen und bewährte Praktiken
Die HubSpot-API setzt Ratenbegrenzungen durch, die je nach HubSpot-Abonnement des Unternehmens variieren (Anzahl Anfragen pro Zehn-Sekunden-Intervall und pro Tag), mit noch strengeren Schwellen für Such-Endpunkte. Ein Agent, der ein großes Kontaktvolumen verarbeitet, muss seine Aufrufe daher zeitlich strecken, statt alles auf einmal zu tun.
Manche Schreibaktionen, wie delete_contact oder delete_deal, sind auf HubSpot-Seite nach der Ausführung unumkehrbar. Sie sind nur nutzbar, wenn der Grant des Agenten sie explizit erlaubt, was für diese Art von Aktion in der Praxis selten bleibt.
Wie bei jeder Atako-Integration gibt die Verbindung allein keinen Zugriff: Es braucht einen präzisen Grant (Agent, Aktion, Umfang). Siehe das Berechtigungsmodell und die Preise, um diesen Rahmen abzustecken, bevor Sie den Agenten an Ihr CRM anschließen.
Verwandte Anwendungsfälle
Passende Integrationen
Häufig gestellte Fragen
Kann der Agent Marketing-E-Mails von HubSpot aus versenden?
Er kann einen Marketing-E-Mail-Entwurf erstellen (create_marketing_email), wenn dieser Scope erteilt wurde, aber nichts geht raus ohne eine von Ihrem Team freigegebene Versandaktion: Der Konnektor enthält keine Aktion zum direkten Versand von Marketing-E-Mails.
Braucht man einen kostenpflichtigen HubSpot-Plan, um die API zu verbinden?
Die API und Private Apps stehen bereits im kostenlosen HubSpot-Plan für Standardobjekte zur Verfügung. Manche erweiterten Scopes, wie das Erstellen benutzerdefinierter Eigenschaften, können vom gebuchten Tarif abhängen.
Wie widerruft man den Zugriff des Agenten auf HubSpot?
Löschen oder deaktivieren Sie die Private App auf HubSpot-Seite, oder widerrufen Sie die Verbindung bei Atako. Der Zugriff wird sofort und endgültig für alle Agenten unterbrochen, die sie nutzten.
Kann der Agent Kontakte aus dem CRM löschen?
Ja, die Aktion delete_contact existiert, aber nur, wenn der Grant des Agenten sie explizit mit dem Umfang Schreiben erlaubt. Standardmäßig ist keine Aktion erteilt: Sie entscheiden, ob das Löschen zum Aufgabenbereich des Agenten gehört.
Als Nächstes lesen
Quellen
- HubSpot Developer Docs, Private apps · abgerufen am 4. September 2026
- HubSpot Developer Docs, API usage guidelines and limits · abgerufen am 4. September 2026
CTO bei Atako
Dieser Inhalt wurde von den KI-Agenten von Atako verfasst und anschließend von Romain Laodicina, CTO von Atako, geprüft, korrigiert und freigegeben.