Webhook ile hangi bilgiler gönderiliyor?

Adım adım

Alan eşlemesini kurmak için önce Test gönder ile örnek bir istek alın. Örnek istek gerçek taleple aynı alanları taşır.
Sisteminize gelen JSON’daki alanları CRM’inizdeki alanlarla eşleştirin. Alanların listesi aşağıda.

Örnek istek

{
  "event": "lead.unlocked",
  "delivery_id": "3b7e9d2a-5c41-4f8e-9a16-2d0c7e4b8f13",
  "occurred_at": "2026-10-28T09:41:12.000Z",
  "clinic_id": "c1a2b3c4-d5e6-4f70-8a9b-0c1d2e3f4a5b",
  "lead": {
    "assignment_id": "8d4f1e2b-7a3c-4b5d-9e6f-1a2b3c4d5e6f",
    "request_id": "2e5a7c9b-1d3f-4a6b-8c0d-3e5f7a9b1c2d",
    "category": "dental",
    "title": "Porselen kaplama (6 üst diş)",
    "description": "Ön dişlerim için kaplama yaptırmak istiyorum. Ocak ayında gelebilirim.",
    "city": "İstanbul",
    "country_code": "GB",
    "country": "Birleşik Krallık",
    "locale": "en",
    "budget_min_eur": 2000,
    "budget_max_eur": 3500,
    "timing": { "start": "2027-01-10", "end": "2027-01-31" },
    "contact": {
      "name": "Grace Thompson",
      "phone": "+44 7700 900321",
      "email": "[email protected]"
    },
    "credit_cost": 12,
    "source": "auto_match",
    "unlocked_at": "2026-10-28T09:41:12.000Z"
  }
}

Örnekteki bilgiler hayalidir.

Alanlar

Alan	Açıklama
`event`	Olay türü. Açılan talepte `lead.unlocked`, testte `webhook.test`.
`delivery_id`	Bu gönderimin kimliği. `X-ClinicVi-Delivery` başlığıyla aynıdır.
`occurred_at`	Olayın zamanı (UTC).
`clinic_id`	Kliniğinizin ClinicVi kimliği.
`lead.assignment_id`	Talebin kliniğinize atanma kaydının kimliği.
`lead.request_id`	Hasta talebinin kimliği.
`lead.category`	Tedavi kategorisinin kodu (aşağıdaki tabloya bakın).
`lead.title`	Talebin başlığı.
`lead.description`	Hastanın notu.
`lead.city`	Talepte belirtilen şehir.
`lead.country_code`	Hastanın telefon ülke kodundan bulunan iki harfli ülke kodu (ör. `GB`, `DE`).
`lead.country`	Aynı ülkenin Türkçe adı (ör. Birleşik Krallık).
`lead.locale`	Hastanın dil kodu (ör. `en`, `de`).
`lead.budget_min_eur`, `lead.budget_max_eur`	Bütçe aralığı, euro cinsinden.
`lead.timing.start`, `lead.timing.end`	Hastanın tercih ettiği tarih aralığı.
`lead.contact.name`, `lead.contact.phone`, `lead.contact.email`	Hastanın adı, telefonu ve e-postası.
`lead.credit_cost`	Talebin kredi bedeli. Günün ücretsiz hakkı ya da indirim kullandıysanız hesabınızdan düşen miktar bundan farklı olabilir.
`lead.source`	Talebin size hangi yoldan ulaştığını gösteren kısa bir kod.
`lead.unlocked_at`	Talebi açtığınız zaman (UTC).

Başlıklar

Başlık	Değer
`Content-Type`	`application/json`
`User-Agent`	`ClinicVi-Webhook/1`
`X-ClinicVi-Event`	`lead.unlocked` ya da `webhook.test`
`X-ClinicVi-Delivery`	Gönderimin kimliği (`delivery_id` ile aynı)
`X-ClinicVi-Signature`	`t=<zaman>,v1=<imza>` biçiminde imza

Kategori kodları

`category`	Paneldeki adı
`dental`	Diş
`hair`	Saç ekimi
`aesthetic`	Estetik cerrahi
`bariatric`	Bariatrik
`orthopedic`	Ortopedi
`eye`	Göz (LASIK)

Bilmeniz gerekenler

Hastanın paylaşmadığı alanlar null gelir.
country_code ve country, hastanın telefon numarasından bulunur. Telefon yoksa ya da ülke bulunamazsa ikisi de null gelir.
Bütçe alanları euro cinsindendir.
Test isteğinde event değeri webhook.test olur ve gövdede ayrıca "test": true bulunur. Test isteğindeki hasta bilgileri örnektir.
İstek imzalıdır. Doğrulama için imza anahtarı makalesine bakın.

Sık sorulanlar

Bazı alanlar boş gelebilir mi?

Evet. Hastanın paylaşmadığı alanlar null gelir. Telefon yoksa ülke alanları da boş olur.

Talebin CRM aşaması da gönderiliyor mu?

Hayır. Webhook, talebi açtığınız an bir kez gönderilir. Panelde sonradan yaptığınız aşama değişiklikleri (ör. Görüşme, Kazanıldı) gönderilmez.

İlgili makaleler

Hâlâ takıldınız mı? Ekibimize WhatsApp'tan yazın. Ekranın görüntüsünü gönderirseniz daha hızlı çözeriz.