API ve Webhook'lar
Çağrı sistemi API ve webhook'ları: üretime hazır, yol haritası slaydı değil.
25+ REST uç noktası, gerçek zamanlı webhook'lar, JWT kimlik doğrulaması ve etkileşimli dokümantasyon. Arayüzde kullandığınız her özellik API üzerinden de kullanılabilir.
14 günlük ücretsiz deneme · yapay zeka sesli asistanı denemek için ücretsiz yapay zeka kredisi · kart gerekmez
Kısa yanıt
DialerBee API nedir? DialerBee; kampanyaları, kişileri, aramaları, temsilcileri, uyumluluğu, kayıtları, raporları ve webhook'ları kapsayan 25+ uç noktalı, üretime hazır bir REST API sunar. Kimlik doğrulama, 24 saat geçerli JWT bearer token'ları kullanır. API, imleç tabanlı sayfalamayı destekler, RFC 7807 hata yanıtları döndürür ve kiracı başına dakikada 2.000 istek sınırı uygular. Gerçek zamanlı webhook'lar olayları (call.started, call.answered, call.amd_result, disposition.set, compliance.blocked vb.) HMAC-SHA256 imza doğrulaması ve üstel yeniden deneme aralığıyla iletir. Etkileşimli API dokümantasyonuna app.dialerbee.com/admin/api-docs.html adresinden ulaşılabilir.
Sorun
Çoğu dialer API'si sonradan akla gelmiş bir ektir
Arama yapmak için bir dialer satın aldınız. Şimdi onu CRM'inizle entegre etmeniz, verileri veri ambarınıza aktarmanız, çağrı olaylarından iş akışları tetiklemeniz ve özel panolar oluşturmanız gerekiyor. Sağlayıcının API dokümantasyonuna bakıyorsunuz ve karşınıza... 6 belgelenmemiş uç nokta içeren, webhook'u olmayan ve SOAP arayüzü kullanan 2019 tarihli bir PDF çıkıyor.
Çoğu giden arama ekibinin gerçeği budur. Dialer arama yapmak için gayet iyi çalışır, ancak üzerine bir şeyler inşa etmeniz gerektiği anda — çağrı sonuçlarını Salesforce ile senkronize etmek, Zendesk'te otomatik destek talebi oluşturmak, analitiği BI aracınıza aktarmak veya özel bir temsilci arayüzü geliştirmek — CSV dışa aktarımlarına ve manuel süreçlere mahkûm kalırsınız.
DialerBee API öncelikli olarak geliştirildi. Arayüzdeki her özelliğin arkasında, kendi sistemlerinizden çağırabileceğiniz aynı REST API vardır. API sonradan eklenmiş bir parça değil, tüm platformun üzerinde çalıştığı temeldir.
Nasıl çalışır
Tasarımı gereği API öncelikli
DialerBee'nin API'si JSON yükleri, standart HTTP yöntemleri ve RFC 7807 hata yanıtlarıyla REST kurallarına uyar. Kimlik doğrulama, bir giriş uç noktası üzerinden alınan, 24 saat geçerli ve yenilenebilen JWT bearer token'ları kullanır. Her API yanıtı hız sınırı başlıkları içerir; böylece entegrasyonunuz istek hızını sorunsuz şekilde kendisi ayarlayabilir.
Kimlik doğrulayın
Kimlik bilgileriyle /v1/login adresine POST isteği gönderin. 24 saat geçerli bir JWT bearer token alın. Uzun süre çalışan entegrasyonlar için token yenilemeyi kullanın.
Uç noktaları çağırın
Kampanyalar, kişiler, aramalar, temsilciler, uyumluluk, kayıtlar ve raporlar için 25+ RESTful uç nokta. JSON girer, JSON çıkar.
Webhook'ları alın
Gerçek zamanlı olayları almak için webhook URL'leri kaydedin. Her yük HMAC-SHA256 ile imzalanır; böylece gerçekliğini doğrulayabilirsiniz.
Hataları yönetin
Her hata için RFC 7807 Problem Details. Her yanıtta hız sınırı başlıkları. Yeniden deneme (retry-after) yönlendirmesiyle 429 durum kodu.
Yan Yana Karşılaştırma
DialerBee API ile tipik dialer API'lerinin karşılaştırması
| Yetenek | Tipik Dialer API'si | DialerBee API |
|---|---|---|
| Uç noktalar | 5-10, kısmen belgelenmiş | 25+, OpenAPI spesifikasyonuyla tamamen belgelenmiş |
| Protokol | SOAP/XML veya tescilli | JSON ile REST, RFC 7807 hataları |
| Kimlik Doğrulama | API anahtarı (süresi hiç dolmaz) | 24 saat geçerli JWT + token yenileme |
| Gerçek zamanlı olaylar | Yoklama (polling) veya hiç yok | Yeniden denemeli, HMAC-SHA256 imzalı webhook'lar |
| Sayfalama | Ofset tabanlı veya hiç yok | next_cursor + has_more ile imleç tabanlı |
| Hız sınırlama | Belgelenmemiş | Her yanıtta başlıklarla dakikada 2.000 istek |
| Belgeleme | PDF veya güncelliğini yitirmiş wiki | Canlı, etkileşimli Swagger dokümantasyonu |
| Çok kiracılı yapı | Yalnızca tek kiracı | Her uç noktada kiracı bazında kapsam |
Uç Nokta Referansı
10 API grubu. 25+ uç nokta.
| API Grubu | Uç noktalar |
|---|---|
| Kimlik Doğrulama | POST /login, POST /refresh |
| Kampanyalar | CRUD + başlat/duraklat |
| Kişiler | Yükleme, listeleme, arama |
| Aramalar | Geçmiş, canlı sayılar, arama başlatma |
| Temsilci | Durum, SIP kaydı |
| Uyumluluk ve DNC | Arama öncesi kontroller, DNC listeleri |
| Ses kayıtları | Listeleme, imzalı oynatma URL'leri |
| Raporlar | Dışa aktarma (CSV, JSON, PDF) |
| Webhook'lar | Abone olma, yönetme, doğrulama |
| Sistem | Sağlık durumu, sürüm |
Hızlı Başlangıç
Kimlik doğrulayın ve aramaya başlayın — yalnızca 3 API çağrısıyla
POST /v1/login
Content-Type: application/json
{
"email": "admin@yourcompany.com",
"password": "••••••••"
}
→ Response: { "token": "eyJhbG...", "expires_in": 86400 }POST /v1/campaigns
Authorization: Bearer eyJhbG...
{
"name": "Q3 Collections",
"mode": "progressive",
"amd_enabled": true,
"compliance_profile": "uae-tdra"
}POST /v1/campaigns/{id}/contacts
Content-Type: multipart/form-data
→ Upload CSV with phone, name, and custom fields
POST /v1/campaigns/{id}/start
→ Campaign is now dialingWebhook'lar
Gerçek zamanlı olaylar sistemlerinize iletilir
Webhook'lar olayları sistemlerinize gerçek zamanlı iletir — yoklama gerekmez. Her webhook yükü HMAC-SHA256 ile imzalanır; böylece DialerBee'den geldiğini ve değiştirilmediğini doğrulayabilirsiniz. Uç noktanız erişilemez durumdaysa webhook'lar 2 saat 35 dakikaya kadar üstel aralıklarla yeniden denenir ve hiçbir olayı kaçırmamanız sağlanır.
call.started Yeni bir giden arama başlatıldı
call.answered Alıcı yanıtladı — AMD sınıflandırması dahil
call.ended Arama süre, sonuç kodu ve kayıt URL'siyle tamamlandı
call.amd_result AMD sınıflandırma sonucu: güven puanıyla birlikte insan veya makine
agent.state_change Temsilci müsait, görüşmede, arama sonrası işlemde veya çevrimdışı duruma geçti
disposition.set Temsilci sonuç ve notlarla bir sonuç kodu gönderdi
compliance.blocked Bir arama, kural ayrıntılarıyla birlikte uyumluluk motoru tarafından engellendi
campaign.started Kampanya aramaya başladı
campaign.paused Kampanya süpervizör veya sistem tarafından duraklatıldı
recording.ready Arama kaydı işlendi ve oynatmaya hazır
contact.dnc_added Bir kişi DNC engelleme listesine eklendi
callback.scheduled Temsilci bir kişi için geri arama planladı
Kullanım Senaryoları
DialerBee üzerine istediğinizi inşa edin
CRM Senkronizasyonu
Sonuç kodlarını, arama sonuçlarını ve kayıt bağlantılarını webhook'lar veya API yoklaması aracılığıyla Salesforce, HubSpot, Zoho veya herhangi bir CRM'e aktarın.
BI ve Veri Ambarı
Arama verilerini veri ambarınıza aktarın. Zamanlanmış rapor dışa aktarımlarıyla Looker, Tableau, Power BI veya Metabase'de panolar oluşturun.
Özel İş Akışları
Çağrı olaylarında sistemlerinizde eylemler tetikleyin — otomatik destek talebi oluşturun, potansiyel müşteri puanlarını güncelleyin, Slack bildirimleri gönderin.
Tıkla-Ara
CRM'inize, yardım masanıza veya özel uygulamanıza tıkla-ara özelliği eklemek için arama başlatma uç noktasını kullanın.
Kişi Senkronizasyonu
Kişi listelerini ana veri kaynağınızla senkronize tutun. CSV ile yükleyin veya kişileri API üzerinden tek tek gönderin.
Uyumluluk Otomasyonu
Aramalardan önce DNC durumunu sorgulayın, engelleme listelerini yönetin ve uyumluluk denetim kayıtlarını programatik olarak dışa aktarın.
Teknik altyapı
Ürün çıkaran geliştiriciler için tasarlandı
| Protokol | Yalnızca HTTPS (TLS 1.2+) |
| Format | JSON istek ve yanıt gövdeleri |
| Kimlik Doğrulama | Yenilenebilen JWT Bearer token'ları (24 saat geçerli) |
| Sürümleme | /v1 URL yolu + webhook'larda schema_version |
| Sayfalama | next_cursor ve has_more ile imleç tabanlı |
| Hız sınırlama | Başlıklarla birlikte kiracı başına dakikada 2.000 istek |
| Hata formatı | HTTP API'leri için RFC 7807 Problem Details |
| Webhook imzalama | HMAC-SHA256 imza doğrulaması |
| Webhook yeniden denemeleri | Üstel geri çekilme (toplamda en fazla 2 sa 35 dk) |
| Kayıt URL'leri | MinIO üzerinden 1 saat geçerli imzalı URL'ler |
| DNC kayıtları | BAE (TDRA), KSA (CST), Mısır (NTRA), Ürdün (TRC) |
| SDK'lar | JavaScript ve Python (yakında) |
İlgili özellikler
Beyaz etiket platformu
Kiracı oluşturma, marka ve faturalama için Partner API.
Analitik ve Raporlama
Rapor verilerini API üzerinden BI araçlarınıza aktarın.
Kendi operatörünüzü getirin
Yönetim paneli ve API üzerinden SIP trunk yönetimi.
Entegrasyonlar
CRM'ler, mesajlaşma ve daha fazlası için hazır bağlayıcılar.
API hakkında sık sorulan sorular
API tüm planlarda kullanılabilir mi?
API dokümantasyonunu nerede bulabilirim?
Webhook kimlik doğrulaması nasıl çalışır?
Webhook uç noktam çalışmıyorsa ne olur?
API ile özel bir temsilci arayüzü geliştirebilir miyim?
API çok kiracılı mı?
Hız sınırı nedir?
SDK'lar mevcut mu?
Nelere abone olabileceğinizi bilin
Her olay, siz geliştirmeye başlamadan belgelenmiştir
Platform, bir aramada önemli olan her şey için bir olay yayınlar ve her biri yük yapısıyla birlikte kataloglanır — böylece şemayı ilk gelen veriden keşfetmek yerine, işleyiciyi yazmadan önce bir webhook'un ne içereceğini bilirsiniz.
Arama yaşam döngüsü, kampanya durumu, temsilci etkinliği, sonuç kodu, kayıt hazır olma durumu, uyumluluk kararları ve mesaj teslimatı kendi olaylarını yayınlar. Entegrasyonunuzun ilgilendiği olaylara abone olun, gerisini yok sayın — ihtiyacınız olan üç olay için tüm olay akışını tüketmek zorunda değilsiniz.
Entegrasyona hazır mısınız?
Canlı API dokümantasyonunu inceleyin veya bir demo ayırtıp API erişimi alın. İlk entegrasyonunuzu haftalar değil saatler içinde oluşturun.
14 günlük ücretsiz deneme · ücretsiz yapay zeka kredisi · kart gerekmez · fiyatları inceleyin