Business Pro plan çalışma alanları, faturalama dönemi başına 30.000 webhook olayını destekler. Yüksek hacimli otomasyonlar kurmadan önce plan sınırlarınızı kontrol edin.
Desteklenen olaylar
Bir webhook’u aşağıdaki olayların herhangi bir kombinasyonuna abone edebilirsiniz:Webhook oluşturun
1
Webhook Yönetimi'ne gidin
Sol kenar çubuğunda Entegrasyonlar → Webhook Yönetimi bölümüne gidin.
2
Token'ınızı doğrulayın
Webhook token’ınızı doğrulamak için Yönetim düğmesine tıklayın. Bu token, giden içerikleri imzalamak için kullanılır; böylece bunların AgencyHandy’den geldiğini doğrulayabilirsiniz.
3
Yeni bir webhook oluşturun
Webhook yapılandırma formunu açmak için Yeni Webhook Oluştur’a tıklayın.
4
Uç nokta URL'sini girin
Uç Nokta URL’si alanına, webhook verilerini alması gereken harici sistemin URL’sini girin. Bu, herkese açık erişilebilir bir POST uç noktası olmalıdır.
5
İçerik türünü seçin
İçerik türü olarak JSON’ı seçin. AgencyHandy tüm webhook içeriklerini
application/json olarak gönderir.6
Webhook olaylarını seçin
Bu webhook’u tetiklemesi gereken her olayı seçin. Birden fazla kategoriden olay seçebilirsiniz — örneğin Sipariş: Oluşturuldu ve Fatura: Durum değişti aynı uç noktaya yönlendirilebilir.
7
Webhook'u etkinleştirin
Aktif radyo düğmesini etkinleştirin. Etkin olduğunda AgencyHandy, seçilen tüm olaylar için içerikleri gerçek zamanlı olarak uç noktanıza iletir.
8
Yapılandırmayı kaydedin
Ayarlarınızı gözden geçirin, ardından Kaydet’e tıklayın. Webhook listede görünür ve hemen olayları iletmeye başlar.
Webhook’u test edin
Bir webhook oluşturduktan sonra, uç noktanızın erişilebilir olduğunu ve verileri doğru şekilde işlediğini doğrulamak için bir test içeriği gönderin.1
Webhook'u açın
Webhook Yönetimi listesinden test etmek istediğiniz webhook’a tıklayın.
2
Test Olayı'na tıklayın
Webhook ayrıntı sayfasında Test Olayı düğmesine tıklayın.
3
Bir test olayı seçin
Bu webhook’ta yapılandırılmış olaylar listesinden örnek bir olay seçin (ör. Sipariş: Oluşturuldu).
4
Test içeriğini gönderin
Gönder’e tıklayın. AgencyHandy, uç nokta URL’nize örnek bir içerik gönderir.
5
Sonucu doğrulayın
Test içeriğinin ulaştığını ve beklendiği gibi işlendiğini onaylamak için harici sisteminizi kontrol edin. AgencyHandy’de webhook’a tıklayarak geçmişini inceleyin — tam isteği, uç noktanızın döndürdüğü yanıtı görebilir ve gerekirse geçmişteki herhangi bir olayı yeniden iletebilirsiniz.
Webhook içeriklerini doğrulayın
AgencyHandy’den gelen her webhook isteği, uç noktanızın içeriğin gerçek olduğunu ve üzerinde oynama yapılmadığını doğrulamak için kullanabileceği bir imza başlığı içerir.İmza başlığı
Webhook imzasını doğrulayın
Bir içeriğin gerçek olduğunu doğrulamak için aşağıdaki isteği gönderin:string
gerekli
Olayı alan webhook’un kimliği. Bunu AgencyHandy’deki webhook ayrıntı sayfasında bulabilirsiniz.
string
gerekli
Gelen webhook isteğindeki
x-ah-sig başlığının değeri.string
gerekli
AgencyHandy’deki webhook ayrıntı sayfasında gösterilen webhook gizli anahtarı.
object
gerekli
AgencyHandy’nin webhook isteğinden alınan ham JSON gövdesi.
string
İmza geçerliyse
SUCCESS. Doğrulama başarısız olursa FAILED (HTTP 403).Success (200)
Failure (403)
Önemli notlar
- Uç nokta URL’niz herkese açık erişilebilir bir HTTPS POST URL’si olmalıdır.
- Uç noktanız geçici olarak kullanılamıyorsa AgencyHandy’deki webhook geçmişi panelini kontrol edin — geçmişteki herhangi bir olayı doğrudan oradan yeniden iletebilirsiniz.
- Başarısız iletileri veya yetkisiz erişim girişimlerini tespit etmek için webhook etkinliğini düzenli olarak izleyin.
- Defalarca başarısız olan webhook’lar AgencyHandy tarafından duraklatılabilir — sorunları erken yakalamak için iletim günlüklerini inceleyin.

