Santral API ile arama başlatma ve çağrı sorgulama
Kendi CRM'inizden tek tıkla arama başlatmayı, çağrı listesini süzerek çekmeyi ve tek çağrının özet ve notlarını almayı istek ve yanıt alanlarıyla anlatır.
Santral API'siyle kendi yazılımınızdaki bir müşteri kartından arama başlatabilir, çağrı geçmişini ve görüşme özetlerini kendi sisteminize çekebilirsiniz. Kimlik doğrulama bütün uçlarda aynıdır: API'ye genel bakış ve kimlik doğrulama.
Başlamadan önce
- Paketinizde Santral modülü olmalı; yoksa bu uçlar
403ve"module": "call"ile reddedilir. - Santral hesabınız bağlı ve doğrulanmış olmalı. Bkz. Santral modülüne genel bakış.
- Arama başlatacağınız dahili Santral → Ayarlar → Dahililer bölümünde tanımlı ve etkin olmalı.
Arama başlatmak
POST https://panel.ornek.com/v1/santral/calls adresine şu alanlarla JSON gönderin:
| Alan | Zorunlu | Açıklama |
|---|---|---|
phone | Evet | Aranacak numara. 05321234567, 5321234567 ya da +905321234567 biçimleri kabul edilir. |
extension | Evet | Görüşmeyi yapacak dahili (ör. 104). |
reference | Hayır | Sizin sisteminizdeki kayıt kimliği (en fazla 64 karakter). Çağrı listesinde geri döner. |
customer_id | Hayır | KuleConnect'teki müşteri numarası. Verilmezse müşteri telefon numarasından bulunur. |
Örnek gövde: {"phone": "05321234567", "extension": "104", "reference": "CRM-8812"}
İstek başarılıysa 201 koduyla {"success": true, "call": {…}} döner. call nesnesi aşağıdaki tablodaki alanları taşır; id değerini saklayıp çağrının sonucunu sonra sorgulayabilirsiniz.
Arama başlatılamazsa
422 koduyla message alanında nedeni döner. En sık karşılaşılanlar:
- “Dahili tanımlı değil.” Dahili yok ya da pasif.
- “Santral hesabı tanımlı değil.” ya da “Santral hesabı henüz doğrulanmadı (…).”
- Numara aranmak istemeyenler listesindeyse ya da arama izni yoksa izin kuralının nedeni. Bkz. Arama izni ve aranmak istemeyenler.
- “Paketinizin görüşme dakikası doldu.”
- “Eşzamanlı çağrı sınırına ulaşıldı (… kanal).”
Çağrı listesini çekmek
GET https://panel.ornek.com/v1/santral/calls en yeni çağrıdan başlayarak listeler. Süzmek için adrese şu parametreleri ekleyin:
| Parametre | Açıklama |
|---|---|
from, to | Başlangıç zamanı aralığı (YYYY-AA-GG ya da saatle birlikte ISO 8601 biçiminde). |
phone | Arayan ya da aranan bu numara olan çağrılar. |
direction | inbound (gelen) ya da outbound (giden). |
limit | Kaç çağrı dönsün; 1 ile 200 arası, verilmezse 50. |
Örnek: GET /v1/santral/calls?phone=05321234567&limit=20. Parametreler adreste olduğu için gövde boştur; imzayı boş gövdeyle hesaplayın.
Yanıt {"success": true, "calls": […]} biçimindedir. Her çağrıda şu alanlar bulunur:
| Alan | Anlamı |
|---|---|
id | Çağrı numarası |
direction | inbound, outbound ya da internal (dahililer arası) |
status | initiated, ringing, answered, bridged, completed ya da failed |
outcome | answered, busy, no_answer, rejected, failed, voicemail ya da abandoned |
from, to, extension | Arayan, aranan ve dahili |
reference | Arama başlatırken verdiğiniz kimlik |
customer | Eşleşen müşterinin id ve name değerleri (yoksa boş) |
started_at, answered_at, ended_at | Zamanlar (ISO 8601) |
talk_seconds | Konuşma süresi (saniye) |
disposition | Görüşmeye verilen sonuç kodu |
summary | Yapay zekâ görüşme özetinin kısa hali (varsa) |
Tek çağrının ayrıntısı
GET https://panel.ornek.com/v1/santral/calls/{id} aynı alanlara ek olarak şunları döndürür:
sentiment: Görüşmenin genel duygu değerlendirmesi.topics: Görüşmede geçen konular.notes: Çağrıya yazılan notlar; her biritype,contentveatalanlarıyla.
Bu alanlar görüşme özeti açıksa dolar. Bkz. Görüşme özeti, transkript ve canlı asistan. Çağrı yoksa ya da başka firmaya aitse 404 ve “Çağrı bulunamadı.” döner.
Test modunda
Firmanız test modundayken API ile başlatılan aramalar gerçekten yapılmaz (izinli alıcılar listesindeki numaralar hariç); başarılı bir test çağrısı kaydı döner. Test çağrıları çağrı listesi ucunda görünmez. Bkz. Test modu.