Webhook / CRM

Ne işe yarar?

Bir lead'i açtığınızda (kredi harcadığınızda) o hastanın tam bilgileri, imzalı bir webhook ile anında kendi sunucunuza/CRM'inize iletilir. Kendi URL'nizi girin, bir imza anahtarı alın — panelden kopyalamadan lead'ler doğrudan sisteminize düşsün.

Nasıl bağlanır?

01

Lead'leri almak istediğiniz HTTPS webhook URL'nizi girip kaydedin.

02

'Test gönder' ile bir test olayı yollayın; sunucunuz 2xx dönerse entegrasyon aktifleşir.

03

Bir lead'i açtığınızda tam verisi anında webhook'unuza POST edilir.

Bu entegrasyon neye erişir?

Bir hastayı açtığınızda (kredi harcadığınızda) sisteminize gönderilen gerçek alanlar. Kod ne gönderiyorsa tam olarak budur.

Hasta iletişim bilgisi (ad · telefon · e-posta) YALNIZCA krediyle açtığınız lead için gönderilir. Açmadığınız hiçbir talebin PII'si sisteminize gitmez.

{
  "event": "lead.unlocked",
  "delivery_id": "dlv_9f2c…",
  "occurred_at": "2026-07-24T09:12:00Z",
  "clinic_id": "cl_1a2b…",
  "lead": {
    "category": "hair-transplant",
    "city": "Köln",
    "country_code": "DE",
    "budget_min_eur": 2000,
    "budget_max_eur": 3500,
    "contact": { "name": "…", "phone": "+49…", "email": "…" },
    "credit_cost": 10,
    "source": "doctorvi"
  }
}

İmza doğrulama

Her istekte X-ClinicVi-Signature: t=<zaman>,v1=<hmac> başlığı gelir. v1 = HMAC-SHA256(secret, `${t}.${gövde}`) (hex). t 5 dakikadan eskiyse reddedin (replay). Teslimat en-az-bir-kez'dir: aynı X-ClinicVi-Delivery (delivery_id) değerini iki kez işlemeyin.

Node ile imza doğrulama örneği:

import crypto from "node:crypto";

function verify(headers, rawBody, secret) {
  const parts = Object.fromEntries(
    headers["x-clinicvi-signature"].split(",").map((p) => p.split("="))
  );
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${parts.t}.${rawBody}`)
    .digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return fresh && crypto.timingSafeEqual(
    Buffer.from(parts.v1), Buffer.from(expected)
  );
}

Sık sorulanlar

Kaynaklar

• Panelde bağla→
• [email protected] — kurulumda yardım→

İlgili entegrasyonlar