Skip to main content
CRM sync (Revenue Autopilot) is a beta feature. A workspace admin must enable Beta features, and the workspace needs the Revenue Autopilot add-on (or Include free on the plan) plus CRM sync capacity limits.
CRM Sync importiert Datensätze wiederkehrend aus einem CRM in Audience. Agenten, Kampagnen, Segmente und Automationen können dadurch aktuelle Kontaktattribute ohne CSV-Uploads verwenden.

​
Unterstützte CRMs

  • HubSpot
  • HighLevel
  • Salesforce
  • Pipedrive
  • Close
  • Zoho CRM
  • Attio
  • Keap
  • Twenty Cloud und selbst gehostetes Twenty
Twenty Cloud verwendet https://api.twenty.com. Für eine selbst gehostete Instanz ist die öffentliche HTTPS-URL des Twenty-Servers erforderlich. Private, Loopback-, Link-Local- und Cloud-Metadaten-Ziele werden abgelehnt.

​
HighLevel-Marketplace-App einrichten

Wähle Sub-account als Zielbenutzer und trage unter Advanced Settings → Auth exakt diese Redirect-URL ein:
Der neutrale Pfad ist beabsichtigt: Der Marketplace lehnt Redirect-URLs mit einer HighLevel-Markenreferenz ab. Wähle nur diese Scopes:
Hinterlege HIGHLEVEL_CLIENT_ID und HIGHLEVEL_CLIENT_SECRET in der Plattform-Umgebung und setze HIGHLEVEL_OAUTH_REDIRECT_BASE_URL=https://www.ouraicalling.de. Danach verwendest du Automations → Connections → HighLevel → Authorize HighLevel. Eine OAuth-Freigabe wird für CRM Sync und alle HighLevel-Automations-Nodes wiederverwendet; rotierende Access- und Refresh-Tokens werden automatisch aktualisiert. Die Kalender-Nodes listen Kalender und freie Zeiten und können Termine erstellen, aktualisieren oder stornieren. calendars.write wird absichtlich nicht angefordert, da die Integration keine Kalenderdefinitionen erstellt oder ändert. Trage unter Advanced Settings → Webhooks exakt diese Default Webhook URL ein:
Lasse die Custom Webhook URL bei den einzelnen Events leer, damit sie die Default-URL übernehmen. Aktiviere für CRM- und Termin-Automationen:
Nicht benötigte Conversation-, Rechnungs-, Produkt-, Zahlungs-, Voice-AI- oder Knowledge-Base-Events bleiben deaktiviert, bis ein Workflow sie benötigt. Der Endpoint prüft die aktuelle Ed25519-Signatur in X-GHL-Signature und unterstützt während der HighLevel-Übergangsphase zusätzlich die alte Signatur.

​
Sync anlegen

  1. Unter Automations → Connections eine API-Verbindung zum CRM anlegen. Kompatible Verbindungen tragen unter Verbindung hinzufügen den Tag CRM Sync.
  2. Audience → CRM Sync öffnen.
  3. Verbindung und CRM-Objekt beziehungsweise Quelle auswählen.
  4. CRM-Felder auf name, phone, email, tags oder ein eigenes Audience- Attribut wie custom.lifecycle_stage abbilden. Mehrere Quellfelder können demselben Ziel zugeordnet und kombiniert werden.
  5. Bis zu drei schreibgeschützte CRM-Beispiele nach der Zuordnung prüfen.
  6. Intervall wählen und den Sync starten.
