Randevu hatırlatmaları

Randevu hatırlatması, Flextell’in bir randevu nedeniyle hastaya göndereceği (veya gönderdiği) otomatik mesajın kaydıdır. Flextell bu kayıtları kendisi oluşturur. API ile yeni kayıt açamaz ve mevcut kaydı düzenleyemezsiniz. Kayıtları listeler, onaylar, reddeder, hemen gönderir, hatalıları yeniden kuyruğa alır ve silersiniz. Dört tür kayıt aynı kaynakta durur. type filtresiyle ayırırsınız. Panel karşılıkları için bkz. Hatırlatmalar, Seans onayları ve İptal takibi.

Endpoint özeti

Tüm isteklerde Authorization: Bearer <access_token> ve X-Tenant: <tenant_id> başlıkları gerekir (bkz. Klinikler ve X-Tenant). Okuma appointment_reminders:read, diğer her işlem appointment_reminders:write scope’u ister (bkz. Scope’lar).

Metot	Endpoint	Açıklama	İzin
GET	`/api/v1/appointment-reminders`	Hatırlatmaları sayfalı listeler	`View:AppointmentReminder`
GET	`/api/v1/appointment-reminders/{id}`	Tek hatırlatmayı getirir	`View:AppointmentReminder`
POST	`/api/v1/appointment-reminders/{id}/approve`	Onaylar	`Approve:AppointmentReminder`
POST	`/api/v1/appointment-reminders/{id}/reject`	Reddeder	`Reject:AppointmentReminder`
POST	`/api/v1/appointment-reminders/{id}/send`	Hemen gönderir	`Send:AppointmentReminder`
POST	`/api/v1/appointment-reminders/{id}/retry`	Hatalı kaydı yeniden kuyruğa alır	`Send:AppointmentReminder`
DELETE	`/api/v1/appointment-reminders/{id}`	Siler	`Delete:AppointmentReminder`
POST	`/api/v1/appointment-reminders/bulk/approve`	Toplu onaylar	`Approve:AppointmentReminder`
POST	`/api/v1/appointment-reminders/bulk/reject`	Toplu reddeder	`Reject:AppointmentReminder`
POST	`/api/v1/appointment-reminders/bulk/send`	Toplu gönderir	`Send:AppointmentReminder`
POST	`/api/v1/appointment-reminders/bulk/retry`	Toplu yeniden kuyruğa alır	`Send:AppointmentReminder`
POST	`/api/v1/appointment-reminders/bulk/delete`	Toplu siler	`Delete:AppointmentReminder`
POST	`/api/v1/appointment-reminders/retry-all-errors`	Bir türdeki tüm hatalıları yeniden kuyruğa alır	`Send:AppointmentReminder`

Rol bazlı görünürlük kuralları için İzinler ve görünürlük sayfasına bakın.

Listeleme

GET /api/v1/appointment-reminders genel sayfalama ve sıralama kurallarını izler. Kaynağa özgü parametreler:

Parametre	Değerler	Açıklama
`type`	`appointment`, `cancellation_follow_up`, `session_confirmation`, `reschedule_confirmation`	Hatırlatma türü
`status`	`queued`, `sent`, `error`, `expired`	Gönderim durumu
`approval_status`	`pending`, `approved`, `rejected`	Onay durumu
`channel`	metin, en fazla 255 karakter	Kanal türü (örneğin `whatsapp`)
`from`, `to`	tarih	Randevunun planlı tarihine göre filtre. Sınırlar klinik saatiyle gün başı ve gün sonudur.
`search`	metin, en fazla 255 karakter	Randevu, ana randevu ve tedavi alanlarında arar
`sort_by`	`scheduled_for` (varsayılan), `sent_at`, `created_at`, `updated_at`, `appointment_date`	Sıralama alanı
`sort_order`	`asc`, `desc` (varsayılan `desc`)	Sıralama yönü
`per_page`	1–100 (varsayılan 15)	Sayfa boyutu

Durum sayılarını görmek için ilgili filtreyle per_page=1 isteyin ve yanıttaki meta.total değerini okuyun.

Nesne modeli

