Voice Agent - Gasthaus Stern

📡 System-Status

Backend (FastAPI)

Prüfe...

PostgreSQL

Prüfe...

Twilio (Telefonie)

Prüfe...

Deepgram (STT)

Prüfe...

Claude API (LLM)

Prüfe...

ElevenLabs (TTS)

Prüfe...

🏗 So funktioniert's

1

Anruf eingehend

Ein Gast ruft die Restaurant-Nummer an. Twilio nimmt den Anruf entgegen und leitet den Audio-Stream per WebSocket an unseren Server weiter.

TwilioWebSocket

2

Sprache zu Text

Der Audio-Stream wird in Echtzeit transkribiert. Deepgram erkennt automatisch ob Deutsch oder Englisch gesprochen wird.

Deepgram STTDE / EN

3

KI-Gesprächsführung

Claude versteht die Anfrage des Gastes, prüft die Tischverfügbarkeit in der Datenbank und führt das Gespräch natürlich – inklusive Rückfragen, Alternativen und Bestätigung.

Claude APITool CallingPostgreSQL

4

Text zu Sprache

Die Antwort von Claude wird mit einer natürlich klingenden Stimme vorgelesen und als Audio zurück an den Anrufer gestreamt.

ElevenLabs TTSStreaming

5

Reservierung & Bestätigung

Ist die Reservierung komplett, wird sie in der Datenbank gespeichert. Optional erhält der Gast eine SMS-Bestätigung. Während der Öffnungszeiten kann jederzeit an einen Mitarbeiter weitergeleitet werden.

PostgreSQLTwilio SMSFallback

🍽 Restaurant-Konfiguration

Restaurant

Gasthaus Stern

Standort

Neuenstadt

Sprachen

DE / EN

Fallback

Weiterleitung an Mitarbeiter (Öffnungszeiten)

Hauptrestaurant EG

8x 4er + 5x 2er = 42 Plätze

Nebenzimmer EG

4x 4er + 1x 2er = 18 Plätze

Raucher-Wintergarten

1x 4er + 4x 2er = 12 Plätze

Biergarten

Kommt später

🔌 API-Endpunkte

GET /health System Health Check

WS /ws/audio Twilio Audio-Stream (WebSocket)

POST /twilio/voice Twilio Webhook (eingehender Anruf)

GET /api/admin/reservations Reservierungen abrufen

DEL /api/admin/reservations/{id} Reservierung stornieren

GET /api/admin/calls Anruf-Logs

GET /api/admin/stats Tages-Statistiken

GET /api/admin/info Restaurant-Infos