Der Mapper schlägt Standardfelder vor und erkennt vorhandene eigene Attribute anhand ihres Namens. Mit Eigener Wert lassen sich CRM-Feld-Chips und Text in der gewünschten Reihenfolge kombinieren. So kann etwa Anrede + Vorname + Nachname den Wert name bilden und Ländervorwahl + Telefonnummer den Wert phone. Mindestens phone oder email ist erforderlich, damit der erste CRM-Datensatz sicher einem Audience-Kontakt zugeordnet werden kann. Für nationale Telefonnummern wird ein Standardland für Telefonnummern gewählt, zum Beispiel Deutschland. Vorschau und echter Lauf verwenden denselben länderabhängigen Parser und speichern E.164 (+49152…). Internationale Nummern mit + oder 00 ignorieren das Standardland. Stellt das CRM ein separates ISO-Land (DE) oder eine Ländervorwahl (+49) bereit, wird dieses Feld in derselben phone-Kombination vor dem Nummernfeld angeordnet. Ungültige Telefon- und E-Mail-Kombinationen werden bereits in der schreibgeschützten Vorschau markiert. Public API und MCP behalten die einfache Mapping-Struktur. Ein einzelnes Quellfeld bleibt ein normaler Feldschlüssel. Kombinationen verwenden sichere {{field}}-Tokens mit optionalem festem Text; es wird kein Code ausgeführt:
Ein CRM-Label- oder Tag-Feld kann auf tags abgebildet werden. Die normalisierten Tags werden in Kleinbuchstaben mit bestehenden manuellen Tags zusammengeführt und erscheinen direkt im Audience-Tag-Filter. Der erste Lauf importiert die ausgewählte Quelle. Folgeläufe verwenden, falls verfügbar, den Cursor des Anbieters. Anbieter ohne inkrementellen Cursor lesen die Quelle erneut und überspringen unveränderte Datensätze sicher. Läufe sind dauerhaft: Pagination, Wiederholungen und Checkpoints werden auch nach einem Server-Neustart fortgesetzt.

​
Sync bearbeiten

Über die Stift-Aktion auf einer Sync-Karte lassen sich Name, Objekt, Quelle, Intervall, Standardland und Feldzuordnung ändern. Danach erscheint dieselbe Vorschau der zugeordneten Daten wie beim Anlegen. Nur speichern behält den bestehenden Zeitplan bei. Speichern & synchronisieren speichert dieselben Änderungen und startet sofort einen manuellen Lauf. Wenn Objekt, Quelle oder Feldzuordnung geändert werden, wird der Anbieter-Cursor zurückgesetzt, damit der nächste Lauf die neue Zuordnung auch auf bestehende CRM-Datensätze anwendet.

​
Identität und Konflikte

Die stabile CRM-Datensatz-ID ist die primäre Identität. Die Plattform speichert eine Workspace-bezogene Verknüpfung zwischen dieser ID und dem Audience- Kontakt. E-Mail und Telefonnummer dienen nur für eine sichere erste Zuordnung. Mehrdeutige Treffer werden als Konflikt gemeldet, statt fremde Personen zusammenzuführen. CRM Sync löscht niemals einen Audience-Kontakt. Ein Full-Snapshot-Lauf kann die Sync-Mitgliedschaft von Datensätzen deaktivieren, die nicht mehr in der ausgewählten CRM-Quelle enthalten sind. Lokale Compliance-Daten wie Sperrliste und Einwilligungen werden nie durch CRM-Daten entfernt.

​
Ergebnisse zurückschreiben

Nach einem Anruf oder Qualifizierungsschritt kann eine CRM-Action in der Automation verwendet werden. Jedes unterstützte CRM besitzt – soweit die Anbieter-API es zulässt – Actions zum Suchen/Abrufen, Erstellen und Aktualisieren von Datensätzen. CRM-Webhook-Trigger starten Automationen aus Anbieterereignissen. HighLevel verwendet den globalen Marketplace-Endpoint oben; Verbindung und Ereignis werden in den Trigger-Einstellungen ausgewählt. Andere CRM-Anbieter verwenden derzeit die im Trigger angezeigte Automation-Webhook-URL und das Secret.

​
Public API und MCP

Dieselben Operationen stehen bereit über:
  • GET|POST /api/v1/crm-syncs
  • POST /api/v1/crm-syncs/discover
  • GET|PATCH|DELETE /api/v1/crm-syncs/{id}
  • GET|POST /api/v1/crm-syncs/{id}/runs
  • MCP-Tools zum Auflisten, Anlegen, Ändern, Löschen und Starten von CRM-Syncs
API-Keys benötigen automations:read beziehungsweise automations:write. Secrets und Anbieter-Tokens werden nie ausgegeben.