Webhook Kurulumu
Fonify webhook entegrasyonunu yapılandırma, olay türlerini seçme ve URL konfigürasyonunu öğrenin.
Webhook Kurulumu
Webhook'lar, Fonify'daki olaylar gerçekleştiğinde belirlediğiniz URL'ye otomatik bildirim gönderir. CRM, ERP veya özel uygulamalarınızla gerçek zamanlı entegrasyon kurabilirsiniz.
Webhook Nedir?
Webhook, bir olay gerçekleştiğinde Fonify'ın sizin belirlediğiniz bir URL'ye HTTP POST isteği göndermesidir. Örneğin, bir arama tamamlandığında CRM'inize otomatik kayıt düşülebilir.
Webhook'lar tüm paketlerde kullanılabilir. Oluşturma, düzenleme ve silme işlemleri Sahip ve Yönetici rollerine açıktır; Üye rolü webhook listesini görebilir ama değiştiremez.
Webhook Oluşturma
Ayarlar > Webhook'lar bölümüne gidin ve Yeni Webhook butonuna tıklayın.
Bildirimlerin gönderileceği endpoint URL'sini girin. URL'nin https:// ile başlaması ve dışarıdan erişilebilir olması gerekir.
Hangi olaylarda bildirim alacağınızı seçin. Birden fazla olay türü seçebilirsiniz.
Webhook'u kaydedin ve Test Gönder butonuyla çalıştığını doğrulayın. Test isteği örnek veriyle gönderilir.
Olay Türleri
| Olay | Açıklama | Tetiklenme Zamanı |
|---|---|---|
call.completed | Arama tamamlandı | Her arama sona erdiğinde |
call.failed | Arama başarısız | Arama bağlanamadığında |
campaign.started | Kampanya başladı | Kampanya başlatıldığında |
campaign.completed | Kampanya tamamlandı | Tüm aramalar bittiğinde |
contact.created | Yeni kişi eklendi | Kişi oluşturulduğunda |
contact.updated | Kişi güncellendi | Kişi bilgisi değiştirildiğinde |
appointment.created | Randevu oluşturuldu | Asistan randevu aldığında |
ticket.created | Destek talebi oluşturuldu | Yeni talep oluşturulduğunda |
İstek Formatı
Webhook istekleri JSON formatında gönderilir:
{
"event": "call.completed",
"timestamp": "2026-03-22T14:30:00Z",
"workspace_id": "ws_abc123",
"data": {
"call_id": "call_xyz789",
"campaign_id": "camp_456",
"contact": {
"name": "Ahmet Yılmaz",
"phone": "+905321234567"
},
"duration": 145,
"status": "completed",
"extraction": {
"interested": true,
"appointment_requested": true
}
}
}Güvenlik
Her webhook isteğinde X-Fonify-Signature başlık bilgisi gönderilir. Bu imza ile isteğin Fonify'dan geldiğini doğrulayabilirsiniz.
Webhook URL'nizi yalnızca güvendiğiniz sistemlerde kullanın. İmza doğrulaması yapmadan gelen istekleri işlemeyin.
Hata Yönetimi
Webhook isteği başarısız olduğunda Fonify aşağıdaki yeniden deneme politikasını uygular:
- 1. deneme: Anında
- 2. deneme: 1 dakika sonra
- 3. deneme: 5 dakika sonra
- 4. deneme: 30 dakika sonra
4 denemeden sonra hala başarısız olan istekler Başarısız Teslimatlar bölümünde listelenir ve manuel olarak yeniden gönderilebilir.
İpucu
Webhook endpoint'inizin 5 saniye içinde 200 durum kodu döndürdüğünden emin olun. Uzun işlemler için isteği alıp arka planda işleyin.