AI raporları ve planları

​

Endpoint özeti

​

AI raporları

​

Rapor planları

​

Rapor nesnesi

​

Dönem etiketleri

​

Rapor oluşturma

curl -X POST "https://app.flextell.ai/api/v1/ai-reports" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Mart performansı",
    "systems": ["appointment", "revenue", "lead"],
    "period_label": "custom_date_range",
    "period_start_date": "2026-03-01",
    "period_end_date": "2026-03-31"
  }'

curl -L "https://app.flextell.ai/api/v1/ai-reports/123/pdf" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -o rapor.pdf

​

Modüller

​

Yeniden oluşturma

• Kayan dönemler yeniden çözülür. last_7_days raporunu bugün yeniden oluşturursanız bugünün son 7 günü alınır.
• Yeni raporun sahibi, kaynak raporun sahibi değil isteği yapan kullanıcıdır.
• İstek idempotent değildir; her çağrı yeni bir rapor oluşturur.

​

Listeleme

​

Sonuç yapısı

{
  "version": 2,
  "period": {
    "label": "last_7_days",
    "from": "2026-10-06", "to": "2026-10-12",
    "previous_from": "2026-09-29", "previous_to": "2026-10-05",
    "timezone": "Europe/Istanbul", "days": 7,
    "period_in_progress": null
  },
  "tenant": {"name": "Örnek Klinik", "currency": "TRY", "locale": "tr", "created_at": "2024-01-15"},
  "modules": ["appointment", "revenue"],
  "sections": {
    "appointment": {
      "metrics": {
        "total_appointments": {"current": 120, "previous": 100, "change_percent": 20}
      }
    }
  },
  "narrative": {
    "status": "ok",
    "summary": "Randevu sayısı önceki döneme göre arttı.",
    "recommendations": ["...", "...", "..."]
  },
  "meta": {"model": "...", "generated_at": "2026-10-13T09:00:00+03:00", "locale": "tr"}
}

​

Metrik değer biçimleri

​

Özet davranışı

• Dönemde hiç etkinlik yoksa AI çağrılmaz; narrative.status skipped olur.
• Özet üretilemezse rapor yine completed olur. narrative.status failed döner ve sayısal bölümler eksiksizdir.
• Özet 2–3 cümledir (tek günlük dönemlerde 1–2); tam 3 öneri içerir (tek günlük dönemlerde 2).
• Önceki dönem kliniğin kuruluşundan öncesini kapsıyorsa karşılaştırma kısmidir.

​

PDF

​

Hatalar

• Rapor oluşturulurken bir hata oluştu. Sorun sürerse sistem yöneticinize başvurun. Örneğin 731 günden uzun bir özel aralık bu hatayla biter; POST isteği bu süreyi doğrulamaz.
• Rapor oluşturulamadı: talebi yapan kullanıcının bu klinikte rapor oluşturma yetkisi kalmamış. Rapor çalışmaya başladığında isteyen kullanıcı kliniğe ait olmalı ve hâlâ Create:AIReport iznine sahip olmalıdır.

​

Rapor planları

​

Plan nesnesi

​

Çalışma zamanı kuralları

• follows_work_hours açıkken çalışma saati, o günün kapanış saatidir. Kapalı günlerde plan çalışmaz.
• starts_at yoksa ve follows_work_hours kapalıysa daily plan her gün, weekly plan pazartesi, monthly plan ayın 1’inde çalışır. follows_work_hours açıksa daily plan her açık günde, weekly plan haftanın, monthly plan ayın son çalışma gününde çalışır.
• starts_at varsa weekly plan o tarihin haftanın gününde, monthly plan ayın o gününde çalışır. Ay o günü içermiyorsa ayın son gününe çekilir. Plan başlangıç tarihinden önce çalışmaz. Çalışma saatleri açıkken o gün kapalıysa plan, aynı hafta veya ay içindeki en yakın açık güne kayar.
• Plan her zaman en fazla bir kez çalışır; zamanlayıcı geç kalsa bile aynı gün içinde yakalar.
• Plan kaydedilince next_run_at yeniden hesaplanır. Kapalı planda null olur.

​

Plan örneği

curl -X POST "https://app.flextell.ai/api/v1/ai-report-schedules" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Haftalık yönetim özeti",
    "systems": ["all"],
    "period_label": "this_week",
    "frequency": "weekly",
    "follows_work_hours": true
  }'

​

Kredi kullanımı