API für KI-Agenten

Für Assistenten wie ChatGPT, Claude oder Gemini, die im Auftrag eines Gastronomen handeln · Stand: 25.10.2026

Über diese Schnittstelle kann ein KI-Agent freie Beratungstermine abfragen, einen Termin buchen oder eine Anfrage für eine digitale Speisekarte senden. Es gibt drei Endpunkte, alle mit JSON. Ein Mensch bei Velo Automation beantwortet jede Anfrage schriftlich.

Überblick

Basis-Adresse: https://forms.velo-automation.de
Authentifizierung: keine. Kein API-Key, kein Login, kein Captcha.
Format: Anfragen und Antworten in JSON (Content-Type: application/json), Zeiten in deutscher Ortszeit (Europe/Berlin).
Maschinenlesbare Beschreibung: openapi.json, verlinkt im API-Katalog nach RFC 9727. Eine Kurzfassung steht in der llms.txt.
Diese Seite als Markdown: /api.md, oder diese Adresse mit Accept: text/markdown abrufen.

Freie Beratungstermine abrufen

GET /api/v2/beratung/slots?date=YYYY-MM-DD liefert die freien Uhrzeiten eines Tages. Ein Termin dauert 30 Minuten und findet online statt (Zoom oder Microsoft Teams). Angeboten werden Montag bis Freitag 16:30 bis 20:00 Uhr und Samstag 10:00 bis 18:00 Uhr, frühestens 24 Stunden und höchstens 21 Tage im Voraus. Für Tage außerhalb dieses Rahmens kommt eine leere Liste zurück.

curl -sS "https://forms.velo-automation.de/api/v2/beratung/slots?date=2026-11-03"

Antwort:

{"date": "2026-11-03", "slots": ["16:30", "17:00", "17:30"]}

Beratungstermin buchen

POST /api/v2/forms/beratung bucht eine Uhrzeit aus der Liste oben. Die Bestätigung mit dem Meeting-Link geht per E-Mail an die angegebene Adresse.

Pflicht: name, email, firma (Name des Betriebs), date (YYYY-MM-DD), time (HH:MM aus den freien Zeiten)
Optional: platform (zoom oder teams, Standard zoom), topic (worum es gehen soll)
Nicht senden: ein Feld website. Es dient als Spamschutz: Eine Buchung mit diesem Feld wird mit ok beantwortet, aber nicht eingetragen.

curl -sS -X POST "https://forms.velo-automation.de/api/v2/forms/beratung" \
  -H "Content-Type: application/json" \
  -d '{"name": "Anna Beispiel", "email": "anna@beispiel-gasthaus.de",
       "firma": "Gasthaus Beispiel", "platform": "zoom",
       "date": "2026-11-03", "time": "17:00",
       "topic": "Digitale Speisekarte mit Allergenen"}'

Antwort bei Erfolg: {"ok": true, "mode": "booking"}. Fehler kommen mit Status 400 und einem Text, an dem sich die Anfrage korrigieren lässt:

{"ok": false, "error": "Pflichtfelder fehlen"}: name, email, firma, date oder time fehlt.
{"ok": false, "error": "Slot nicht mehr frei"}: Die Uhrzeit ist nicht (mehr) in der Liste. Freie Zeiten neu abrufen.
{"ok": false, "error": "Slot gerade belegt"}: Jemand war schneller. Eine andere Uhrzeit wählen.

Anfrage oder Angebot anfordern

POST /api/v2/forms/velomenu schickt eine Anfrage ohne Termin, zum Beispiel für ein Angebot. Das Angebot kommt innerhalb eines Werktags per E-Mail, dazu sofort eine Eingangsbestätigung.

Felder: name, email, firma, nachricht, dazu source mit dem Wert form-velomenu-landing
Hilfreich in der Nachricht: Art des Betriebs, Zahl der Tische, ob Einmalkauf oder Full-Service, wo die aktuelle Karte zu finden ist

curl -sS -X POST "https://forms.velo-automation.de/api/v2/forms/velomenu" \
  -H "Content-Type: application/json" \
  -d '{"name": "Anna Beispiel", "email": "anna@beispiel-gasthaus.de",
       "firma": "Gasthaus Beispiel", "source": "form-velomenu-landing",
       "nachricht": "Pizzeria, 14 Tische, Interesse am Full-Service."}'

Antwort: {"ok": true}. Eine Anfrage ganz ohne Angaben wird mit {"ok": true, "ignored": "leere Einsendung"} beantwortet und nicht bearbeitet.

Regeln für Agenten

Nur im Auftrag eines echten Betriebs buchen oder anfragen, mit dessen echten Kontaktdaten. Bitte keine Testbuchungen: Jeder Termin landet in einem echten Kalender.
Kontakt läuft schriftlich, per E-Mail oder über diese API. Telefonnummern werden nicht abgefragt.
Preise, Pakete und Vertragsbedingungen stehen auf der Startseite, unter Vertrag auf einen Blick und in den AGB. Was mit den übermittelten Daten passiert, erklärt die Datenschutzerklärung.
Fragen zur API: markus@velomenu.info