Auf deiner Website einbinden, Website-Daten übernehmen, Google und Für Entwickler
Binde Buchungen und Veranstaltungen auf deiner Website ein, übernimm Website-Daten und nutze unter „Für Entwickler“ API und Webhooks (automatische Benachrichtigungen an andere Systeme).
- Rollen
- owner, manager, staff
- Benötigte Module
- embeds.website
- Zuletzt fachlich geprüft
Worum es geht
So kommt vsmBooking auf deine Website und in andere Systeme, ohne dass Daten deines Betriebs ungeschützt sind. Erlaubte Websites, Zugangscodes, Signaturen und Paketumfang werden serverseitig geprüft.
Voraussetzungen
- Die Buchung auf deiner Website und – für Entwickler – Webhooks sind in deinem Paket enthalten.
- Du kontrollierst die Ziel-Domain und kannst den Einbaucode ändern.
- Für „Website-Daten übernehmen“ und Google sind deine Domain und dein Google-Zugang im richtigen Betrieb eingerichtet.
- API-Zugangsdaten werden ausschließlich über den sicheren Credential-Workflow erzeugt.
Schritt für Schritt
Integrationsart wählen
Nutze den Einbaucode für Buchung und Veranstaltungen auf deiner Website, „Website-Daten übernehmen“ für kontrollierte Inhaltsübernahme, Google für dein Unternehmensprofil und – für Entwickler – API und Webhooks zur Anbindung anderer Systeme.
Erwartetes Ergebnis: Die gewählte Integration passt zum Zweck und benötigt keine unnötig breiten Rechte.Domain oder Origin bestätigen
Trage die exakte HTTPS-Origin ein, führe die vorgesehene Prüfung durch und entferne veraltete Domains. Wildcards nur verwenden, wenn der Vertrag sie ausdrücklich unterstützt.
Erwartetes Ergebnis: Nur die eingetragene Website kann den Einbaucode verwenden; er gilt dauerhaft, bis du ihn widerrufst.Vorschau und Einbau testen
Öffne Website-Vorschau, kopiere den erzeugten Code in eine Testseite und durchlaufe den Hauptweg auf Desktop und Mobilgerät.
Erwartetes Ergebnis: Die eingebaute Buchung passt ihre Höhe an, Aktionen funktionieren und nicht freigegebene Websites werden abgelehnt.Sync oder Profiländerung prüfen
Vergleiche erkannte und bestehende Inhalte. Übernimm Änderungen einzeln beziehungsweise in der vorgesehenen Auswahl und kontrolliere den Verlauf.
Erwartetes Ergebnis: Keine Website- oder Google-Daten werden ohne sichtbare Zustimmung überschrieben.API/Webhook validieren
Erzeuge minimal berechtigte Zugangsdaten, verwende die Developer-Portal-Verträge und teste Webhooksignatur, Retry und Idempotenz in einer Testumgebung.
Erwartetes Ergebnis: API-Aufruf und Webhook liefern den dokumentierten Status, ohne Secrets im Log oder Frontend zu zeigen.
So sieht es aus
Einbaucode nur für freigegebene Websites
Der Betreiber trägt die Adresse seiner Website ein. Der Einbaucode ist an diese Website gebunden und gilt dauerhaft, bis er unter „Deine Einbaucodes“ widerrufen wird; auf einer anderen Website wird er abgelehnt.
Themes dürfen Darstellung ändern, aber keine Preis-, Betriebs- oder Buchungslogik überschreiben.
Website-Daten übernehmen und Google-Unternehmensprofil
Importe und Abgleiche zeigen Quelle, Ziel, Unterschied und geplante Aktion. Hintergrundjobs verarbeiten Prüfung, Import und Erinnerungen; der sichtbare Verlauf bleibt maßgeblich.
API, Credentials und Webhooks
Das Entwicklerportal (für Entwickler) dokumentiert Methoden, Authentifizierung, benötigte Paketfunktionen, Anfragen, Antworten und Fehler. Das Benutzerhandbuch erklärt den Betriebsablauf, ersetzt aber nicht die vollständige API-Referenz.
Webhookempfänger verifizieren Signatur und Zeitfenster und verarbeiten Ereignisse idempotent. Rohpayloads können personenbezogene Daten enthalten und gehören nicht in öffentliche Logs.
Wenn etwas nicht funktioniert
Die eingebaute Buchung bleibt leer oder meldet „Website nicht erlaubt“.
- Wahrscheinliche Ursache
- Schema, Host oder Port weicht von der freigegebenen Origin ab oder die Session wurde für einen anderen Host erzeugt.
- Sichere Lösung
- Kopiere die Origin exakt aus der Browseradresse, speichere sie im Dashboard und erzeuge Vorschau/Session neu.
Webhook wird wiederholt zugestellt.
- Wahrscheinliche Ursache
- Empfänger bestätigt nicht rechtzeitig oder verarbeitet Delivery-ID nicht idempotent.
- Sichere Lösung
- Antwort schnell mit Erfolg nach sicherer Annahme, speichere Delivery-ID und entkopple langsame Folgearbeit.
„Website-Daten übernehmen“ zeigt unerwartete Änderungen.
- Wahrscheinliche Ursache
- Quelle oder Mapping hat sich geändert oder die Prüfung vergleicht einen anderen Standort.
- Sichere Lösung
- Übernimm nichts pauschal. Prüfe Domain, Standort und jede Differenz in der Vorschau.
Beschriebene Produktoberflächen
/dashboard/embeds/dashboard/website-import/dashboard/google-business/embed-preview/developers