Telefon numaraları: satın alma, yönlendirme, BYOC

Telefon numarası, kamusal telefon şebekesiyle asistanınız arasındaki köprüdür. Gelen arama numaraya düşer, numara asistana yönlenir, asistan açar.

İki edinme yolu

Panelden numara satın alma

1. 1Telefon Numaraları → Numara al.
2. 2Ülkeyi ve varsa şehir/bölge kodunu seçin.
3. 3Numara tipini seçin: yerel, mobil veya ücretsiz hat.
4. 4Onaylayın — numara birkaç dakika içinde canlıya geçer.

Numara aylık kiralanır. İlk ay peşin alınır, sonrası her dönem cüzdanınızdan düşer. Panelden istediğiniz an iptal edebilirsiniz; numara kira dönemi sonunda havuza döner.

# Satın alınabilir ülkeleri gör
curl https://api.call2me.app/v1/numbers/allowed-countries \
  -H "Authorization: Bearer sk_live_..."

# Müsait numara ara
curl "https://api.call2me.app/v1/numbers/search?country=US&locality=New+York" \
  -H "Authorization: Bearer sk_live_..."

# Satın al ve asistana bağla
curl -X POST https://api.call2me.app/v1/numbers/purchase \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "phone_number": "+12125551234", "agent_id": "agent_abc123" }'

BYOC: kendi numaranızı bağlamak

Numaranız başka bir operatördeyse (NetGSM, Telnyx, Twilio, kurumsal bir santral) operatör ilişkinizi değiştirmeden aramaları platforma yönlendirebilirsiniz.

1. 1Telefon Numaraları → SIP Trunk’lar bölümünden bir trunk tanımlayın.
2. 2Numaranızı ekleyin ve trunk ile asistana bağlayın.
3. 3Operatör tarafında yönlendirmeyi platformun SIP adresine çevirin.
4. 4Test edin: numarayı arayın, asistan 2-3 saniyede açmalı.

curl -X POST https://api.call2me.app/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "number": "08501234567",
    "display_name": "Ana hat",
    "trunk_id": "trunk_xyz",
    "agent_id": "agent_abc123"
  }'

Yönlendirme

Her numaranın tek bir birincil asistanı olur; gelen aramalar koşulsuz o asistana gider. Daha karmaşık yönlendirme için ayrı IVR kurmanız gerekmez — mantığı asistanın talimatına yazıp aktarma kullanırsınız.

Arayan fatura konusu sorarsa +90 850 111 22 33'e aktar.
Arayan teknik destek isterse +90 850 444 55 66'ya aktar.
Mesai dışıysa geri arama talebi al ve kapat.

Numarayı asistana bağlamak veya bağı kaldırmak için ayrı uçlar var:

# Asistana bağla
curl -X POST https://api.call2me.app/v1/phone-numbers/+908501234567/bind \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "agent_id": "agent_abc123" }'

# Bağı kaldır
curl -X DELETE https://api.call2me.app/v1/phone-numbers/+908501234567/unbind \
  -H "Authorization: Bearer sk_live_..."

Giden arayan kimliği

Giden aramalarda POST /v1/calls isteğindeki from_number alanı karşı tarafın gördüğü numarayı belirler. İki geçerli desen var: sahibi olduğunuz bir numarayı kullanmak, ya da açıkça doğrulattığınız bir numarayı kullanmak.

Numara yaşam döngüsü

Durum her numara için panelde görünür. suspended durumu genelde bakiye yetersizliğinden gelir; cüzdana yükleme yapıldığında numara kendiliğinden active’e döner.

Demo numaraları

Numara satın almadan gerçek bir numarayla test etmek için demo havuzundan 15 dakikalık geçici numara ayırabilirsiniz. Demo numaraları yalnızca gelen arama alır — bu numaralardan giden arama yapılamaz.