Hilfe-Center

Buchungsformular per URL-Parameter vorausfüllen

Lesezeit etwa 3 Minuten.

Kurz gesagt: Mit Parametern am Buchungslink oder mit „data-“-Attributen im Einbettungscode füllst du Kundendaten und eigene Felder im Buchungsformular automatisch aus. Das spart Kunden Eingaben und passt zu personalisierten Links.

Das brauchst du

  • Die Adresse deiner Buchungsseite oder dein Einbettungscode
  • Für eigene Felder: die ID des Feldes (Custom Field ID)

Schritt für Schritt

  1. Kundendaten an den Buchungslink hängen

    Hänge die Parameter mit ? und & an die Adresse deiner Buchungsseite. Das Formular liest sie beim Öffnen und füllt die passenden Felder aus. Das funktioniert bei direkten Buchungslinks, bei Seiten für eine bestimmte Leistung oder einen bestimmten Mitarbeiter und bei der eingebetteten Buchung.

    • customerFirstName: Vorname
    • customerLastName: Nachname
    • customerEmail: E-Mail-Adresse
    • customerPhone: Telefonnummer, im internationalen Format mit Ländervorwahl

    Beispiel:

    ADRESSE-DEINER-BUCHUNGSSEITE/booking?customerFirstName=John&customerLastName=Doe&customerEmail=johndoe@gmail.com&customerPhone=+1212555

    Leerzeichen in Werten kodierst du mit +. Bereits vom Kunden ausgefüllte Felder werden nicht überschrieben.

  2. Eigene Felder vorausfüllen

    Eigene Felder füllst du mit dem Parameter customFields vor. Der Wert ist ein JSON-Objekt: Der Schlüssel ist die ID des Feldes, der Wert der Inhalt, den du vorausfüllen willst.

    ADRESSE-DEINER-BUCHUNGSSEITE/booking?customerEmail=johndoe@gmail.com&customerFirstName=John&customerLastName=Doe&customFields={"3":"111"}

    Mehrere Felder trennst du im JSON-Objekt mit Komma:

    ADRESSE-DEINER-BUCHUNGSSEITE/booking?customerEmail=johndoe@gmail.com&customerFirstName=John&customFields={"1":"Test+Value","2":"Another"}

  3. Seiten für Leistung oder Mitarbeiter

    Auf Buchungsseiten für einen Mitarbeiter oder eine Leistung gelten dieselben Parameter, sie werden einfach an den längeren Link angehängt. Beispiel für einen Mitarbeiter:

    ADRESSE-DEINER-BUCHUNGSSEITE/booking/e/john-doe?t=s&uuid=5d19bf1e-81dd-43b3-8fab-5203b64e7a8a&customerFirstName=Johanna&customerLastName=Miller&customerEmail=johanna.miller@gmail.com&customerPhone=+14155550198&customFields={"12":"Yes","11":"24"}

  4. In der eingebetteten Buchung

    Bei der eingebetteten Buchung gibst du die Werte als „data-“-Attribute am Haupt-Container an. Das ist praktisch, wenn deine Website die Kundendaten schon kennt. Beispiel (die Zeile mit dem script-Tag gehört zu deinem Einbettungscode und bleibt, wie sie dort steht):

    <div class="embedded-booking" data-url="ADRESSE-DEINER-BUCHUNGSSEITE" data-query="&t=s&uuid=303bad05-6504-417b-b0fc-a2635ec46c9a" data-employee="john-doe" data-lang="en" data-customer-email="johanna.miller@example.com" data-customer-first-name="Johanna" data-customer-last-name="Miller" data-customer-phone="+14155550198" data-custom-fields='{"12": "Yes", "11": "24", "100": "CUST-9001"}' style="min-width: 320px; height: 768px;"></div>

    Eigene Felder übergibst du mit data-custom-fields. Der Wert muss ein gültiger JSON-String sein: Schlüssel ist die ID des eigenen Felds, Wert der Inhalt. Das geht für sichtbare und versteckte Felder.

  5. Interne Daten übergeben, zum Beispiel eine Kunden-ID

    Willst du intern eine Kennung wie eine Kunden-ID mitgeben, die der Kunde nicht sehen soll:

    1. Lege ein eigenes Feld an, zum Beispiel „Customer ID“, und notiere dir die Feld-ID.
    2. Blende das Feld im Buchungsformular mit eigenem CSS aus.
    3. Übergib den Wert über customFields im Link oder über data-custom-fields in der Einbettung, zum Beispiel data-custom-fields='{"100": "CUST-9001"}'.

    Der Wert wird mit der Buchung gespeichert und steht für internes Tracking, den Abgleich mit deinem CRM oder Integrationen bereit.

Wenn es nicht klappt

Ein Wert erscheint nicht im Formular

Prüfe diese Punkte:

  • Die Parameter müssen URL-kodiert sein.
  • Die Feld-IDs müssen mit den IDs in deinem BOOKING-Konto übereinstimmen.
  • Felder, die der Kunde schon selbst ausgefüllt hat, werden nicht überschrieben.
  • Ungültige oder unbekannte Parameter werden ohne Hinweis ignoriert.

Hat dir das geholfen?