Sesli Telefon Müşteri Destek Botu

# Sesli Telefon Müşteri Destek Botu

**Ne inşa ediyoruz:** Twilio numarasına gelen aramayı karşılayan, Whisper streaming + Claude + ElevenLabs ile doğal konuşma yapan, randevu/FAQ tool'larıyla iş bitiren ve gerekirse gerçek kişiye transfer eden bot.

**Kullanıcının işi (JTBD):** Restoranımda akşam 19:00 yoğunluğunda telefon çalıyor ama mutfakta kimse cevaplayamıyor; bot rezervasyon alsın, saatleri söylesin, menü hakkında basic cevap versin.

---

## Stack
- Next.js 15 App Router
- Tailwind + shadcn/ui
- Supabase Postgres + Auth
- Twilio Voice + Media Streams
- Whisper streaming (Groq) + Claude Sonnet 4.6 + ElevenLabs streaming TTS
- Render worker (TR latency için yakın bölge)
- Deploy: Vercel + Render

## Veri modeli
```sql
create table businesses (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users,
  name text, twilio_number text, system_prompt text,
  faqs jsonb, transfer_to_phone text
);

create table calls (
  id uuid primary key default gen_random_uuid(),
  business_id uuid references businesses,
  caller_phone text, started_at timestamptz, ended_at timestamptz,
  duration_seconds int, transcript jsonb,
  outcome text, transferred boolean default false
);

create table reservations (
  id uuid primary key default gen_random_uuid(),
  business_id uuid references businesses,
  call_id uuid references calls,
  party_size int, when_at timestamptz, customer_name text, customer_phone text,
  status text default 'confirmed'
);
```

## Ana akışlar
1. Twilio numara satın al, webhook ayarla.
2. Inbound call → Twilio Media Stream (websocket) → Render worker.
3. Worker Whisper streaming + Claude streaming + TTS.
4. Tool use: `book_reservation`, `get_hours`, `transfer_to_human`.
5. Konuşma kaydı + transkript dashboard'da.

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold + Twilio account
- 1:00–3:00 — Worker websocket + STT/TTS streaming pipeline
- 3:00–4:30 — Claude conversation + tool use
- 4:30–5:30 — Reservation tool + Calendar entegrasyonu
- 5:30–6:00 — Transcript dashboard + Vercel deploy

## Başarı kriteri
- [ ] Test arama başarıyla bağlandı
- [ ] Bot Türkçe selamlıyor ve cevap veriyor
- [ ] Latency < 2sn (turn time)
- [ ] Tool: rezervasyon kaydedildi
- [ ] Transfer talebi gerçek numaraya geçiyor

## Dikkat
- Latency en zorlu: Whisper streaming (Groq), Claude streaming, ElevenLabs streaming — paralelleştir.
- TR ses kalitesi ElevenLabs'in iyi; Cartesia alternatif (daha ucuz).
- "İnsana transfer et" tool'u mutlaka net çağrı sebepleri için.
- Twilio TR yerel numara almak yetkili gerekiyor — MVP'de US/UK numara kullan veya SIP forward.