Webhook’lar, Twenty’de olaylar gerçekleştiğinde verileri sistemlerinize gerçek zamanlı olarak iletir — sürekli sorgulamaya gerek yok. Harici sistemleri senkron tutmak, otomasyonları tetiklemek veya uyarılar göndermek için bunları kullanın.
Webhook oluştur
- Ayarlar → API’ler ve Webhook’lar → Webhook’lar’a gidin
- + Webhook oluştur’a tıklayın
- Webhook URL’nizi girin (herkese açık olarak erişilebilir olmalıdır)
- 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:
| Etkinlik | Örnek |
|---|
| Kayıt Oluşturuldu | person.created, company.created, note.created |
| Kayıt Güncellendi | person.updated, company.updated, opportunity.updated |
| Kayıt Silindi | person.deleted, company.deleted |
Yük Biçimi
Her webhook, JSON gövdeli bir HTTP POST gönderir:
{
"event": "person.created",
"data": {
"id": "abc12345",
"firstName": "Alice",
"lastName": "Doe",
"email": "alice@example.com",
"createdAt": "2025-02-10T15:30:45Z",
"createdBy": "user_123"
},
"timestamp": "2025-02-10T15:30:50Z"
}
| Alan | Açıklama |
|---|
etkinlik | Ne oldu (ör. person.created) |
veri | Oluşturulan/güncellenen/silinen kaydın tamamı |
zaman damgası | Olayın ne zaman gerçekleştiği (UTC) |
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
| Başlık | Açıklama |
|---|
X-Twenty-Webhook-Signature | HMAC SHA256 imzası |
X-Twenty-Webhook-Timestamp | İstek zaman damgası |
Doğrulama Adımları
X-Twenty-Webhook-Timestamp değerinden zaman damgasını alın- Dizeyi oluşturun:
{timestamp}:{JSON payload}
- Webhook gizli anahtarınızı kullanarak HMAC SHA256 hesaplayın
X-Twenty-Webhook-Signature ile karşılaştırın
Örnek (Node.js)
const crypto = require("crypto");
const timestamp = req.headers["x-twenty-webhook-timestamp"];
const payload = JSON.stringify(req.body);
const secret = "your-webhook-secret";
const stringToSign = `${timestamp}:${payload}`;
const expectedSignature = crypto
.createHmac("sha256", secret)
.update(stringToSign)
.digest("hex");
const isValid = expectedSignature === req.headers["x-twenty-webhook-signature"];
Webhook’lar ve İş Akışları
| Yöntem | Yön | Kullanım Senaryosu |
|---|
| Webhook’lar | OUT | Herhangi bir kayıt değişikliğini harici sistemlere otomatik olarak bildirin |
| İş Akışı + HTTP İsteği | OUT | Özel mantıkla (filtreler, dönüşümler) verileri dışarı gönderin |
| İş Akışı Webhook Tetikleyicisi | IN | Harici sistemlerden Twenty’ye veri alın |
