Lead Webhook'unu Kurma
Güncellenme Tarihi:
Webhook Ne Yapar?
ClickSambo her Anında Form lead'ini tüm form alanları ve sahtelik analiziyle birlikte HTTPS adresinize JSON olarak gönderir. CRM'iniz gerçek lead'leri tutup şüphelileri filtreleyebilir. Her istek HMAC-SHA256 ile imzalanır; sisteminiz isteğin ClickSambo'dan geldiğini doğrulayabilir.
Nasıl Kurulur?
1. Reklamlar → Meta Reklamları → Lead Formları → Webhook ve bildirimler'e gidin.
2. Endpoint adresi (HTTPS) alanına adresinizi girin.
3. En az 16 karakterlik bir İmza anahtarı (secret) girin ya da Üret'e tıklayın. Aynı anahtarı kendi endpoint'inizde de tanımlayın.
4. Doğrula ve kaydet'e tıklayın. ClickSambo adresi ancak endpoint'iniz doğrulama el sıkışmasını doğru yanıtladığında kaydeder.
Kaydettikten sonra Test lead'i gönder, Duraklat, Adresi veya anahtarı değiştir ve Kaldır seçeneklerini kullanabilirsiniz.
Olaylar ve Başlıklar
| Olay | Ne zaman gönderilir? |
|---|---|
lead.received | Yeni lead analiz edildikten sonra |
lead.updated | Lead'i Gerçek veya Sahte olarak işaretlediğinizde |
webhook.test | Test lead'i gönder'e tıkladığınızda |
webhook.verify | Kaydederken el sıkışma sırasında |
Her istekte X-ClickSambo-Event, X-ClickSambo-Delivery, X-ClickSambo-Timestamp ve X-ClickSambo-Signature başlıkları bulunur. İmza; sha256= ile başlayan, ham istek gövdesinin anahtarınızla hesaplanmış hex kodlu HMAC-SHA256 değeridir.
Doğrulama ve Teslim Kuralları
| Olay / alan | Yapmanız gereken |
|---|---|
webhook.verify | HTTP 200 ve challenge ile signature içeren JSON döndürün. İmza, sha256= ile challenge değerinin anahtarınızla hesaplanmış HMAC-SHA256 değeridir. |
lead.received, lead.updated | 15 saniye içinde HTTP 2xx ile yanıt verin. Diğer yanıtlar 3 kez yeniden denenir; ayrıca her lead'i panelden yeniden gönderebilirsiniz. |
analysis.verdict, analysis.fraud_score | CRM'inizde lead'leri bunlarla filtreleyin. Karar real veya fraud olur. |
lead.fields | Her form sorusunu gönderildiği gibi taşır; e-posta, telefon ve ad soyad ayrıca normalleştirilir. |
Örnek Kod
Paneldeki entegrasyon rehberinde Node.js, PHP ve C# örnekleri ile tam payload şablonu bulunur. Node.js örneği:
// Node.js (Express) — imza doğrulaması için ham gövde gerekir
const crypto = require('crypto');
const SECRET = process.env.CLICKSAMBO_WEBHOOK_SECRET;
app.post('/clicksambo-leads', express.raw({ type: 'application/json' }), (req, res) => {
const raw = req.body.toString('utf8');
const expected = 'sha256=' + crypto.createHmac('sha256', SECRET).update(raw).digest('hex');
const given = req.get('X-ClickSambo-Signature') || '';
if (given.length !== expected.length ||
!crypto.timingSafeEqual(Buffer.from(given), Buffer.from(expected))) {
return res.status(401).end();
}
const data = JSON.parse(raw);
if (data.event === 'webhook.verify') {
const signature = 'sha256=' + crypto.createHmac('sha256', SECRET).update(data.challenge).digest('hex');
return res.json({ challenge: data.challenge, signature });
}
if (data.event === 'lead.received' || data.event === 'lead.updated') {
if (data.analysis.verdict === 'real') saveToCrm(data.lead); // gerçek lead'leri sakla
else moveToQuarantine(data.lead, data.analysis); // şüphelileri ayır
}
res.status(200).end();
});