Embed-Referenz
Verwende Script und Web Component, übergib Headless-Prefill sicher und binde Website-Baukästen an.
Die Anleitung ohne technische Details findest du unter Einbinden auf der Website. Das aktuelle veröffentlichte Snippet und den Einbau-Prompt kopierst du aus Einbetten im Dashboard.
Script und Web Component
<booking-embed
src="https://book.calberry.ai/your-workspace/your-link"
lang="de"
></booking-embed>
<script type="module" src="https://book.calberry.ai/assets/embed.js"></script>Ersetze die Beispieladresse in src durch den veröffentlichten Calberry-Link. Das Modul bleibt auf derselben Buchungs-Origin. Die Komponente prüft Origin und Workspace-/Link-Pfad. Lade das Script einmal pro Seite; es definiert <booking-embed> und rendert in einem Shadow Root, ohne eigenes Iframe.
| Attribut | Aufgabe |
|---|---|
src | Veröffentlichte Buchungs-URL. Eine Änderung lädt den zugehörigen Link neu. |
lang | de oder en; übernimm die Sprache aus dem Dashboard-Snippet. Die geladene Buchungskonfiguration bestimmt die eigentliche Inhaltssprache. |
tracking-consent | Für Consent Mode weglassen; callback für ausdrückliche Banner-Callbacks oder host für bewusst an die Website delegierte Tag-Freigabe. |
Der umgebende Block braucht genügend Breite und eine mitwachsende Höhe. Das Formular-/Kalenderlayout richtet sich nach der Containerbreite. Die Content Security Policy deiner Website muss Script und Schriftdateien erlauben.
Ein separates npm-React-Paket steht derzeit nicht bereit. React-/Next.js-Seiten können dasselbe Modul im Browser laden und das Custom Element ausgeben. Baue die Buchungs-Engine nicht nach und löse bei Bestätigung keine zweite Buchung aus.
Headless-Prefill mit eigenem Formular
Der aktuelle Headless-Kalender liest die Query-Parameter leadId und leadToken aus src, genau in dieser Schreibweise. Eine Lead-ID allein reicht nicht.
- Stelle den Funnel auf Prefill / API und erfasse die konfigurierten Pflichtangaben in deinem Formular.
- Rufe serverseitig die dokumentierte Lead-Anlage mit privatem API-Schlüssel und Idempotenz-Key auf. Sie liefert
leadId,leadTokenund Validierungshinweise. API-Zugriff erfordert Pro. - Ergänze die zurückgegebenen Werte mit
URLundsearchParams.set()an der veröffentlichten Buchungsadresse. Setze diese alssrcdes Embeds. - Lass die Komponente Lead und Kalender laden und die Buchung abschließen. Behandle fehlendes oder ungültiges Prefill ausdrücklich, statt Daten einer anderen Person anzuzeigen.
Behandle leadToken als Zugang zu diesem Lead. Hinterlege persönliche Tokens weder fest in geteilten Snippets noch in Logs. Ein privater Workspace-API-Schlüssel ist kein Ersatz. Rohe Kontaktdaten gehören nicht in Query-Parameter.
Name und E-Mail bleiben Pflicht; Telefon richtet sich nach der Funnel-Einstellung. Die API verlangt das Nachfass-Flag, wobei false gültig ist. Headless speichert es als false und erzeugt keine Abbrecher-Timeouts. Erhalte bei einer vollständig eigenen API-Oberfläche Attribution, Pflichtantworten, Idempotenz und Buchungs-Aktionslinks. Die exakten Requests stehen in der generierten Referenz.
Aktuelle Kommunikationsangaben
Rufe bei einem Headless-Formular vor der Anzeige die anonyme communication-URL aus dem generierten Einbau-Prompt ab. Bei whatsappReminder=true zeigst du den vorgegebenen Reminder-Hinweis und coachName als Text unter dem Telefonfeld, ohne zusätzliche Checkbox. Verwende auf Deutsch „Terminerinnerungen erhältst du per WhatsApp von “ gefolgt von coachName, auf Englisch „You will receive appointment reminders via WhatsApp from “ gefolgt von coachName. Aktualisiere den Stand bei jeder neuen Formularanzeige. Calberrys eigenes Formular übernimmt seinen Hinweis selbst. Dieser Vertrag bedeutet keine aktuelle Aktivierbarkeit von WhatsApp; WhatsApp ist demnächst verfügbar.
WordPress, Webflow und Framer
Verwende einen HTML-/Code-Block, der Modul-Scripts erhält. Prüfe die veröffentlichte Website, weil Editor-Vorschauen Scripts unterdrücken können. In WordPress braucht die zweispaltige Ansicht einen breiten Block. In Webflow muss das Embed vor dem Test veröffentlicht sein.
Framer zeigt HTML-Embeds in einem Frame. Stelle für Desktop und Mobil ausreichend Höhe ein. Tracking auf der Elternseite braucht den unterstützten direkten gleichursprünglichen srcdoc-Kontext; opaque oder fremde Frames leiten keine Ereignisse weiter. Verbinde die tatsächliche Bannerentscheidung mit dem Kind-Embed. Das Warten auf das Custom Element im Elternfenster wartet nicht auf das Kind.
Siehe Tracking-Ereignisse und Consent und die vorhandenen herstellerspezifischen Tracking-Rezepte.
Testen und Fehler finden
Ein normales Embed erzeugt echte Buchungen. sandbox in seiner URL aktiviert keinen Testmodus. Für Sandbox-Prüfungen verwendest du die gesonderte Testbuchungsseite aus dem Dashboard und prüfst das Ergebnis unter Termine → Testbuchungen.
Bleibt die Komponente leer, prüfe Script-Laden, veröffentlichtes src, Origin, HTML-Bereinigung und Container-/Frame-Abmessungen. Lädt sie ohne freie Termine, prüfe die Verfügbarkeit. Durch Consent gesperrte Analytics-Ereignisse sind von der Buchungsfunktion getrennt.