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 — mit Audit-Log und klaren Rollenrechten.

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-Integration vorhanden? Wir prüfen euren Wechselpfad.

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 →

Häufige Fragen

Kurz und verbindlich eingeordnet.

Antworten zum aktuellen Produktstand, zu Konditionen und zum nächsten sinnvollen Schritt.

Ist API und Integrationen bereits öffentlich im Self-Service buchbar?

Nein. Hey-Gastroline kommuniziert aktuell frühen Zugang mit persönlich begleitetem Start. Welche Module verfügbar sind, wird vorab anhand eurer Anforderungen bestätigt.

Was kostet API und Integrationen?

Die finale öffentliche Paketlogik ist noch nicht freigegeben. Ihr erhaltet vor dem Start ein individuelles Angebot mit Preis, Leistungsumfang, Laufzeit und Kündigungsregelung.

Wie wird API und Integrationen eingerichtet?

Der Start wird aktuell persönlich begleitet. Benötigte Daten, Konfiguration, Zuständigkeiten und ein realistischer Zeitplan werden vor dem Go-live gemeinsam festgelegt.

Welche Datenschutzangaben gelten für API und Integrationen?

Hey-Gastroline setzt auf Hosting in Deutschland und Datenschutz by Design. Verbindlich sind der konkrete Vertrag, die vereinbarten Rollen, Subdienstleister und technischen Maßnahmen.

Kann API und Integrationen vorab geprüft werden?

Ja. In der Demo klären wir den gewünschten Ablauf und zeigen die passenden Produktbereiche. Eine öffentliche Test- oder Erfolgsgarantie ist damit nicht verbunden.

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