HubSpot Sync konfigurieren
Bidirektionale Synchronisation zwischen Orconic und HubSpot — Kontakte, Deals, Aktivitäten.
Zuletzt aktualisiert: 2026-05-17
HubSpot Sync konfigurieren
Die HubSpot-Integration erlaubt Agenten den Lese- und Schreibzugriff auf Kontakte, Unternehmen, Deals und Aktivitäten.
Voraussetzungen
- HubSpot-Account ab Sales Hub Starter
- Admin-Rechte in HubSpot
- Orconic-Rolle Admin
Schritt 1 — App installieren
In Orconic: Integrationen → HubSpot → Verbinden.
Du wirst nach HubSpot weitergeleitet. Wähle das Portal aus und akzeptiere die Scopes:
crm.objects.contacts.read/writecrm.objects.companies.read/writecrm.objects.deals.read/writecrm.engagements.read/write
Schritt 2 — Feld-Mapping
Im Reiter Mapping entscheidest du, welche Orconic-Felder welchen HubSpot-Properties entsprechen:
orconic.firma → hubspot.company.name
orconic.email → hubspot.contact.email
orconic.lead_score → hubspot.contact.lead_score_customUnbekannte Felder werden ignoriert — keine versehentlichen Schemaänderungen in HubSpot.
Schritt 3 — Sync-Richtung
Pro Objekttyp wählst du:
- Read only — Orconic liest nur
- Write only — Orconic schreibt, liest nicht
- Two-way — Änderungen werden in beide Richtungen propagiert
Bei Two-way Sync nutzt Orconic einen Last-Writer-Wins-Ansatz, basierend auf updated_at.
Schritt 4 — Aktivitäten
Agenten können Aktivitäten in HubSpot erzeugen:
hubspot.activity.create({
contactId: "{{trigger.contactId}}",
type: "EMAIL",
body: "{{steps.draft.text}}"
})So bleibt deine CRM-Historie vollständig — auch wenn der Agent die eigentliche Aktion durchführt.
Performance und Limits
- HubSpot-API-Limit: 100 Calls/10s pro Portal
- Orconic batched Anfragen automatisch und respektiert Retry-After
- Für sehr hohe Volumina (> 1 Mio. Kontakte) kontaktiere
support@orconic.com
Häufige Probleme
Symptom | Ursache | Fix
------------------------ | ------------------------------- | --------------------
401 invalid_token | App-Berechtigung entzogen | neu verbinden
Property not found | Custom Property fehlt | in HubSpot anlegen
Duplikate | Email-Match deaktiviert | Dedup im Mapping aktiv.