Toplu randevu taşıma

​

Endpoint özeti

​

Önizleme

curl -G "https://app.flextell.ai/api/v1/appointments/reschedule/preview" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  --data-urlencode "user_id=123" \
  --data-urlencode "blocked_from=2026-10-20T09:00:00+03:00" \
  --data-urlencode "blocked_until=2026-10-20T12:00:00+03:00"

{
  "success": true,
  "data": [
    {
      "appointment_id": 456,
      "customer_name": "Ayşe Yılmaz",
      "channel_name": "WhatsApp",
      "channel_address": "+90 5xx xxx xx xx",
      "original_at": "20.10.2026 10:00",
      "proposed_at": "20.10.2026 12:15",
      "is_already_pending": false,
      "skip_reason_code": null
    }
  ]
}

​

Yeni saat nasıl bulunur

• Randevular saat sırasıyla işlenir. Arama, aynı doktor için blocked_until anından başlar ve en çok 365 gün ileri gider.
• Kapalı günler, tatiller (tatil kapatma açıksa), geçmiş saatler, aynı partide başka randevuya ayrılmış saatler ve doktorun dolu olduğu saatler atlanır.
• Doktor dolu sayılır: aynı saatte başka bir pending veya approved randevusu varsa, o saate tutulan başka bir öneri varsa ya da doktorun bağlı Google Takvim veya Outlook takviminde o saatin ilk 15 dakikası doluysa.
• Saatler kliniğin randevu aralığı ızgarasına oturur.

​

Taşıma isteği

curl -X POST "https://app.flextell.ai/api/v1/appointments/reschedule" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 123,
    "blocked_from": "2026-10-20T09:00:00+03:00",
    "blocked_until": "2026-10-20T12:00:00+03:00"
  }'

• Önerilen yeni saat ve onay bekleme süresi (aşağıya bakın).
• Aralıktaki tüm randevuları tek partide toplayan bir batch_id.
• Hastaya gidecek onay mesajı. Mesajı istekten sonra kuyruktaki bir iş gönderir.

​

Sonuç alanları

{
  "success": true,
  "data": {
    "processed": 1,
    "failed": 1,
    "skipped": 1,
    "superseded": 0,
    "batch_id": "0b6f6c3e-0000-0000-0000-000000000000",
    "items": [
      {
        "appointment_id": 456,
        "status": "processed",
        "was_pending": false,
        "original_at": "2026-10-20T10:00:00+03:00",
        "proposed_at": "2026-10-20T12:15:00+03:00"
      },
      {
        "appointment_id": 457,
        "status": "skipped",
        "reason_code": "CUSTOMER_ERASED",
        "reason": "<hata kodunun Türkçe mesajı>"
      },
      {
        "appointment_id": 458,
        "status": "failed",
        "reason": "No available slot found"
      }
    ]
  }
}

​

Parti geçmişi

​

Hastaya giden onay

Merhaba {customerName}, {tenantName} kliniğinizdeki {oldDate} saat {oldTime} randevunuz {newDate} saat {newTime} tarihine taşınmak isteniyor. Onaylıyor musunuz? (Evet / Hayır)

• Evet: Randevu önerilen saate taşınır, randevu hatırlatmaları yeni saat için yeniden oluşturulur. Doktora “randevu zamanı değişti” bildirimi gitmez; asistanlara gider. Önerilen saat bu arada dolmuşsa hastaya bir sonraki boş saat önerilir.
• Hayır: Hastanın tercih ettiği tarih ve saatten (yoksa reddedilen önerinin bir dakika sonrasından) başlayarak yeni bir saat aranır ve yeni mesaj gider. Hasta bir günü hariç tutabilir.
• Vazgeçme: Randevu cancelled olur, iptal nedeni Hasta randevu taşıma sürecinde randevudan vazgeçti. yazılır ve iptal takibi açıksa ayrı bir iptal takibi kuyruğa girer. Personele Hasta Randevudan Vazgeçti bildirimi gider.
• Uygun saat yok: 365 gün içinde saat bulunamazsa tutulan saat serbest bırakılır ve personele Taşıma için Uygun Slot Yok bildirimi gider; hastayla elle iletişime geçmeniz gerekir.

​

Hatalar