Size nasıl yardımcı olabiliriz?

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

OlayNe zaman gönderilir?
lead.receivedYeni lead analiz edildikten sonra
lead.updatedLead'i Gerçek veya Sahte olarak işaretlediğinizde
webhook.testTest lead'i gönder'e tıkladığınızda
webhook.verifyKaydederken 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 / alanYapmanız gereken
webhook.verifyHTTP 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.updated15 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_scoreCRM'inizde lead'leri bunlarla filtreleyin. Karar real veya fraud olur.
lead.fieldsHer 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();
});
İş Ortaklığı Programı

ClickSambo ile büyümeye hazır mısınız?

İş ortaklığı programımıza katılın ve reklam sahtekarlığı korumasını ölçeklenebilir, düzenli bir gelir kaynağına dönüştürün.

Programa başvurun

ClickSambo desteği hazır!

Whatsapp Sohbet