Gelen lead webhook'u

​

Nasıl çalışır

1. Klinikte bir bağlantı oluşturursunuz. Bağlantı Taslak durumunda açılır ve adresi ile gizli anahtarı hazırdır.
2. Dış sisteminiz kayıtları adrese gönderir. Flextell kaydı alır ve hemen 202 ile yanıt verir.
3. Kayıt arka planda işlenir. İşleme yalnızca bağlantı Aktif ise yapılır.
4. Sonuç, bağlantının Gelen Kayıtlar listesinde ve ilgili Lead’in kartında görünür.

​

Webhook adresi ve gizli anahtar

• Gizli anahtarı yalnızca bağlantıyı düzenleme iznine (Update:IntegrationConnection) sahip kullanıcılar görür. Diğer kullanıcılarda API secret: null döndürür.
• Gizli anahtarı yenilemek için panelde Anahtarı Yenile’yi ya da POST /api/v1/integration-connections/{id}/rotate-secret çağrısını kullanın. Eski anahtar hemen geçersiz olur. Gönderen sistemdeki başlık değerini güncellemezseniz 401 alırsınız.
• Bağlantıyı silerseniz adres 404 döndürür. Silmeden önce gelen kayıtlar ve oluşan Lead’ler korunur; ancak o sırada bekleyen kayıtlar hiçbir zaman işlenmez.

​

İstek biçimi

POST https://app.flextell.ai/api/v1/integrations/inbound/{uuid}
X-Flextell-Secret: <gizli_anahtar>
Content-Type: application/json

• Sorgu dizesi (?ad=...) okunmaz; veriyi gövdede gönderin.
• Content-Type JSON değilse gövde form verisi olarak okunur.
• Boş gövde, {}, [], sayı/metin listesi, liste içinde liste ya da boş bir öğe 422 ile reddedilir.
• Bir istekte en fazla 500 kayıt gönderebilirsiniz. Daha fazlasında hiçbir kayıt saklanmaz (413).
• İç içe nesneler contact.phone gibi nokta yollarıyla düzleştirilir. Eşlemede bu yolları kullanırsınız.

curl -X POST "https://app.flextell.ai/api/v1/integrations/inbound/<uuid>" \
  -H "X-Flextell-Secret: fxs_<gizli_anahtar>" \
  -H "Content-Type: application/json" \
  -d '{"id":"r1","name":"Ayşe Yılmaz","phone":"05xx xxx xx xx","email":"ayse@example.com"}'

curl -X POST "https://app.flextell.ai/api/v1/integrations/inbound/<uuid>" \
  -H "X-Flextell-Secret: fxs_<gizli_anahtar>" \
  -H "Content-Type: application/json" \
  -d '[{"id":"r1","name":"Ayşe Yılmaz","phone":"05xx xxx xx xx"},{"id":"r2","name":"Ali Veli","email":"ali@example.com"}]'

curl -X POST "https://app.flextell.ai/api/v1/integrations/inbound/<uuid>" \
  -H "X-Flextell-Secret: fxs_<gizli_anahtar>" \
  --data-urlencode "name=Ayşe Yılmaz" \
  --data-urlencode "phone=05xx xxx xx xx"

​

Lead alanları

​

Kimlik alanı zorunluluğu

​

Kayıt kimliği ve tekrarlayan kayıtlar

1. Aynı klinikte aynı telefon, yoksa aynı e-posta ile silinmemiş bir Lead varsa kayıt o Lead ile birleştirilir: yalnızca boş alanlar doldurulur.
2. Eşleşme yoksa yeni Lead oluşturulur ve ona bağlı bir hasta kaydı açılır.

​

Bağlantı ayarları

​

Yanıtlar ve oran sınırı

{
  "success": true,
  "data": { "accepted": 1 }
}

​

Oran sınırı

​

Hatalar ve yeniden deneme

​

İstek hataları

​

Kayıt işleme hataları

​

Yeniden deneme

• Hatalı kayıtlar eşlemeyi düzelttikten sonra yeniden denenir: panelde Hatalıları Yeniden Dene ya da satırdaki Yeniden Dene, API’de POST /api/v1/integration-connections/{id}/records/retry. Gövdedeki record_ids (en fazla 500) isteğe bağlıdır; vermezseniz bağlantının tüm hatalı kayıtları denenir. Yanıt {"queued": n} biçimindedir. Yalnızca failed kayıtlar etkilenir.
• Bekleyen kayıtlar bağlantıyı etkinleştirince (POST /api/v1/integration-connections/{id}/activate) işlenir.
• Eşlemeyi kaydetmek işlenmiş kayıtları yeniden işlemez.
• Gönderen taraf 429 yanıtında Retry-After süresi kadar bekleyip aynı isteği yeniden göndermelidir. 401, 404, 413 ve 422 için isteği değiştirmeden tekrar göndermek sonuç vermez; nedeni düzeltin.

​

İlgili sayfalar