Funktion · API & Integrationen

Schnittstellen für Voice-KI,
aber nicht als Selbstbedienungs-Versprechen.

Hey-Gastroline hat eine Voice-API, Knowledge-Snapshots und Webhooks. Zum Launch richten wir solche Integrationen begleitet ein, damit Auth, Datenmodell, Consent und Betriebsverantwortung klar sind.

Voice-Bot-API · begleitet

Voice-Integrationen werden geprüft, nicht blind versprochen.

Für externe KI-Telefonassistenten prüfen wir die bestehende Integration, mappen die nötigen Endpunkte und aktivieren nur das, was im konkreten Restaurant-Setup zuverlässig funktioniert.

KI Voice Bot API Basic Auth Basis-URL: https://app.hey-gastroline.ai

GET /api/hey-listen/openingHours Öffnungszeiten abrufen

POST /api/hey-listen/bookings Reservierung erstellen

GET /api/hey-listen/availability Verfügbarkeit prüfen

GET /api/hey-listen/guests/lookup Gast nach Telefon/E-Mail nachschlagen

Resos-Wechsler: Wir prüfen vor der Migration eure aktuelle Voice-Bot-Integration und identifizieren Endpoints, die gemappt oder angepasst werden müssen.

Voice-AI · Erweiterte Tiefe

Für tiefe KI-Telefonassistent-Integrationen — Knowledge-Snapshot, Menu-Concierge, Handoff-Logik.

Wer mehr will als Reservierung anlegen, kann den vollen Hey-Gastroline-Voice-Stack anbinden: ETag-gecachter Restaurant-Wissens-Snapshot, Concierge-Antworten auf Basis eurer Speisekarte, Caller-Lookup mit Caller-ID-Match, und eine separate Handoff-Decision-API, die der KI sagt, ob sie weitermachen oder an einen Menschen übergeben soll.

Knowledge-Snapshot Basic Auth Cache: ETag · max-age 300 · stale-while-revalidate 3600

GET /api/hey-listen/voice/knowledge Versionsierter Restaurant-Wissens-Snapshot (Öffnungszeiten, Karte, Regeln)

POST /api/hey-listen/voice/knowledge/rebuild Snapshot neu erzeugen + Webhook-Notify

Menu-Concierge Basic Auth Voraussetzung: Voice + Digital-Menüs + Concierge-Addon

POST /api/hey-listen/voice/menu/assistant Frage stellen, Antwort auf Basis eurer gepflegten Speisekarte, Guardrails und Allergen-Disclaimer eingebaut

Reservierung · live Basic Auth Atomare DB-Transaktion mit Tisch-Lock

GET /api/hey-listen/voice/availability Verfügbarkeit prüfen mit Slot-Vorschlägen ±3h

POST /api/hey-listen/voice/bookings Reservierung anlegen mit Idempotency-Key-Support

GET /api/hey-listen/voice/caller-lookup Caller-ID matchen, Gäste-Profil + letzte Buchung zurückgeben

GET /api/hey-listen/voice/reservations/lookup Reservierung über Telefonnummer + Datum/Uhrzeit finden

PATCH /api/hey-listen/voice/reservations/:id/reschedule Umbuchung mit Frist-Prüfung

DELETE /api/hey-listen/voice/reservations/:id/cancel Storno mit Frist-Prüfung, triggert ggf. Rebooking-Engine

Voice-Order & Handoff Basic Auth Voraussetzung: Voice + Order-Addon + Concierge-Ordering-Schalter

POST /api/hey-listen/voice/orders Bestellung nur bei aktivem Order-Setup aufnehmen, mit Zahlungs- oder Cash-Pfad

GET /api/hey-listen/voice/orders/status Live-Bestellstatus für Gast-Anfragen (neu/angenommen/in Zubereitung/bereit/abgeschlossen/in Lieferung)

POST /api/hey-listen/voice/handoff/decision Handoff-Entscheidung anfragen: weiter selbst bedienen oder an Menschen übergeben?

Auth-Pattern: Basic Auth mit restaurantSlug als Username und Voice-Bot-API-Key als Passwort. Schlüssel werden im Restaurant-Dashboard erzeugt und können rotiert werden. Rate-Limit gilt pro API-Key. Idempotenz: alle Schreib-Endpunkte akzeptieren einen Idempotency-Key-Header — doppelte Anfragen werden nicht doppelt ausgeführt, auch bei Netz-Wackelei.

REST-API · auf Anfrage

Für eigene Tools, Reports und Integrationen — begleitet statt offenem Self-Service.

API-Keys und Webhooks sind technisch vorgesehen. Ob und wie sie öffentlich nutzbar sind, klären wir zum Launch je nach Anwendungsfall.

Buchungen lesen + schreiben

Listen, Filtern, Anlegen, Ändern, Stornieren. Mit allen Hey-Gastroline-Feldern: Risk-Score, Source, locale, Stripe-Auth-Status.

Gäste-Datenbank

Vollständiger CRUD-Zugriff auf Gäste-Profile, Buchungshistorie, Allergien, Sprachen, Stammgast-Status — DSGVO-konform mit Audit-Log.

Verfügbarkeit & Tisch-Status

Live-Abfrage: welcher Tisch ist wann frei. Inklusive Pausen-Zeiten und Hochlast-Begrenzungen. Ideal für eigene Buchungs-Frontends.

Statistiken & Reports

Channel-Mix, No-Show-Rate, Auslastung, Stammgast-Quote. Aggregierte Werte und Rohdaten für eure BI-Tools.

Ausgehende Webhooks

Events wie booking.created, booking.cancelled, guest.updated werden an eure Endpoints geschickt. Mit Retry bei 5xx-Fehlern und HMAC-Signatur.

OAuth2 für Multi-Standort

Für Restaurant-Gruppen mit mehreren Standorten: OAuth2-Flow auf Anfrage. Ein Token, alle Standorte, getrennte Berechtigungen.

Beispiel

Eine Buchung per API anlegen.

curl-Beispiel

curl -X POST "https://app.hey-gastroline.ai/api/hey-listen/bookings" \
  -H "Authorization: Basic $BASE64_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "guestName": "Linda Becker",
    "guestPhone": "+49 152 1234567",
    "partySize": 4,
    "startTime": "2026-05-20T20:00:00",
    "durationMinutes": 90,
    "source": "ai_phone",
    "locale": "de"
  }'

Antwort: 201 Created mit Buchungs-ID, Tisch-Zuweisung und SMS-Confirmation-Status. Vollständig dokumentiert im Admin-Dashboard unter „API-Dokumentation".

Resos-Refugee mit Voice-Bot? Wir migrieren euch in 48 Stunden.

Im Call zeigen wir die Resos-API-Kompatibilität und prüfen eure spezifische Integration. Wenn nötig ergänzen wir fehlende Endpoints vor dem Go-Live.

Jetzt ausprobieren vs. Resos im Vergleich →

Schnittstellen für Voice-KI, aber nicht als Selbstbedienungs-Versprechen.