telephony
40 uç · /api/crm/v1/telephony
İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 40 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.
Görüşmeyi yönlendirmek bir DIŞ ARAMADIR (dış hat bacağı açar, dakika yazar): izni aramayla
AYNI — crm.calls.make.
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/call/forward" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Sol menünün sayaçları (geri aranacaklar · dinlenmemiş sesli mesaj). Kısa süre: menü
açılışını bekletmemeli.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/calls/counts" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}CSV — BAYT olarak akar (JSON'a sarılmaz). ses_vekili yalnız audio/*i bayt sayar.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/calls/export" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /telephony/greeting/audio/{slot} — yüklenmiş dosyayı dinle.
slotcurl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/greeting/audio/<slot>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}POST /telephony/greeting/audio/{slot}?name= — ham ses dosyası. Vekil baytı OLDUĞU GİBİ
slotaktarır; dönüştürme ve doğrulama Santral'dedir (audio::normalize_upload).
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/greeting/audio/<slot>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}POST /telephony/greeting/preview {text} — metni arayanın duyacağı sesle dinle
(sentez kredi harcar → yönetim izni).
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/greeting/preview" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Kendi SIP hattını kaydet. ⚠ Gövde SIP parolasını taşır: vekil onu hiçbir yere yazmaz
ve loglamaz — olduğu gibi Santral'e aktarılır, orada mühürlenir.
curl -X PUT "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/line" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /telephony/recordings/{cdr_id} — çağrı kaydının BAYTLARI.
cdr_id🔴 Kayıt KOPYALANMAZ (CALL-01: sahibi Santral'dir, KVKK saklama/silme tek
yerde). Vekil baytı akıtır; erişim denetimi Santral'de yazılır (`kvkk::
recording_stream → callcenter::audit). no-store` korunur: kayıt kişisel veridir.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/recordings/<cdr_id>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /telephony/setup — telefon kurulumunun durumu (numara · hat · dış hat · hazır mı).
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/setup" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}WS bileti + soketin TAM adresi.
🔴 Adresi panel KURMAZ. Bileti burada alıp soket adresini panelde
wss://<slug>.call.<alan>/… diye birleştiren bir sürüm, müşteri kendi alan
adını bağladığında yanlış host'a bağlanırdı (DOM-21). Adres effective_urlden
gelir ve şemayı da BURASI seçer: http taban → ws, https → wss.
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/stream-ticket" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Ekip çalmasına katılım. Kendi satırını herkes (arama izniyle) değiştirir; başkasınınkini
agent_idSantral yönetim izniyle (crm.telephony.manage) kabul eder.
curl -X PUT "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/team/<agent_id>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /telephony/tier — katman + Santral'e özel yetenekler + geçiş adresi.
Santral'e GİTMEZ: karar paylaşılan lisans tablosundandır ve bu uç panelin
"Santral'e geç" kartını çizer — Santral'e ulaşılamasa bile kart doğru olmalı.
Yetenek listesi SUNUCUDAN gelir (CHAN-05 dersi: panele gömülen liste sessizce
eskir); metinler kaynak dilde, panel <Trans> ile çevirir.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/tier" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Kredi yükleme — iyzico 3DS başlatır; banka dönüşü Santral host'una gelir ve
Temel kiracıyı CRM'in numaralar ekranına geri yollar (wallet_topup::donus_adresi).
⚠ Kart alanları bu vekilden GEÇER ama hiçbir yere YAZILMAZ ve loglanmaz: gövde
olduğu gibi Santral'e aktarılır, orada da yalnız iyzico'ya gider (PAN saklanmaz).
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/telephony/wallet/topup" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}