Docs

CRM anbinden

Lege Kontakte und Terminaktivitäten über Workspace-Webhooks, Make, Zapier oder deinen eigenen Empfänger an und aktualisiere sie.

Nutze Workspace-Webhooks mit eigenem Empfänger oder die Rezepte für Make und Zapier. Das gilt auch für Close: Eine native Close-Anbindung mit Ergebnis-Rücksync bietet Calberry derzeit nicht.

Fachliche Wirkungen auswählen

Starte mit einem kleinen Mapping:

Calberry-EreignisMögliche CRM-Aktion
lead.capturedKontakt suchen/anlegen oder Anfrage speichern; eine Buchung muss noch nicht existieren.
booking.createdTerminaktivität anhand der Calberry-Buchungs-ID anlegen oder aktualisieren.
booking.rescheduledZeit und Status derselben Aktivität ändern.
booking.cancelled / booking.expiredAktivität als abgesagt/verfallen markieren, ohne ihre Historie zu löschen.
lead.abandonedStatus speichern; nur bei ausdrücklicher Einwilligung im Ereignis nachfassen.
lead.convertedAnfrage als konvertiert markieren; keinen zweiten Termin erzeugen, wenn booking.created ihn bereits angelegt hat.
booking.completedGeplanten Zeitraum als beendet markieren, ohne Teilnahme oder Verkauf zu unterstellen.

Das sind Entscheidungen deiner Anbindung, keine weiteren Calberry-Ereignisse. Baue keine No-Show- oder Disqualifizierungs-Trigger auf reservierten Ereignisnamen auf.

Kennungen auseinanderhalten

event_id dient der Deduplizierung von Zustellung und Wirkung. data.lead.id verknüpft Lead-Vorgänge; data.booking.id identifiziert den Termin. Bedient deine Anbindung mehrere Workspaces, gehört data.workspace_id in den Zuordnungsschlüssel.

Zum Abgleich vorhandener CRM-Kontakte normalisierst du die E-Mail nach den Regeln deines Ziels und begrenzt die Suche auf das richtige Konto. Speichere die Zuordnung von Calberry-IDs zu CRM-IDs. Ein neues Ereignis darf keinen doppelten Deal erzeugen, nur weil dieselbe E-Mail in einem anderen Workspace existiert.

Nur benötigte Daten übertragen

Ordne vorhandene data.lead-Kontaktfelder, ausgewählte data.answers, Terminzeit/Zeitzone/Status und relevante data.attribution-Werte zu. data.consent ist die eingefrorene boolesche Nachfass-Einwilligung für Abbrecher und keine allgemeine Marketing-Einwilligung. Für fehlende oder null gesetzte Felder braucht es eine ausdrückliche Zielregel, statt vorhandene Werte pauschal zu löschen.

Öffentliche Nutzdaten enthalten weder Meet- noch Buchungs-Aktionslinks. Braucht deine Anbindung aktuelle Buchungsdetails, lies sie mit passenden Scopes über die API. Den Vertrag enthält die generierte Referenz.

Prüfen und wiederaufnehmen

Prüfe die Signatur vor Parsing und Geschäftsaktion, schließe Testereignisse aus und speichere angenommene Ereignisse dauerhaft. Nutze einen atomaren eindeutigen Ereignisschlüssel und Abschlussbelege je Wirkung oder idempotente Upserts im Ziel. Ein Absturz nach dem CRM-Schreiben, aber vor der Abschlussmarkierung darf beim Retry keine doppelte Aktivität erzeugen.

Verlasse dich nicht auf eine vollständige Ereignisreihenfolge. Vergleiche Zeitstempel mit dem zuletzt angewendeten Stand oder gleiche den aktuellen Zustand über die API ab. Beachte die begrenzte Reihenfolgegarantie.

Teste doppelte Zustellung, Umbuchung, Absage, einen Zielfehler und Replay. Prüfe, dass false-Consent kein Abbrecher-Nachfassen startet. Halte angenommene, aber im CRM fehlgeschlagene Ereignisse in einer eigenen Fehlerwarteschlange vor.

Verantwortung für Daten

Calberry speichert Lead- und Buchungsdaten in der EU. Kopien im CRM liegen an dessen Speicherorten und können die EU verlassen. Übertrage nur benötigte Felder, beschränke Zugangsdaten/Zugriffe und berücksichtige das Ziel in Datenschutzhinweisen und Aufbewahrung. Das Ausblenden eines Kontakts in Calberry löscht keine bereits übermittelte CRM-Kopie.

Auf dieser Seite