Webhook'lar
İmzalı webhook'larla aday, fırsat, kişi ve şirket olaylarını kendi sistemlerinize gönderin, alıcıyı test edin ve iletim günlüğünü inceleyin.
Kimler kullanabilir
SahipŞirket yöneticisiGerekenler
Rol dışında ek koşul yok
Sahip ve Şirket yöneticisi Şirket yöneticisi → Satış ve entegrasyonlar → Entegrasyonlar → API ve webhook'lar bölümünü açar. Webhook, seçilen bir olay her gerçekleştiğinde sisteminize JSON içeren bir HTTPS POST isteği gönderir.
Webhook oluşturma
- Webhook'lar altında Yeni webhook seçin.
- Bir Ad ve URL girin. Yalnızca HTTPS. Dahili ve özel ağ adresleri engellenir.
- Olaylar altında gönderilecekleri işaretleyin:
lead.created,deal.created,deal.stage_changed,deal.won,deal.lost,contact.created,contact.updated,company.created,company.updated. - Webhook oluştur seçin, imzalama sırrını kopyalayın ve Kaydettim seçin. Her istekte X-Dromix-Signature başlığını kontrol etmek için kullanın. Yalnızca şimdi gösterilir; daha sonra yenileyebilirsiniz.
Hemen bir ping olayı göndermek için Test gönder seçin.
İmzayı doğrulama
Her istek X-Dromix-Event, X-Dromix-Event-Id, X-Dromix-Delivery, X-Dromix-Timestamp (Unix saniyesi) ve X-Dromix-Signature başlıklarını taşır. İmza şudur: sha256= + HMAC-SHA256(secret, {timestamp}.{body}). İmzayı kendi tarafınızda hesaplayıp karşılaştırın ve 5 dakikadan eski istekleri reddedin.
Yeniden denemeden sonra aynı olay iki kez gelebilir. Tekrarları atlamak için X-Dromix-Event-Id kullanın.
Sır sızarsa Sırrı yenile seçin. Eski sır hemen çalışmaz hâle gelir. Alıcınızı hemen ardından güncelleyin.
İletimler ve yeniden denemeler
Her iletimi durumu, deneme sayısı ve sonraki denemesiyle görmek için İletim günlüğü seçin. Başarısız iletimler 1 dk, 5 dk, 30 dk, 2 sa, 6 sa ve 24 sa sonra yeniden denenir. Art arda 50 başarısız denemeden sonra veya alıcı 410 Gone yanıtı verdiğinde webhook kapatılır.
Alıcınız yeniden çalıştığında webhook'u Açık ile tekrar açın.
Kayıtları kendiniz okuyup değiştirmek için bkz. API belirteçleri ve REST API.