VoxOn Booking API – Technische Dokumentation

Voice Tool

voxon_booking

API Base URL

https://api.telefoniere.online/api

Frontend

app.telefoniere.online/app/apps/booking

Stand

2026-02-22

Grundlagen / Funktionsübersicht

VoxOn Booking stellt alle Kernfunktionen für UI, API und Voice-Agent bereit:

Reservierungen inkl. Pending- und Approval-Flow
Verfügbarkeit mit Kapazitäts- und Tischbezug
Floorplan-Management mit Drag-and-Drop Positionen
Warteliste, Notifications, Export/Import und Analytics

Reservierungsstatus

pendingconfirmedarrivedcompletedcancelledno_show

Buchungsquellen

voicewebstaff

Basis & Authentifizierung

Alle Endpunkte verwenden Bearer-Token Authentifizierung.

Authorization: Bearer <token>

Vor dem Schreiben von Reservierungen muss das Restaurant-Profil vollständig sein. Bei fehlenden Pflichtfeldern wird PROFILE_INCOMPLETE zurückgegeben.

Profil / Setup

Pflichtfeld-Check und Pflege der Restaurant-Stammdaten.

Methode	Endpoint	Beschreibung
GET	`/apps/booking/profile-check`	Pflichtfelder und Vollständigkeit prüfen
PUT	`/apps/booking/profile` Body: companyName, phone, email, street, zip, city	Stammdaten aktualisieren

Reservierungen

CRUD, Statuswechsel, Approval und Tischzuweisung.

Methode	Endpoint	Beschreibung
GET	`/apps/booking/reservations`	Reservierungen auflisten · Query: date, startDate, endDate, status, locationId, mealType, limit, offset
GET	`/apps/booking/reservations/:id`	Einzelreservierung laden
POST	`/apps/booking/reservations` Body: date, time, guestName, partySize (Pflicht)	Reservierung anlegen
PUT	`/apps/booking/reservations/:id`	Reservierung ändern
DELETE	`/apps/booking/reservations/:id`	Reservierung löschen
PATCH	`/apps/booking/reservations/:id/status` Body: { status }	Status setzen
POST	`/apps/booking/reservations/:id/approve` Body: optional tableIds	Pending-Anfrage annehmen
POST	`/apps/booking/reservations/:id/decline` Body: optional toWaitlist, reason	Pending-Anfrage ablehnen
POST	`/apps/booking/reservations/:id/assign-table`	Tischzuweisung setzen

Verfügbarkeit

Freie Slots und Kapazitätsprüfung mit Tisch-Details.

Methode	Endpoint	Beschreibung
GET	`/apps/booking/availability`	Freie Slots ermitteln · Query: date (Pflicht), time, partySize, locationId

Tische & Floorplan

Tischverwaltung, Live-Belegungsplan, Sperren und freie Objekte.

Methode	Endpoint	Beschreibung
GET	`/apps/booking/tables`	Tische auflisten · Query: locationId
POST	`/apps/booking/tables` Body: locationId, number	Tisch anlegen
PUT	`/apps/booking/tables/:id`	Tisch bearbeiten
DELETE	`/apps/booking/tables/:id`	Tisch löschen
GET	`/apps/booking/tables/floor-plan`	Tagesfloorplan mit Belegung · Query: date (Pflicht)
POST	`/apps/booking/tables/batch-positions`	Drag-and-Drop Positionen speichern
POST	`/apps/booking/table-blocks` Body: tableIds, fromDate, toDate, recurrence?	Sperre anlegen
GET	`/apps/booking/table-blocks`	Sperren auflisten · Query: fromDate, toDate
DELETE	`/apps/booking/table-blocks/:id`	Sperre löschen
GET	`/apps/booking/floor-objects`	Freie Objekte auflisten · Query: locationId
POST	`/apps/booking/floor-objects` Body: locationId, type	Objekt anlegen

Standorte & Gäste

Methode	Endpoint	Beschreibung
GET	`/apps/booking/locations`	Standorte auflisten
POST	`/apps/booking/locations` Body: name (Pflicht)	Standort anlegen
GET	`/apps/booking/guests`	Gästeliste · Query: search, isVip, limit, offset
POST	`/apps/booking/guests` Body: name (Pflicht)	Gast anlegen

Warteliste

Methode	Endpoint	Beschreibung
GET	`/apps/booking/waitlist`	Warteliste auflisten · Query: date, status, locationId, limit, offset
POST	`/apps/booking/waitlist` Body: guestName, date, preferredTime	Eintrag anlegen

Settings

Methode	Endpoint	Beschreibung
GET	`/apps/booking/settings`	Einstellungen laden
PUT	`/apps/booking/settings`	Einstellungen speichern

Export / Import

Methode	Endpoint	Beschreibung
GET	`/apps/booking/export/reservations`	Reservierungen exportieren · Query: format=csv\|pdf
GET	`/apps/booking/export/guests`	Gäste exportieren · Query: format=csv\|pdf
GET	`/apps/booking/import/template`	CSV-Importvorlage laden
POST	`/apps/booking/import/guests` Body: multipart/form-data oder raw CSV	Gäste per CSV importieren

Analytics & Notification Logs

Methode	Endpoint	Beschreibung
GET	`/apps/booking/analytics/utilization`	Auslastung · Query: period=day\|week\|month\|quarter\|year
GET	`/apps/booking/analytics/summary`	Tageszusammenfassung · Query: date (Pflicht)
GET	`/apps/booking/notification-logs`	Versand- und Kostenlogs · Query: limit, cursor, from, to, channel

Cron / Admin

Automatisierte Erinnerungen und Digest-Jobs.

Methode	Endpoint	Beschreibung
POST	`/apps/booking/cron/reminders`	Fällige Erinnerungen verarbeiten
POST	`/apps/booking/cron/hourly-digest`	Stündlichen Digest versenden
POST	`/apps/booking/cron/daily-digest`	Täglichen Digest versenden

Voice Agent – voxon_booking

Zentrales Voice-Tool für Reservierungsanfragen aus dem KI-Bot-Editor. Unterstützt Hold/Pending-Flow für sichere Buchungsabschlüsse. Response enthält strukturierte Status- und Routinginformationen.

Tool Type

voxon_booking

HTTP Methode

POST

Flow

Hold → Pending → Confirm

Typischer Voice-Flow

Verfügbarkeit prüfen→

Reservation erstellen→

optional Approval→

Bestätigung