Mehmet
Admin
Webhook, bir olay gerçekleştiğinde başka bir sisteme veri gönderilmesidir. API'yi belirli aralıklarla sorgulamada ise yeni veri olup olmadığını siz sorarsınız. Örneğin yeni bir form yanıtı geldiğinde otomasyonun başlamasını istiyorsanız, form hizmetinin webhook desteği gereksiz tekrar sorgularını azaltabilir.
Bu iki yöntem rakip değildir. Webhook size “yeni kayıt oluştu” haberini verebilir, ardından API üzerinden kaydın ayrıntısını alabilirsiniz. Seçim, kullandığınız hizmetin hangi bilgiyi nasıl sunduğuna bağlıdır.
Bu JSON belirli bir sağlayıcının resmi biçimi değildir; kendi formunuzla otomasyonunuzun anlaşacağı örnek bir veri yapısıdır. Gerçek hizmet farklı alan adları kullanıyorsa eşlemeyi ona göre yapın.
Deneme günlüğü için şu alanlar yeterli bir başlangıçtır:
Buradaki çıktı beklenen örnektir, yapılmış bir canlı test değildir.
Bu iki yöntem rakip değildir. Webhook size “yeni kayıt oluştu” haberini verebilir, ardından API üzerinden kaydın ayrıntısını alabilirsiniz. Seçim, kullandığınız hizmetin hangi bilgiyi nasıl sunduğuna bağlıdır.
Bir iletişim formunu örnek alalım
Akış şöyle olsun: kullanıcı destek formunu doldurur, form hizmeti otomasyona olay verisini gönderir, otomasyon başlığı ve kategori bilgisini görev listesine ekler. Önce yalnız deneme verisiyle şu sözleşmeyi belirleyin:
Kod:
{
"event_id": "ornek-001",
"event_type": "support_form.created",
"record_id": "talep-104",
"category": "kurulum",
"summary": "Masaüstü uygulaması açılmıyor"
}Kurulumda hangi taraf ne yapar?
- Alıcı tarafta webhook dinleyen bir başlangıç adımı oluşturun. Kullandığınız otomasyon aracı bu adım için bir URL sağlar.
- Gönderici form hizmetinde, yalnız ihtiyaç duyduğunuz olay için bu URL'yi tanımlayın.
- Sağlayıcının kimlik doğrulama veya imza doğrulama yöntemini uygulayın. Herkese açık URL'yi bilmenin güvenilir gönderici olmak anlamına gelmediğini unutmayın.
- Bir deneme formu gönderin ve alıcıda gelen gövdeyi inceleyin. event_type ile beklenen olayın geldiğini, record_id ile doğru kaydın işlendiğini kontrol edin.
- Sonuç görevini yalnız gerekli alanlarla oluşturun. Formun bütün ham gövdesini gereksiz yerlere kopyalamayın.
HTTP 200 her zaman iş tamamlandı demek değildir
Göndericiye başarılı yanıt dönmek, alıcının isteği kabul ettiğini gösterebilir; uzun süren işlemin de bittiğini göstermek zorunda değildir. Bir yapay zekâ çağrısı eklenecekse isteği kabul etme ile sonucu kaydetme adımlarını ayrı izleyin. Kayıt numarası üzerinden sonuca ulaşılabilsin.Deneme günlüğü için şu alanlar yeterli bir başlangıçtır:
Kod:
event_id | alındı mı | alanlar geçerli mi | işlem sonucu | kayıt numarası
ornek-001 | evet | evet | görev oluşturuldu | gorev-52