Lead'ler

​

Endpoint özeti

​

Nesne modeli

​

Listeleme ve filtreler

​

Oluşturma

curl -X POST https://app.flextell.ai/api/v1/leads \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Ayşe",
    "last_name": "Yılmaz",
    "phone_number": "+90 5xx xxx xx xx",
    "treatment_ids": [12],
    "lead_reference_source_id": 3
  }'

const response = await fetch("https://app.flextell.ai/api/v1/leads", {
  method: "POST",
  headers: {
    Authorization: "Bearer <access_token>",
    "X-Tenant": "<tenant_id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    first_name: "Ayşe",
    last_name: "Yılmaz",
    phone_number: "+90 5xx xxx xx xx",
    treatment_ids: [12],
    lead_reference_source_id: 3,
  }),
});
const { data: lead } = await response.json();

• assigned_user_id göndermezseniz ve Assign:Lead izniniz yoksa (satış temsilcisi) ama View:Lead ile ReceiveLeads:Lead izinleriniz varsa lead size atanır.
• Yöneticinin sahipsiz bıraktığı lead’ler, kliniğin otomatik atama moduna göre dağıtılır. Mod Manuel (otomatik atama yok) ise lead atanmadan kalır. Bu davranış kliniğinizin ayarlarına göre değişir.
• Uygun temsilci yoksa ya da herkes aktif lead sınırındaysa lead atanmadan kalır ve Assign:Lead iznine sahip kullanıcılara bildirim gider. Atama hatası lead oluşturmayı engellemez.

​

Aşama değiştirme

• Hedef aşama aktif pipeline’a ait olmalı.
• Dönüşmüş lead’in aşaması değişmez (LEAD_ALREADY_CONVERTED).
• Kayıp aşamasına geçişte, aşama Kayıp Sebebi Zorunlu ise lost_reason gerekir. Varsayılan kayıp aşaması bunu ister. Eksikse LEAD_LOST_REASON_REQUIRED döner ve errors.lost_reason alanı dolar.
• Kayıp olmayan herhangi bir aşamaya geçmek lost_reason, lost_at ve lost_by_user_id değerlerini temizler. Kayıp lead’i yeniden açmanın yolu budur.
• Kazanıldı aşamasına girişte won_at damgalanır, çıkışta temizlenir.

​

Tek lead

• PUT /leads/{id} gövdesine pipeline_stage_id ekleyin. Kayıp aşaması için lost_reason da gönderin.
• POST /leads/{id}/won lead’i aktif pipeline’ın kazanıldı aşamasına alır. Gövde gerekmez. Aktif pipeline’da kazanıldı aşaması yoksa LEAD_NO_WON_STAGE döner. Dönüşmüş lead için çağrı bir şeyi değiştirmez ve 200 döner.
• POST /leads/{id}/lost lead’i kayıp aşamasına alır ve gövdede lost_reason ister. Kayıp aşaması yoksa LEAD_NO_LOST_STAGE döner.

curl -X POST https://app.flextell.ai/api/v1/leads/123/lost \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{"lost_reason": "Fiyatı yüksek buldu"}'

​

Toplu aşama değiştirme

• Seçimde görebildiğiniz dönüşmüş bir lead varsa (LEAD_ALREADY_CONVERTED) ya da hedef aşama sebep isteyip lost_reason yoksa (LEAD_LOST_REASON_REQUIRED) isteğin tamamı reddedilir. Seçimde verisi imha edilmiş hastaya ait lead varsa istek 409 CUSTOMER_ERASED ile reddedilir.
• Görmediğiniz veya güncelleme izniniz olmayan lead’ler sessizce atlanır.
• En fazla 200 kimlikte işlem hemen yapılır: {"queued": false, "moved_count": 5}.
• 200’den fazla kimlikte iş kuyruğa alınır: {"queued": true, "lead_count": 250}. İş bitince işlemi yapan kullanıcıya uygulama içi bildirim gider.

​

Atama ve toplu atama

​

Tek lead atama

curl -X POST https://app.flextell.ai/api/v1/leads/123/assign \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{"assigned_user_id": 45, "task_action": "transfer"}'

​

Toplu atama

• specific: assigned_user_id zorunludur ve kullanıcı View:Lead iznine sahip aktif bir klinik üyesi olmalı. Aksi halde LEAD_ASSIGNEE_INVALID döner. Dönüşmüş lead’ler, güncelleyemediğiniz lead’ler ve zaten bu kullanıcıda olanlar atlanır.
• auto: her lead, en az yüklü uygun temsilciye gider. Klinik modu Manuel (otomatik atama yok) ise dağıtım Rastgele moduyla aynı şekilde yapılır. Uygun temsilcisi olmayan lead’ler atlanır.
• En fazla 200 kimlikte yanıt {"queued": false, "assigned_count": 8, "cap_exceeded_count": 1} (specific) ya da {"queued": false, "assigned_count": 8, "skipped_count": 2} (auto) olur.
• 200’den fazla kimlikte iş kuyruğa alınır: {"queued": true, "lead_count": 250}. Bitince bildirim gelir.
• Seçimde verisi imha edilmiş hastaya ait lead varsa istek 409 CUSTOMER_ERASED ile reddedilir.

​

Dönüştürme

curl -X POST https://app.flextell.ai/api/v1/leads/123/convert \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{}'

• Lead converted_at ve converted_by_user_id alanlarını alır, aşaması kazanıldı olur ve kayıp bilgileri temizlenir.
• Lead’in notları ve dosyaları hastaya kopyalanır. Görevler kopyalanmaz; hastanın görevleri arasında lead üzerinden görünür.
• İşlem tekrarlanabilir. Zaten dönüşmüş lead için aynı hasta matched_existing ile döner.
• Dönüşümü geri alan bir uç nokta yoktur.
• Satış temsilcisi rolündeki bir kullanıcı, existing_customer_id ile başka bir temsilcinin lead aşamasındaki kişi kaydını seçemez (403 LEAD_NOT_ASSIGNED).

​

Silme

​

Hata kodları