Alan	Tür	Açıklama
`id`	integer	Hatırlatma kimliği
`appointment_id`	integer	İlgili randevu. Seans onaylarında ana randevudur.
`type`	string	Hatırlatma türü
`offset_days`	integer	Konu tarihine göre gün farkı (eksi değer: öncesi). İptal takibi ve taşıma onayında `0`.
`scheduled_for`	datetime	Gönderimin planlandığı zaman
`sent_at`	datetime, null	Gönderildi olarak işaretlenme zamanı
`channel`	string	Hastaya ulaşılacak kanal türü
`message`	string	Gönderilene kadar boştur. Metin, gönderim anında mesaj şablonundan üretilir.
`status`	string	Gönderim durumu
`approval_status`	string	Onay durumu
`approved_at`, `approved_by`, `approver`	datetime, integer, nesne	Onaylayan veya reddeden kullanıcı (`approver`: `id`, `name`)
`metadata`	nesne	Türe göre ek bilgi (aşağıya bakın)
`appointment`	nesne	`code`, `scheduled_at`, `status`, `relation_type`, `customer`, `doctor`, `treatments` içeren ilgili randevu
`record_state`	nesne	`is_read_only` ve `reason_code`. Verisi imha edilmiş hastada salt okunurdur.
`created_at`, `updated_at`	datetime	Tarihler klinik saat diliminde, ofsetle döner

metadata içeriği türe göre değişir. Seans onayında confirmation_status (pending, confirmed, rejected), planned_date ve session_order bulunur. Taşıma onayında original_scheduled_at, proposed_scheduled_at ve confirmation_status bulunur. Gönderim hatasında error ve retry_count alanları eklenir. Hatırlatma ayrıca GET /api/v1/appointments/{id} yanıtında reminders[] olarak, scheduled_for sırasıyla gelir (bkz. Randevular).

Hatırlatma türleri

`type`	Arayüz etiketi	Ne zaman oluşur	Onay
`appointment`	Randevu	Doktoru olan, iptal ya da reddedilmemiş bir randevu oluşturulduğunda, yeniden etkinleştirildiğinde veya saati değiştiğinde. Varsayılan olarak randevudan 3 ve 1 gün önce.	Randevu o anda `approved` ise `approved`, değilse `pending`. Randevu sonradan `approved` olunca bekleyen kayıtlar otomatik onaylanır.
`session_confirmation`	Seans Onayı	Bir randevu `completed` olunca tedavi planındaki sonraki seans için. Hastaya seans tarihi onay sorusu olarak gider.	Her zaman `pending`. Elle onay gerekir.
`cancellation_follow_up`	İptal Takibi	Bir randevu iptal nedeniyle iptal edildiğinde. İptal nedeni boşsa oluşmaz. Varsayılan 30 gün sonra, hastaya tedaviyi yeniden planlamak isteyip istemediği sorulur.	Her zaman `pending`. Elle onay gerekir.
`reschedule_confirmation`	Taşıma Onayı	Toplu randevu taşıma sırasında hastaya yeni saat önerilirken.	Oluşurken `approved`. Hemen gönderilir.

Randevunun saati değişirse veya randevu iptal ya da reddedilirse, o randevunun appointment türündeki hatırlatmaları silinir. Saat değişikliğinde yenileri oluşturulur. Randevu silinirse tüm hatırlatmaları silinir.

Mesaj metinleri klinik şablonlarından üretilir. Şablonları Mesaj şablonları sayfasından yönetirsiniz. Hatırlatma saatleri ve gün farkları klinik bildirim ayarlarına bağlıdır (bkz. Ayarlar). Hastanın seans onayına ve taşıma önerisine verdiği evet/hayır yanıtını AI asistan işler. Seans onayı confirmed olunca planlanan tarihte pending durumunda bir seans randevusu açılır. rejected olunca randevu açılmaz ve o seansın sonraki onay hatırlatmaları silinir.

Durumlar

Her kayıtta iki ayrı durum vardır: gönderim durumu (status) ve onay durumu (approval_status).

`status`	Etiket	Anlamı
`queued`	Planlandı	Gönderim bekliyor. Yeni kayıtlar bu durumda başlar.
`sent`	Gönderildi	Mesaj gönderim kuyruğuna alındı. Sağlayıcının mesajı kabul ettiğini garanti etmez.
`error`	Hatalı	Gönderim başarısız oldu. Hata metni `metadata.error` alanındadır.
`expired`	Süresi Geçti	Gönderim zamanı geçti ve kayıt bayatladı.

`approval_status`	Etiket	Anlamı
`pending`	Onay Bekliyor	Onay veya ret bekliyor.
`approved`	Onaylandı	Zamanı gelince gönderilir.
`rejected`	Reddedildi	Asla gönderilmez. Bir daha onaylanamaz.

