# sesyaz Telefon Kanalı — Kurulum Rehberi

Bu asistanı bir telefon numarasına bağlayın; arayan kişi **yapay zekâ ile sesli** konuşsun.
Mimari: **beyin sesyaz'da**, **ses + telefon ElevenLabs'te**.

---

## 1) Telefonu etkinleştirin (sesyaz paneli)

- Panel → **Kanallar** → asistanı seçin → **Telefon Kanalı** → "Telefonu etkinleştir" → **Kaydet**.
- Etkinleştirince size özel **bağlantı bilgileri** oluşur:
  - **Server URL:** `https://sesyaz.com/v1/<asistan-id>`
  - **Model ID:** `sesyaz`
  - **API Key:** (gizli — panelde "Göster/Kopyala")

> Etkinleştirme kullanım ücretlendirmesini kabul anlamına gelir. (Operatör birkaç ücretsiz demo açabilir.)

---

## 2) ElevenLabs tarafı (beyin bağlantısı)

1. https://elevenlabs.io → **Conversational AI** → bir **Agent** oluşturun (veya mevcut).
2. **LLM** → **Custom LLM** seçin:
   - **Server URL:** yukarıdaki `https://sesyaz.com/v1/<asistan-id>`
   - **Model ID:** `sesyaz`
   - **API Key:** panelden kopyaladığınız anahtar (Secret olarak ekleyin)
   - **Test Connection** → "Connection successful" görmelisiniz.
3. **Language:** Türkçe. **Voice:** Türkçe bir ses (örn. Doga). **First message:** karşılama cümlesi.
4. **Publish** edin.

> Not: Yanıtlar telefonda sesli okunur; sistem istemi kısa/sade Türkçe yanıt verecek şekilde ayarlıdır.

---

## 3) Telefon numarası (Türkiye için Netgsm SIP Trunk önerilir)

Twilio Türkiye (+90) numarayı self-servis **vermez**. Türkiye için:

1. **Netgsm**'den (netgsm.com.tr) bir **0850** veya coğrafi numara alın.
2. **"SIP Trunk Yönlendirme"**yi aktive ettirin (Sizi Arayalım): gelen aramayı **harici bir SIP sunucusuna** yönlendirme + **G.711 alaw** codec.
3. Netgsm'den alın: SIP host/domain, SIP kullanıcı adı + şifre.

### ElevenLabs'e numarayı bağlama
- ElevenLabs → **Phone Numbers** → **Import number** → **From SIP Trunk**:
  - Numara (E.164, örn. `+90850...`), Auth (digest username/password) veya IP allowlist.
  - ElevenLabs size bir **gelen SIP adresi** verir → bunu Netgsm "SIP Trunk Yönlendirme" hedefi olarak girin.
- Numaraya **bu agent'ı** atayın.

Alternatif: Twilio (ABD +1 numara — anında) veya başka SIP sağlayıcı.

---

## 4) Test
Numarayı arayın → karşılama cümlesini duyun → Türkçe konuşun. Görüşmeler sesyaz **Gelen Kutusu**'na `Telefon` kanalı olarak düşer.

---

### Sık sorulanlar
- **"Connection failed" alıyorum:** Server URL'in sonunda `/chat/completions` ElevenLabs tarafından eklenir; siz sadece `.../v1/<asistan-id>` girin. API Key doğru mu kontrol edin.
- **Ses yok / kopuk:** Codec G.711 (alaw) ve numaranın bu agent'a atandığından emin olun.
- **Ücret:** Numara kirası (sağlayıcı) + arama dakikası (sağlayıcı) + ElevenLabs sesli AI dakikası ayrı ayrıdır.