Skip to main content
Bir kayıt oluşturulduğunda, güncellendiğinde veya silindiğinde Twenty URL’inize bir HTTP POST gönderir. Özel nesneler dahil tüm nesne türleri kapsanır.

Webhook oluştur

  1. Ayarlar → API’ler ve Webhook’lar → Webhook’lar’a gidin
  2. + Webhook oluştur’a tıklayın
  3. Webhook URL’nizi girin (herkese açık olarak erişilebilir olmalıdır)
  4. Kaydet’e tıklayın
Webhook anında etkinleşir ve bildirim göndermeye başlar.

Webhook’ları Yönet

Düzenle: Webhook’u tıklayın → URL’yi güncelleyin → Kaydet Sil: Webhook’u tıklayın → Sil → Onayla

Etkinlikler

Twenty, şu olay türleri için webhook’lar gönderir: Tüm olay türleri webhook URL’nize gönderilir. Olay filtreleme özelliği ilerideki sürümlerde eklenebilir.

Yük Biçimi

Her webhook, JSON gövdeli bir HTTP POST gönderir:
Alındığını onaylamak için 2xx HTTP durumu (200-299) ile yanıt verin. 2xx dışı yanıtlar teslimat hataları olarak kaydedilir.

Webhook Doğrulaması

Twenty, güvenlik için her webhook isteğini imzalar. İsteklerin gerçekliğini sağlamak için imzaları doğrulayın.

Üstbilgiler

Doğrulama Adımları

  1. X-Twenty-Webhook-Timestamp değerinden zaman damgasını alın
  2. Dizeyi oluşturun: {timestamp}:{JSON payload}
  3. Webhook gizli anahtarınızı kullanarak HMAC SHA256 hesaplayın
  4. X-Twenty-Webhook-Signature ile karşılaştırın

Örnek (Node.js)

Webhook’lar ve İş Akışları

Harici verileri almak için bkz. Bir Webhook Tetikleyicisi Kurun.