Flextell her 5 dakikada bir, zamanı gelmiş ve hem queued hem approved olan kayıtları scheduled_for sırasıyla gönderir. Onaylanmamış kayıt hiçbir zaman gönderilmez. Otomatik yeniden deneme yoktur. Hatalı kayıtları siz yeniden kuyruğa alırsınız.

Bayat kayıtlar expired olur ve onaylanamaz ya da reddedilemez. Bir kayıt şu durumlarda bayatlar: randevu başlamışsa, planlanan seans tarihi geçmişse, iptal takibi 3 günden fazla gecikmişse veya aynı randevu (seans onayında aynı seans) için daha yeni bir gecikmiş hatırlatma varsa. Geç onayda yalnızca en yeni kayıt gider. Taşıma onayları bu kuralla süresi geçmiş sayılmaz.

Onaylama, reddetme ve gönderme

Hangi işlemin hangi durumda yapılabildiği:

İşlem	Gereken durum	Sonuç
`approve`	`approval_status = pending` ve `expired` değil	`approval_status: approved`, `approved_at` ve `approved_by` dolar
`reject`	`approval_status = pending` ve `expired` değil	`approval_status: rejected`. Kayıt `queued` kalır, gönderilmez.
`send`	`status = queued` ve `approval_status = approved`	Hemen gönderir, `status: sent` döner. `scheduled_for` beklenmez.
`retry`	`status = error`	`status: queued`, `scheduled_for` şimdiden 5 dakika sonraya ayarlanır. Hemen göndermez.
`DELETE`	`status` değeri `queued`, `error` veya `expired`	Kayıt kalıcı silinir. `sent` kayıt silinemez.

send isteği eşzamanlıdır. Gönderim başarısız olursa 422 REMINDER_SEND_FAILED döner ve kayıt error olmaz, queued kalır.

curl -G "https://app.flextell.ai/api/v1/appointment-reminders" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  --data-urlencode "type=session_confirmation" \
  --data-urlencode "approval_status=pending" \
  --data-urlencode "from=2026-10-14" \
  --data-urlencode "to=2026-10-31" \
  --data-urlencode "per_page=50"

curl -X POST "https://app.flextell.ai/api/v1/appointment-reminders/123/approve" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>"

curl -X POST "https://app.flextell.ai/api/v1/appointment-reminders/123/send" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>"

Başarılı işlem, güncel kaydı {"success": true, "data": {...}} zarfında döndürür:

{
  "success": true,
  "data": {
    "id": 123,
    "appointment_id": 456,
    "type": "session_confirmation",
    "scheduled_for": "2026-10-20T13:00:00+03:00",
    "sent_at": null,
    "status": "queued",
    "approval_status": "approved",
    "approved_at": "2026-10-13T11:42:10+03:00",
    "approver": { "id": 7, "name": "Ayşe Yılmaz" }
  }
}

Toplu işlemler

bulk/approve, bulk/reject, bulk/send, bulk/retry ve bulk/delete aynı gövdeyi alır: 1 ile 100 arası ids dizisi.

curl -X POST "https://app.flextell.ai/api/v1/appointment-reminders/bulk/approve" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{"ids": [123, 124, 125]}'

Her kayıt ayrı işlenir; biri başarısız olursa diğerleri etkilenmez. Yanıtta toplam ve kayıt bazında sonuç bulunur:

{
  "success_count": 2,
  "failed_count": 1,
  "results": [
    { "id": 123, "success": true, "message": "Onaylandı" },
    { "id": 124, "success": true, "message": "Onaylandı" },
    { "id": 125, "success": false, "error_code": "REMINDER_EXPIRED", "message": "Bu hatırlatmanın gönderim zamanı geçtiği için süresi doldu; artık onaylanamaz veya reddedilemez." }
  ]
}

Başarılı kayıt mesajları işleme göre Onaylandı, Reddedildi, Yeniden kuyruğa alındı, Gönderildi ve Silindi olur. Bulunamayan kimlikler RESOURCE_NOT_FOUND ile raporlanır. İşlemden sonra failed_count değerini ve results içindeki error_code alanlarını kontrol edin. POST /api/v1/appointment-reminders/retry-all-errors bir türdeki tüm hatalı kayıtları yeniden kuyruğa alır. Gövdede type zorunludur. Yanıt {"requeued_count": 12} biçimindedir. Verisi imha edilmiş hastalar ve (kısıtlı satış temsilcisi için) başka temsilcinin hastaları atlanır.

