Çağrı başlatma (tıkla-ara)Çağrıyı sonlandır Çağrıyı aktar Sessize al / sesli yap Canlı çağrı verisi Tipik akış: CRM'den tıkla-ara

Çağrı Yönetimi

Yazılımınızdan çağrı başlatın (tıkla-ara), süren çağrıyı sonlandırın, aktarın ya da sessize alın. Tüm uçlar API anahtarı (kapsam call; Authorization: Bearer bt_… başlığında, bkz. API Güvenliği) ile ve GET metoduyla çağrılır.

Hız sınırı: dakikada 10 istek. Çağrı kimliği (call_uuid) begin_call cevabında ve canlı çağrı verisinde döner.

GETÇağrı başlatma (tıkla-ara)

Önce belirtilen dahili çalar; dahili açınca hedef numara aranır ve iki taraf bağlanır.

GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567

Parametre	Zorunlu	Açıklama
`Authorization` (başlık)	evet	`Bearer bt_…`, kapsam `call`
`extension`	evet	Çağrının bağlanacağı dahili (ör. `1001`)
`destination`	evet	Aranacak numara. Türkiye için `905321234567`, yurt dışı için `00` + ülke kodu
`caller_id`	hayır	Dış aramada görünecek numara; verilmezse dahilinin varsayılanı. Hesabınıza ait olmayan numara `400` döner
`manual_answer`	hayır	`true` ise dahilinin elle açması beklenir; verilmezse destekleyen cihazlarda otomatik cevaplatılır
`timeout`	hayır	Çaldırma süresi, 10-60 sn (varsayılan 30)
`announcement_to_caller`	hayır	Bağlantı anında dahiliye çalınacak anons ID'si
`announcement_to_callee`	hayır	Bağlantı anında aranana çalınacak anons ID'si

Başarılı cevap: 200 OK, gövdede çağrı kimliği.

358c20bc-fd86-11e5-87a2-157d41a07454

Hatalı cevap örnekleri:

400 Bad Request   extension 1005 not found
400 Bad Request   caller_id 02120000000 not allowed
401 Unauthorized  Geçersiz anahtar: K…

GETÇağrıyı sonlandır

GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>

id yerine yol biçimi de kabul edilir: /api/hangup/<call_uuid>. Cevap 200 OK.

GETÇağrıyı aktar

Süren çağrıyı bir dahiliye ya da dış numaraya aktarır.

GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002

Parametre	Açıklama
`id`	Çağrı kimliği
`user_number`	Hedef dahili (ör. `1002`) ya da dış numara (`905321234567`)

GETSessize al / sesli yap

GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=on

state: on (sessize al) ya da off (sesi aç).

Canlı çağrı verisi

Süren çağrıların listesi (arayan, aranan, dahili, durum, süre) CRM köprüsü ucundan okunur; gelen aramada müşteri kartı açmak için bu veriyi ya da webhook'ları kullanın. Ayrıntı için Destek Merkezi'nden "CRM köprüsü" dokümanını isteyin; Byfix CRM için köprü hazırdır.

Tipik akış: CRM'den tıkla-ara

1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir

← API Güvenliği Kuyruklar