API ve webhook
API modülü açık firmalarda Yönetim → Entegrasyon sayfasından API anahtarı ve webhook tanımlanır. Ayrıntılı API dokümanı (uç noktalar, örnek istekler) aynı sayfadadır.
API anahtarları
Bölüm başlığı “API anahtarları”| Alan | Açıklama |
|---|---|
| Ad | Anahtarı kullanan yazılım (ör. CRM entegrasyonu). |
| Yetkiler | Okuma: çağrı kayıtları, süren çağrılar, temsilci durumu, CRM ve oto arama verileri. Yazma: CRM müşteri ekleme/güncelleme, not, geri arama, oto aramaya numara, aranmayacaklar. Arama başlatma: dahiliyi çaldırır, açınca verilen numarayı arar. Ses kaydı: görüşme kayıtlarını indirme (KVKK erişim günlüğüne anahtarın adıyla yazılır). |
| İzin verilen IP adresleri | Doluysa anahtar yalnız bu adreslerden kullanılabilir. |
Anahtar oluşturulunca yalnız bir kez gösterilir; güvenli bir yerde saklayın. Anahtar silinince onu kullanan yazılım hemen erişimini kaybeder.
Webhook
Bölüm başlığı “Webhook”Olay olunca Voylox belirttiğiniz adrese bildirim (HTTP POST, JSON) gönderir. İstek, imza sırrı ile imzalanır; alıcı tarafta imzayı doğrulayın.
| Olay | Ne zaman |
|---|---|
call.ringing |
Çağrı temsilcide çalıyor (müşteri kartını açmak için) |
call.answered |
Çağrı cevaplandı |
call.ended |
Çağrı bitti (süre, durum, kayıt) |
call.missed |
Gelen çağrı kaçtı / cevapsız / sesli mesaja düştü |
result.saved |
Temsilci sonuç kodu / not girdi |
callback.created |
Geri arama oluşturuldu |
campaign.contact_done |
Oto aramada müşteri son durumuna geldi |
agent.status |
Temsilci durumu değişti (giriş, hazır, mola, çıkış) |
quality.evaluated |
Kalite değerlendirmesi gönderildi / itiraz sonuçlandı |
message.received |
Müşteriden SMS / WhatsApp mesajı geldi |
alert.opened / alert.resolved |
Anlık uyarı açıldı / düzeldi |
Alıcı 2xx dönmezse bildirim 1 dk, 5 dk, 30 dk, 2 sa, 6 sa ve 12 sa sonra yeniden denenir (toplam yaklaşık 21 saat), sonra başarısız sayılır. Gönderim sonucu (gönderildi, sırada, başarısız) sayfada listelenir; bir bildirimi elle tekrar gönderebilirsiniz.