Çağrı Merkezi

phone

26 uç · /api/callcenter/v1/phone

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 26 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/callcenter/v1/phone/blocked

Liste

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/blocked" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/callcenter/v1/phone/blocked

Başlık ekle (sırası korunur; Via gibi çok değerli başlıklar ayrı satırlarda kalır).

Oturum
İstek
curl -X POST "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/blocked" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/callcenter/v1/phone/blocked/{id}

Sil

OturumYol parametresi: id
İstek
curl -X DELETE "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/blocked/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/calls

Liste

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/calls" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/calls/{id}/dismiss

PUT /phone/calls/{id}/dismiss — kaçan çağrıyı geri aramadan "tamamlandı" say.

OturumYol parametresi: id

Liste numara başına TEK satırdır; o satırı kapatan kullanıcı o numaranın BEKLEYEN tüm kaçan çağrılarını kapatmış olur (aksi hâlde bir öncekisi aynı numarayla listede yeniden belirirdi). Geri alma da numara başınadır.

İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/calls/<id>/dismiss" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/calls/{id}/heard

PUT /phone/calls/{id}/heard — sesli mesajı dinlendi / dinlenmedi işaretle.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/calls/<id>/heard" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/calls/counts

Sayaclar

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/calls/counts" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/calls/export

GET /phone/calls/export — listeyle AYNI süzgeç, CSV (en çok 10.000 satır).

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/calls/export" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/calls/summary

Ozet

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/calls/summary" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/greeting

Oku

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/greeting" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/greeting

PUT /phone/greeting — ayarın TAMAMI.

Oturum

🔴 Dosya yuvalarının sound_idsi İSTEMCİDEN ALINMAZ: istemci yalnız türü söyler, kimlik kayıtlı ayardan korunur. Aksi hâlde kiracı başka bir sesin (ya da Santral kütüphanesindeki bir kaydın) kimliğini yazıp onu karşılama diye çaldırabilirdi — RLS kiracıyı korur ama "yüklemediğin dosya çalar" hâli yine bir yalandır.

İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/greeting" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/greeting/audio/{slot}

GET /phone/greeting/audio/{slot} — yuvanın yüklenmiş dosyasını dinle (panel önizlemesi).

OturumYol parametresi: slot
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/greeting/audio/<slot>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/callcenter/v1/phone/greeting/audio/{slot}

POST /phone/greeting/audio/{slot} — ham ses gövdesi (wav · mp3 · ogg · flac · m4a).

OturumYol parametresi: slot

**Yükleme = uygulama:** dosya telefon biçimine çevrilir, yuvanın TEK sound_prompts satırına yazılır (yoksa açılır, varsa içeriği DEĞİŞİR) ve yuva file türüne geçer. İki adımlı bir sürümde ("yükle" + "kaydet") kaydedilmeden bırakılan her yükleme sahipsiz bir satır olurdu.

İstek
curl -X POST "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/greeting/audio/<slot>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/callcenter/v1/phone/greeting/preview

POST /phone/greeting/preview — metni arayanın duyacağı sesle dinle.

Oturum

Çağrı yolunun AYNI önbelleğinden geçer (tts_cache::get_or_synthesize): dinlenen cümle çağrıda yeniden sentezlenmez, ücret bir kez düşer. Yetki manage: sentez kredi harcar.

İstek
curl -X POST "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/greeting/preview" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/line

GET /phone/line — kiracının hattı + canlı durumu (yoksa null).

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/line" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/line

PUT /phone/line — hattı kur ya da güncelle (kiracı başına TEK hat bu uçtan).

Oturum

Hat + numaralar AYNI tx'te yazılır: yarım bir kurulum ("hat var, numara yok") gelen çağrıyı kimseye bağlayamaz ve bunu hiçbir ekran söylemezdi.

İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/line" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/callcenter/v1/phone/line

DELETE /phone/line — hattı ve üzerindeki numaraları kaldır. Gateway'i medya

Oturum

sunucusundan eşitleme ajanı söker (bir sonraki turda, ≤15 sn).

İstek
curl -X DELETE "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/line" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/numbers

List numbers

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/numbers" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/numbers/{id}

PUT /phone/numbers/{id} — yalnız ETİKET (CALL-02). Hat/IVR/durum Santral'in

OturumYol parametresi: id

PUT /numbers/{id} ucundadır: Temel katmanda o alanların karşılığı yoktur.

İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/numbers/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/callcenter/v1/phone/numbers/{id}

Release number

OturumYol parametresi: id
İstek
curl -X DELETE "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/numbers/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/numbers/{id}/default

PUT /phone/numbers/{id}/default — giden çağrının varsayılan arayan kimliği.

OturumYol parametresi: id

Mig 1747 kolonu doğurdu ama onu DEĞİŞTİREN bir uç yoktu: varsayılan ya geriye dolgudan ya da ilk numaradan geliyordu. Kısmi tekil indeks kiracı başına TEK varsayılana izin verir; bu yüzden önce eskisi düşürülür, sonra yenisi yazılır (aynı tx — arada "varsayılansız" bir an dışarıdan görünmez).

İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/numbers/<id>/default" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/settings

Oku

Oturum
İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/settings" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/settings

PUT /phone/greeting — ayarın TAMAMI.

Oturum

🔴 Dosya yuvalarının sound_idsi İSTEMCİDEN ALINMAZ: istemci yalnız türü söyler, kimlik kayıtlı ayardan korunur. Aksi hâlde kiracı başka bir sesin (ya da Santral kütüphanesindeki bir kaydın) kimliğini yazıp onu karşılama diye çaldırabilirdi — RLS kiracıyı korur ama "yüklemediğin dosya çalar" hâli yine bir yalandır.

İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/settings" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/setup

GET /phone/setup — telefon kurulumunun durumu TEK yanıtta (panelin kurulum ekranı).

Oturum

🔴 Numara satışı stub taşıyıcıdayken AÇIK DEĞİLDİR: stub'ın döndürdüğü numaralar hayalidir (carrier::stub) — satmak, müşteriye hiç çalmayacak bir numara için para almak olurdu.

İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/setup" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/callcenter/v1/phone/team

GET /phone/team — aktarılabilecek ekip arkadaşları (aktif temsilci + aktif dahili).

Oturum

Yönetim izni İSTEMEZ: çağrıyı aktaran temsilcidir ve temsilcide ekip yönetim izni çoğu kurulumda yoktur (agent::phonein aynı gerekçesi). Dönen tek şey ad + dahili + anlık durum — iletişim künyesi dönmez.

İstek
curl -X GET "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/team" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/callcenter/v1/phone/team/{agent_id}

PUT /phone/team/{agent_id} — ekip çalmasına katılım. Kendi satırı: herkes; başkası: yönetici.

OturumYol parametresi: agent_id
İstek
curl -X PUT "https://{slug}.call.blesyum.app/api/callcenter/v1/phone/team/<agent_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al