Hatalar

Genel hata zarfı ve ortak kodlar için Hata kodları sayfasına bakın. Bu kaynağa özgü kodlar:

Kod	HTTP	Ne zaman
`REMINDER_NOT_PENDING`	422	Onay durumu `pending` olmayan kayıt onaylanmak veya reddedilmek istendi. Mesaj: `Yalnızca bekleyen hatırlatmalar onaylanabilir.` veya `Yalnızca bekleyen hatırlatmalar reddedilebilir.`
`REMINDER_EXPIRED`	422	`expired` kayıt onaylanmak veya reddedilmek istendi.
`REMINDER_NOT_ERRORED`	422	`error` durumunda olmayan kayıt yeniden kuyruğa alınmak istendi. Mesaj: `Yalnızca hatalı hatırlatmalar yeniden kuyruğa alınabilir.`
`REMINDER_NOT_SENDABLE`	422	`queued` ve `approved` olmayan kayıt gönderilmek istendi. Mesaj: `Yalnızca kuyrukta ve onaylanmış hatırlatmalar gönderilebilir.`
`REMINDER_SEND_FAILED`	422	Hemen gönderim başarısız oldu. Mesaj: `Hatırlatma gönderilemedi. Lütfen tekrar deneyin.`
`REMINDER_NOT_DELETABLE`	422	Gönderilmiş kayıt silinmek istendi. Mesaj: `Yalnızca kuyruktaki, hatalı veya süresi geçmiş hatırlatmalar silinebilir.`
`CUSTOMER_ERASED`	409	Verisi imha edilmiş hastanın hatırlatmasında yazma işlemi yapıldı.
`LEAD_NOT_ASSIGNED`	403	Satış temsilcisi, kendisine atanmamış bir Lead’in hatırlatmasında işlem yaptı. Yanıttaki `data.assigned_user` atanan kişiyi (`id`, `name`) veya `null` verir.
`FORBIDDEN`	403	Scope veya izin eksik. Mesaj: `Bu işlem için yetkiniz yok.`
`RESOURCE_NOT_FOUND`	404	Kimlik yok. Mesaj: `Randevu hatırlatması bulunamadı`
`VALIDATION_FAILED`	422	Geçersiz filtre veya gövde (örneğin `ids` boş ya da 100’den fazla, `retry-all-errors` için `type` eksik).

Yetki

Listeleme, kliniğin tüm hatırlatmalarını View:AppointmentReminder iznine sahip her kullanıcıya gösterir. Yalnızca kendi Lead’lerini görebilen satış temsilcisi için başka temsilcinin hastaları maskelenir (customer.is_masked: true) ve bu kayıtlardaki yazma işlemleri LEAD_NOT_ASSIGNED verir.

İzin	Arayüz etiketi	Kapsadığı işlemler
`View:AppointmentReminder`	Görüntüle	Listeleme ve detay
`Approve:AppointmentReminder`	Onayla	`approve`, `bulk/approve`
`Reject:AppointmentReminder`	Reddet	`reject`, `bulk/reject`
`Send:AppointmentReminder`	Gönder	`send`, `retry`, `bulk/send`, `bulk/retry`, `retry-all-errors`
`Delete:AppointmentReminder`	Sil	`DELETE`, `bulk/delete`

Yeni kliniklerde satış temsilcisi rolü varsayılan olarak görüntüleme, onaylama ve reddetme izinlerini alır. Gönderme ve silme izinleri yoktur. Satış direktörü rolü bunlara ek olarak silme iznini de alır.

Başlarken

Kimlik Doğrulama

Çok Kiracılılık

İstek Kuralları

Kaynak Rehberleri

Gerçek Zamanlı

Webhook'lar ve Açık Uçlar

Entegrasyonlar

Rehberler

Kaynaklar

Randevu hatırlatmaları

Endpoint özeti

Listeleme

Nesne modeli

Hatırlatma türleri

Durumlar

Onaylama, reddetme ve gönderme

Toplu işlemler

Hatalar

Yetki

​Endpoint özeti

​Listeleme

​Nesne modeli

​Hatırlatma türleri

​Durumlar

​Onaylama, reddetme ve gönderme

​Toplu işlemler

​Hatalar

​Yetki

Endpoint özeti

Listeleme

Nesne modeli

Hatırlatma türleri

Durumlar

Onaylama, reddetme ve gönderme

Toplu işlemler

Hatalar

Yetki