{"openapi":"3.1.0","info":{"title":"Hiboty REST API","version":"1.10.0","description":"Hata mesajları varsayılan olarak Türkçedir; `?lang=en` ya da `Accept-Language: en` ile İngilizce döner. Telegram ve WhatsApp botlarınızı kendi uygulamanıza bağlayın. Anahtarlar panelde Ayarlar → API bölümünden oluşturulur (Pro ve üzeri planlar). Her anahtarın kapsamı vardır: read (GET uçları), write (kişi, izin, sohbet durumu, kampanya, sipariş, otomasyon ve webhook değişiklikleri), messages:send (mesaj gönderme), bots:read (bot ayarları, bilgi kaynakları, araçlar, sürümler ve dışa aktarma), bots:write (bot oluşturma, bağlama, yapılandırma, silme). bots:* kapsamları ayrıdır: yalnız read/write taşıyan anahtarlar bot yönetemez; panelde Tam erişim + bot yönetimi düzeyiyle verilir. Bot uçlarında rol panelle aynıdır: API anahtarı onu oluşturan üyenin rolüyle, OAuth belirteci yetkiyi verenin rolüyle çalışır; rolü yetmeyen istek 403 forbidden_role döner (bot silme yalnız sahip). Kaynak kapsamları da ayrıdır ve eski anahtarlara kendiliğinden eklenmez: automations:*, miniapps:*, contacts:*, conversations:*, campaigns:*, communities:*, reports:read, organization:*, team:*, webhooks:*, api_keys:*; panelde Tam yönetim düzeyiyle verilir. Kampanya gönderim onayı API'de yoktur: kampanya panelde yönetici onayıyla (dört göz açıksa başka bir yöneticinin onayıyla) başlar. Abonelik satın alma, plan değişikliği, iptal, ödeme kartı, parola, 2FA, hesap kapatma ve organizasyon silme de API'de yoktur. Jeton ve sırlar hiçbir yanıtta dönmez, yalnız connected bilgisi döner. Bilinmeyen gövde alanı 400 döner ve alan adını söyler. Bütün kimlikli yanıtlar X-RateLimit-* başlıklarını taşır; geçersiz anahtarlar IP başına, kapsam/plan/askı 403'leri organizasyon başına sayılır. Sürüm: semantik sürümleme; v1 içinde yalnız geriye uyumlu eklemeler yapılır."},"servers":[{"url":"https://hiboty.com"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Mesajlar"},{"name":"Botlar"},{"name":"Kişiler"},{"name":"Sohbetler"},{"name":"Kampanyalar"},{"name":"Mini App"},{"name":"Otomasyonlar"},{"name":"Webhook"},{"name":"Sistem"},{"name":"Özel Mini App"},{"name":"Hazır yanıtlar"},{"name":"Raporlar"},{"name":"Topluluklar"},{"name":"Planlı gönderiler"},{"name":"Organizasyon"},{"name":"Medya"},{"name":"Denetim"},{"name":"Ekip"},{"name":"API anahtarları"},{"name":"Abonelik"}],"paths":{"/api/v1/messages":{"post":{"tags":["Mesajlar"],"operationId":"sendMessage","summary":"Bir kişiye mesaj gönderir","description":"Kişi daha önce bota yazmış olmalıdır. message (serbest metin) ya da template (yalnız WhatsApp, onaylı Meta şablonu) alanlarından tam olarak biri gönderilir. Yeniden denemede çift mesajı önlemek için Idempotency-Key kullanın. Plan sınırını aşan bot gönderemez (403 bot_plan_restricted). Kapsam: messages:send.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MesajGonder"},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","to":"123456789","message":"Merhaba!"}}}},"responses":{"201":{"description":"Mesaj gönderildi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["id","status","bot_id","to"],"properties":{"id":{"type":"string"},"status":{"const":"sent"},"bot_id":{"type":"string","format":"uuid"},"to":{"type":"string"},"template":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/messages/list":{"get":{"tags":["Mesajlar"],"operationId":"listMessages","summary":"Bir sohbetin mesajlarını yeniden eskiye listeler","parameters":[{"name":"conversation_id","in":"query","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Mesajlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Mesaj"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots":{"get":{"tags":["Botlar"],"operationId":"listBots","summary":"Organizasyonun botlarını listeler","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 100); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Botlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Bot"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"createBot","summary":"Bot oluşturur","description":"Plan bot sınırı panelle aynıdır (403 plan_limit). template verilirse boş bırakılan persona, karşılama, temsilci kelimesi ve faqs galeri şablonundan gelir (language: şablon dili). Bot taslak (draft) oluşur; connectBot ile kanala bağlanır. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotOlustur"},"example":{"name":"Mağaza Asistanı","channel":"telegram","template":"eticaret","language":"tr"}}}},"responses":{"201":{"description":"Oluşturuldu","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/templates":{"get":{"tags":["Botlar"],"operationId":"listBotTemplates","summary":"Galeri şablonlarını listeler","description":"createBot için template kodları. Kapsam: bots:read.","parameters":[{"name":"sector","in":"query","description":"Sektör süzgeci","schema":{"enum":["perakende","yeme_icme","hizmet","saglik","emlak","turizm","egitim","genel"]}},{"name":"language","in":"query","description":"Metin dili; verilmezse isteğin dili","schema":{"enum":["tr","en"]}}],"responses":{"200":{"description":"Şablonlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BotSablonu"}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/draft":{"post":{"tags":["Botlar"],"operationId":"createBotDraft","summary":"AI ile bot taslağı üretir (kayıt yapmaz)","description":"Açıklama ya da site adresinden persona, karşılama ve SSS önerir; sonucu createBot ile kaydedin. Site adresi SSRF denetiminden geçer. AI kotasından düşer. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"description":{"type":"string","maxLength":3000},"website":{"type":"string","maxLength":2000}}},"example":{"description":"İstanbul'da el yapımı seramik satan bir online mağaza.","website":"https://ornek.com"}}}},"responses":{"200":{"description":"Taslak","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotTaslagi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/import":{"post":{"tags":["Botlar"],"operationId":"importBot","summary":"Bot dosyasından yeni taslak bot oluşturur","description":"Dosya baştan doğrulanır, kanal bağlanmaz, araçlar kapalı gelir. Araç imza sırları yalnız bu yanıtta döner. Plan bot sınırı geçerlidir. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotDosyasiGirdisi"},"example":{"file":{"tur":"hiboty.bot","surum":1}}}}},"responses":{"201":{"description":"İçe aktarıldı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["bot_id","name","knowledge_count","tools"],"properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"knowledge_count":{"type":"integer"},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"signing_secret":{"type":"string"}}}}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/import/preview":{"post":{"tags":["Botlar"],"operationId":"previewBotImport","summary":"Bot dosyasını doğrular, kaydetmez","description":"Ne oluşacağını, dosyadaki adresleri ve görünmez karakterli alanları döner. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotDosyasiGirdisi"},"example":{"file":{"tur":"hiboty.bot","surum":1}}}}},"responses":{"200":{"description":"Önizleme","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"name":{"type":"string"},"channel":{"$ref":"#/components/schemas/Kanal"},"knowledge_count":{"type":"integer"},"tool_count":{"type":"integer"},"addresses":{"type":"array","items":{"type":"object","properties":{"type":{"enum":["tool","knowledge"]},"name":{"type":"string"},"url":{"type":"string"},"has_query":{"type":"boolean"}}}},"invisible_character_fields":{"type":"array","items":{"type":"string"}},"oversized_sources":{"type":"array","items":{"type":"string"}},"bot_count":{"type":"integer"},"bot_limit":{"type":"integer"},"bot":{"type":"object","properties":{"persona":{"type":"string"},"welcome_message":{"type":"string"},"handoff_keyword":{"type":"string"},"ai_enabled":{"type":"boolean"},"ai_tools":{"type":"boolean"},"voice_transcription":{"type":"boolean"},"image_understanding":{"type":"boolean"}}},"knowledge":{"type":"array","items":{"type":"object","properties":{"type":{"enum":["text","faq","url"]},"title":{"type":"string"},"url":{"type":["string","null"]},"content":{"type":["string","null"]}}}},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/OzelAracAlani"}}}}}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"getBot","summary":"Bot ayrıntısı","description":"Jeton ve sırlar dönmez; yalnız connected bilgisi döner. Kapsam: bots:read.","responses":{"200":{"description":"Bot","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Botlar"],"operationId":"updateBot","summary":"Bot ve AI ayarlarını günceller","description":"Yalnız gönderilen alanlar değişir; önceki hâl sürüm olarak saklanır (listBotVersions). Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGuncelle"},"example":{"persona":"Kısa ve net yanıt veren satış asistanısın.","ai_enabled":true}}}},"responses":{"200":{"description":"Güncel bot","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Botlar"],"operationId":"deleteBot","summary":"Botu siler","description":"Geri alınamaz; kişi ve sohbetleri de silinir. Panel gibi yalnız sahip yetkisiyle çalışır (403 forbidden_role). Kapsam: bots:write.","responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/connect":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"connectBot","summary":"Botu kanala bağlar","description":"Telegram: token. WhatsApp Cloud API: phone_number_id, business_account_id, access_token ve (kayıtlı değilse) app_secret; Meta webhook doğrulaması için kendi webhook_verify_token değerinizi verebilirsiniz, yanıt bu değeri döndürmez. Bilgiler panelle aynı doğrulanır, şifreli saklanır, Telegram webhook'u kurulur. Yanıt ve hatalarda gizli değer yoktur. warning: whatsapp_subscription_failed ise bağlantı kaydedilmiş ama uygulama WABA'ya abone edilememiştir. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBagla"},"example":{"token":"123456789:AAExampleExampleExampleExampleExample"}}}},"responses":{"200":{"description":"Bağlandı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/BotAyrinti"},{"type":"object","required":["warning"],"properties":{"warning":{"type":["string","null"]}}}]}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/disconnect":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"disconnectBot","summary":"Kanal bağlantısını kaldırır","description":"Telegram webhook'u silinir, jetonlar silinir, bot taslağa döner; kişi ve sohbetler korunur. Bağlı değilse 409 not_connected. Kapsam: bots:write.","responses":{"200":{"description":"Bağlantı kaldırıldı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/pause":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"pauseBot","summary":"Botu duraklatır","description":"Kapsam: bots:write.","responses":{"200":{"description":"Duraklatıldı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/resume":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"resumeBot","summary":"Botu sürdürür","description":"Kanal bağlı değilse 409 not_connected. Kapsam: bots:write.","responses":{"200":{"description":"Sürdürüldü","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/readiness":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"getBotReadiness","summary":"Canlıya hazırlık denetimi","description":"Kapsam: bots:read.","responses":{"200":{"description":"Denetim","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["ready","items"],"properties":{"ready":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"status":{"enum":["tamam","eksik","uyari","bilinmiyor"]},"group":{"enum":["kanal","ai","hesap"]},"count":{"type":["array","null"],"items":{"type":"integer"}}}}}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/export":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"exportBot","summary":"Bot dosyasını dışa aktarır","description":"Yapılandırma, bilgi kaynakları ve araç tanımları; kanal bilgisi ve sırlar dosyaya girmez. Yönetici yetkisi gerekir. Kapsam: bots:read.","responses":{"200":{"description":"Dosya","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["file_name","file"],"properties":{"file_name":{"type":"string"},"file":{"type":"object","additionalProperties":true},"knowledge_count":{"type":"integer"},"tool_count":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/ai-test":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"testBotReply","summary":"AI yanıtını dener","description":"Kişiye mesaj gitmez, sohbet açılmaz; yanıt test olarak AI kotasından düşer. Son 20 mesaj kullanılır. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["messages"],"additionalProperties":false,"properties":{"messages":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","required":["role","content"],"additionalProperties":false,"properties":{"role":{"enum":["user","assistant"]},"content":{"type":"string","minLength":1,"maxLength":4000}}}}}},"example":{"messages":[{"role":"user","content":"Kargom ne zaman gelir?"}]}}}},"responses":{"200":{"description":"Yanıt","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["reply"],"properties":{"reply":{"type":"string"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/knowledge":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listKnowledgeSources","summary":"Bilgi kaynaklarını listeler","description":"İçerik yerine uzunluk döner. Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Kaynaklar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BilgiKaynagi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"createKnowledgeSource","summary":"Bilgi kaynağı ekler","description":"type: text (content), faq (question, answer), url (herkese açık sayfa; özel ağ adresleri reddedilir, 400 source_fetch_failed) ya da file (file_name ve file_base64; yalnız UTF-8 metin dosyaları, en fazla 256 KB). Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BilgiKaynagiOlustur"},"example":{"type":"faq","title":"Kargo süresi","question":"Kargom ne zaman gelir?","answer":"1-3 iş günü içinde kargoya verilir."}}}},"responses":{"201":{"description":"Eklendi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BilgiKaynagiAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/knowledge/{source_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"source_id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"getKnowledgeSource","summary":"Bilgi kaynağının içeriği","description":"Kapsam: bots:read.","responses":{"200":{"description":"Kaynak","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BilgiKaynagiAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Botlar"],"operationId":"updateKnowledgeSource","summary":"Bilgi kaynağını günceller","description":"URL kaynağında yalnız başlık değişir. SSS kaynağında question ve answer gerekir. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"additionalProperties":false,"properties":{"title":{"type":"string","minLength":2,"maxLength":160},"content":{"type":"string","maxLength":60000},"question":{"type":"string","maxLength":500},"answer":{"type":"string","maxLength":5000}}},"example":{"title":"İade koşulları","content":"İade süresi teslimden itibaren 14 gündür."}}}},"responses":{"200":{"description":"Güncel kaynak","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BilgiKaynagiAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Botlar"],"operationId":"deleteKnowledgeSource","summary":"Bilgi kaynağını siler","description":"Kapsam: bots:write.","responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/knowledge/{source_id}/refresh":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"source_id","in":"path","required":true,"description":"URL kaynağının kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"refreshKnowledgeSource","summary":"URL kaynağını yeniden çeker","description":"Organizasyon başına saatte en fazla 20. Kapsam: bots:write.","responses":{"200":{"description":"Yenilendi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/BilgiKaynagiAyrinti"},{"type":"object","required":["changed"],"properties":{"changed":{"type":"boolean"}}}]}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/tools":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listBotTools","summary":"Özel AI araçlarını listeler","description":"Gizli başlık değeri ve imza sırrı dönmez. Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Araçlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OzelArac"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"createBotTool","summary":"Özel AI aracı ekler","description":"Adres https olmalı, özel ağ adresleri reddedilir. Bot başına en fazla 10 araç. İmza sırrı (signing_secret) yalnız bu yanıtta döner. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OzelAracOlustur"},"example":{"name":"stok_sorgula","description":"Ürün stok durumunu sorgular.","url":"https://ornek.com/stok","fields":[{"name":"urun_kodu","type":"string","required":true,"description":"Ürün kodu"}]}}}},"responses":{"201":{"description":"Eklendi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/OzelArac"},{"type":"object","required":["signing_secret"],"properties":{"signing_secret":{"type":"string"}}}]}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/tools/{tool_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"tool_id","in":"path","required":true,"description":"Araç kimliği","schema":{"type":"string","format":"uuid"}}],"patch":{"tags":["Botlar"],"operationId":"updateBotTool","summary":"Özel AI aracını günceller","description":"Yalnız gönderilen alanlar değişir; imza sırrı değişmez, secret_header_value gönderilmezse mevcut değer korunur. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OzelAracGuncelle"},"example":{"enabled":false}}}},"responses":{"200":{"description":"Güncel araç","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OzelArac"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Botlar"],"operationId":"deleteBotTool","summary":"Özel AI aracını siler","description":"Kapsam: bots:write.","responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/tools/{tool_id}/test":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"tool_id","in":"path","required":true,"description":"Araç kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"testBotTool","summary":"Özel aracı örnek girdiyle çağırır","description":"Müşterinin adresine gerçek istek gider (X-Hiboty-Test başlığıyla); kişi ve sohbet kimliği gönderilmez. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"additionalProperties":false,"properties":{"input":{"type":"object","additionalProperties":true}}},"example":{"input":{"urun_kodu":"A-100"}}}}},"responses":{"200":{"description":"Sonuç","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"success":{"type":"boolean"},"uncertain":{"type":"boolean"},"status":{"type":["integer","null"]},"duration_ms":{"type":"integer"},"body":{"type":"string"},"truncated":{"type":"boolean"},"model_text":{"type":"string"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/versions":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listBotVersions","summary":"Yapılandırma sürümlerini listeler","description":"Bot başına son 50 sürüm saklanır. Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Sürümler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BotSurumu"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/versions/{version_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"version_id","in":"path","required":true,"description":"Sürüm kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"getBotVersion","summary":"Sürüm farkı ve geri alma önizlemesi","description":"restore_token, önizlenen hâli temsil eder; restoreBotVersion'a aynen verilir. Yönetici değilse restore null döner. Kapsam: bots:read.","responses":{"200":{"description":"Sürüm","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotSurumAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/versions/{version_id}/restore":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"version_id","in":"path","required":true,"description":"Sürüm kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"restoreBotVersion","summary":"Sürüme geri döner","description":"Yeni sürüm yazar, tarih silinmez; kanal bağlantısı ve durum değişmez. Önizlemeden sonra ayarlar değiştiyse 409 stale_version döner. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["restore_token"],"additionalProperties":false,"properties":{"restore_token":{"type":"string"}}},"example":{"restore_token":"f3a1c9…"}}}},"responses":{"200":{"description":"Geri alındı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["new_version","restored_version"],"properties":{"new_version":{"type":["integer","null"],"description":"Yayın onayı açıksa null; geri alma onay bekler"},"restored_version":{"type":"integer"},"pending_approval":{"type":"boolean"},"tools_need_secret":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/profile":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"getBotProfile","summary":"Kanal vitrin metinleri","description":"Telegram bot adı ve açıklamaları ya da WhatsApp işletme profili; kanaldan canlı okunur. Yönetici yetkisi gerekir. Kapsam: bots:read.","responses":{"200":{"description":"Vitrin","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotVitrini"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}},"put":{"tags":["Botlar"],"operationId":"updateBotProfile","summary":"Vitrin metinlerini kanala yazar","description":"Telegram botunda tr ve en, WhatsApp botunda about, vertical (ve isteğe bağlı description, website). Müşteriye görünen kanal profili değişir. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotVitrinGuncelle"},"example":{"tr":{"name":"Mağaza Asistanı","short_description":"Sipariş ve kargo soruları","description":"Sipariş, kargo ve iade sorularınızı yanıtlar."},"en":{"name":"Store Assistant","short_description":"Orders and shipping","description":"Answers your order, shipping and return questions."}}}}},"responses":{"200":{"description":"Yazıldı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["changed"],"properties":{"changed":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/profile/suggest":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"suggestBotProfile","summary":"AI ile vitrin önerisi üretir","description":"Kanala yazmaz; AI kotasından düşer. Kapsam: bots:write.","responses":{"200":{"description":"Öneri","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotVitrini"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/eval-cases":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listBotEvalCases","summary":"AI değerlendirme vakalarını listeler","description":"Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Vakalar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DegerlendirmeVakasi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"createBotEvalCase","summary":"Değerlendirme vakası ekler","description":"Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DegerlendirmeVakasiGirdisi"},"example":{"question":"İade süreniz nedir?","must_include":["14 gün"],"must_not_include":[],"expect_handoff":false}}}},"responses":{"201":{"description":"Eklendi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/DegerlendirmeVakasi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/eval-cases/{case_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"case_id","in":"path","required":true,"description":"Vaka kimliği","schema":{"type":"string","format":"uuid"}}],"patch":{"tags":["Botlar"],"operationId":"updateBotEvalCase","summary":"Değerlendirme vakasını günceller","description":"Vakanın tamamı gönderilir. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DegerlendirmeVakasiGirdisi"},"example":{"question":"İade süreniz nedir?","must_include":["14 gün"],"must_not_include":["30 gün"],"expect_handoff":false}}}},"responses":{"200":{"description":"Güncel vaka","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/DegerlendirmeVakasi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Botlar"],"operationId":"deleteBotEvalCase","summary":"Değerlendirme vakasını siler","description":"Kapsam: bots:write.","responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/eval-runs":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listBotEvalRuns","summary":"Değerlendirme çalıştırmalarını listeler","description":"Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Çalıştırmalar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DegerlendirmeCalistirma"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"runBotEval","summary":"Değerlendirme çalıştırır","description":"kind: cases (vaka seti) ya da security (hazır saldırı listesi). Her yanıt AI kotasından düşer; müşteriye mesaj gitmez, araçlar çağrılmaz. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind"],"additionalProperties":false,"properties":{"kind":{"enum":["cases","security"]}}},"example":{"kind":"cases"}}}},"responses":{"201":{"description":"Tamamlandı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","summary"],"properties":{"id":{"type":"string","format":"uuid"},"summary":{"$ref":"#/components/schemas/DegerlendirmeOzeti"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/eval-runs/{run_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"run_id","in":"path","required":true,"description":"Çalıştırma kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"getBotEvalRun","summary":"Çalıştırma sonuçları","description":"Kapsam: bots:read.","responses":{"200":{"description":"Sonuçlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/DegerlendirmeAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/acquisition-links":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listAcquisitionLinks","summary":"Edinme bağlantılarını listeler","description":"Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Bağlantılar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EdinmeBaglantisi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"createAcquisitionLink","summary":"Edinme bağlantısı oluşturur","description":"code boşsa addan üretilir. prefill_text yalnız WhatsApp'ta kullanılır. Bot başına en fazla 50. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":40},"code":{"type":"string","maxLength":32},"prefill_text":{"type":"string","maxLength":200}}},"example":{"name":"Instagram Biyografi","code":"instagram"}}}},"responses":{"201":{"description":"Oluşturuldu","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","name","code"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"code":{"type":"string"},"prefill_text":{"type":"string"},"url":{"type":["string","null"]}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/acquisition-links/{link_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"link_id","in":"path","required":true,"description":"Bağlantı kimliği","schema":{"type":"string","format":"uuid"}}],"delete":{"tags":["Botlar"],"operationId":"deleteAcquisitionLink","summary":"Edinme bağlantısını siler","description":"Kişilerin kaydedilmiş kaynak kodu korunur. Kapsam: bots:write.","responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/whatsapp-templates":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listWhatsAppTemplates","summary":"Bütün WhatsApp şablonları","description":"Onay bekleyen ve reddedilenler dahil; yalnız onaylılar için listTemplates. Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Şablonlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WhatsAppSablonu"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}},"post":{"tags":["Botlar"],"operationId":"createWhatsAppTemplate","summary":"WhatsApp şablonu oluşturur","description":"Şablon Meta incelemesine gider. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhatsAppSablonuOlustur"},"example":{"name":"siparis_kargoda","category":"UTILITY","language":"tr","body":"Merhaba {{1}}, siparişiniz kargoya verildi.","examples":["Ayşe"]}}}},"responses":{"201":{"description":"İncelemeye gönderildi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","name","status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/whatsapp-templates/{name}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"name","in":"path","required":true,"description":"Şablon adı","schema":{"type":"string","pattern":"^[a-z0-9_]{1,512}$"}}],"delete":{"tags":["Botlar"],"operationId":"deleteWhatsAppTemplate","summary":"WhatsApp şablonunu siler","description":"Şablon Meta'dan bütün dilleriyle silinir. Kapsam: bots:write.","responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["name","deleted"],"properties":{"name":{"type":"string"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/ai-feedback":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Botlar"],"operationId":"listAiFeedback","summary":"Beğenilmeyen AI yanıtlarını listeler","description":"Çözülmemiş yanıtlar, kişinin sorusuyla. Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Yanıtlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AiGeriBildirim"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/ai-feedback/{message_id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Bot kimliği","schema":{"type":"string","format":"uuid"}},{"name":"message_id","in":"path","required":true,"description":"Mesaj kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Botlar"],"operationId":"resolveAiFeedback","summary":"Beğenilmeyen yanıtı çözer","description":"add_faq: question ve answer ile SSS kaynağı oluşturur; dismiss: yalnız listeden gizler. Kapsam: bots:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"additionalProperties":false,"properties":{"action":{"enum":["add_faq","dismiss"]},"question":{"type":"string","maxLength":500},"answer":{"type":"string","maxLength":5000}}},"example":{"action":"add_faq","question":"İade süreniz nedir?","answer":"Teslimden itibaren 14 gündür."}}}},"responses":{"200":{"description":"Çözüldü","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","resolved","knowledge_source_id"],"properties":{"id":{"type":"string","format":"uuid"},"resolved":{"type":"boolean"},"knowledge_source_id":{"type":["string","null"],"format":"uuid"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts":{"get":{"tags":["Kişiler"],"operationId":"listContacts","summary":"Kişileri en yeniden eskiye listeler","parameters":[{"name":"bot_id","in":"query","description":"Yalnızca bu botun kişileri","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Kişiler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Kisi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Kişiler"],"operationId":"createContact","summary":"Kişi ekler","description":"İçe aktarmayla aynı kural geçerlidir: izin \"unknown\" başlar, kişi bota kendisi yazmadan kampanya almaz. Telegram botunda external_id (sayısal sohbet kimliği) gerekir; WhatsApp botunda external_id yoksa phone kullanılır. Aynı kanal kimliği varsa 409 contact_exists döner. Yönetici yetkisi gerekir. Kapsam: contacts:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["bot_id"],"properties":{"bot_id":{"type":"string","format":"uuid"},"external_id":{"type":"string","maxLength":64},"name":{"type":"string","maxLength":120},"username":{"type":"string","maxLength":64},"phone":{"type":"string","maxLength":32},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":32}},"notes":{"type":"string","maxLength":4000},"attributes":{"$ref":"#/components/schemas/OzelAlanlar"}}},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","external_id":"123456789","name":"Ayşe Yılmaz","tags":["vip"]}}}},"responses":{"201":{"description":"Kişi ekler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KisiAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}]}},"/api/v1/contacts/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Kişi kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Kişiler"],"operationId":"getContact","summary":"Tek kişiyi döner (etiket, not ve özel alanlar dahil)","responses":{"200":{"description":"Kişi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KisiAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Kişiler"],"operationId":"updateContact","summary":"Ad, not, etiket ve özel alanları günceller","description":"tags tüm listeyi değiştirir; add_tags / remove_tags yalnızca ekler veya çıkarır. attributes yalnızca panelde tanımlı alanları kabul eder; null alanı temizler. Kapsam: write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KisiGuncelle"},"example":{"name":"Ayşe Yılmaz","add_tags":["vip"],"notes":"Kurumsal teklif istedi"}}}},"responses":{"200":{"description":"Güncel kişi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KisiAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Kişiler"],"operationId":"deleteContact","summary":"Kişiyi kalıcı olarak siler (KVKK)","description":"Kişi, sohbetleri, mesajları ve kişiye bağlı diğer kişisel veriler geri alınamaz biçimde silinir. Denetim kaydında kanal kimliğinin yalnız özeti kalır. Yönetici yetkisi gerekir. Kapsam: contacts:write.","responses":{"200":{"description":"Kişiyi kalıcı olarak siler (KVKK)","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/{id}/consent":{"parameters":[{"name":"id","in":"path","required":true,"description":"Kişi kimliği","schema":{"type":"string","format":"uuid"}}],"get":{"tags":["Kişiler"],"operationId":"getContactConsent","summary":"Güncel izin ve izin geçmişi (en yeni önce, en fazla 50)","description":"Kişiler STOP/DUR yazarak çıkar, BAŞLA/START ile yeniden katılır.","responses":{"200":{"description":"İzin","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/IzinDurumu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Kişiler"],"operationId":"updateContactConsent","summary":"İletişim iznini (ve isteğe bağlı etiketleri) günceller","description":"Değişiklik izin defterine \"api\" kaynağıyla yazılır. tags verilirse kişinin etiket listesinin tamamını değiştirir; yalnız eklemek için updateContact add_tags kullanın. Kapsam: write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["consent"],"additionalProperties":false,"properties":{"consent":{"enum":["opted_in","opted_out"]},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":32}}}},"example":{"consent":"opted_in","tags":["bulten"]}}}},"responses":{"200":{"description":"Güncel izin","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"consent":{"$ref":"#/components/schemas/Izin"},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations":{"get":{"tags":["Sohbetler"],"operationId":"listConversations","summary":"Sohbetleri son mesaja göre listeler","parameters":[{"name":"bot_id","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","schema":{"$ref":"#/components/schemas/SohbetDurumu"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 100); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Sohbetler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Sohbet"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/status":{"parameters":[{"name":"id","in":"path","required":true,"description":"Sohbet kimliği","schema":{"type":"string","format":"uuid"}}],"post":{"tags":["Sohbetler"],"operationId":"updateConversationStatus","summary":"Sohbet durumunu değiştirir","description":"open: AI yeniden yanıtlar; handoff: temsilciye devreder, AI susar; closed: kapatır (memnuniyet anketi açıksa kişiye gider). Kapsam: write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"additionalProperties":false,"properties":{"status":{"$ref":"#/components/schemas/SohbetDurumu"}}},"example":{"status":"handoff"}}}},"responses":{"200":{"description":"Güncel durum","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/SohbetDurumu"},"previous_status":{"$ref":"#/components/schemas/SohbetDurumu"},"assigned_user_id":{"type":["string","null"],"format":"uuid"},"closed_at":{"type":["string","null"],"format":"date-time"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/campaigns":{"get":{"tags":["Kampanyalar"],"operationId":"listCampaigns","summary":"Kampanyaları listele","parameters":[{"name":"bot_id","in":"query","description":"Yalnız bu bot","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","description":"Durum süzgeci; başka değer 400 döner","schema":{"enum":["draft","pending_approval","approved","sending","completed","failed","cancelled"]}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 100); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Kampanyalar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Kampanya"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Kampanyalar"],"operationId":"createCampaign","summary":"Kampanya oluştur (onay bekler)","description":"Kampanya \"pending_approval\" durumunda oluşur ve panelde yönetici onaylayana kadar gönderilmez; API gönderimi başlatamaz. Telegram botunda body (A/B için body_b), WhatsApp botunda onaylı template gerekir. Organizasyonun içerik politikası açıksa metin, şablon parametreleri ve görsel adresi denetlenir; engele takılan istek 422 content_policy döner. Yanlış segment alanı 400 döner; süzgece uyan kişi yoksa 409 empty_audience döner, kampanya tüm kitleye düşmez. Anahtarı oluşturan (OAuth'ta yetkiyi veren) kişinin e-postası doğrulanmamışsa 403 email_not_verified döner. Yeniden denemede çift kampanyayı önlemek için Idempotency-Key kullanın. Kapsam: write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Organizasyon + uç + anahtar başına 24 saat geçerlidir: aynı anahtar ve aynı gövdeyle ilk yanıt aynen döner (Idempotency-Replayed: true), işlem tekrarlanmaz. Farklı gövdede 409 idempotency_conflict; ilk istek sürerken 409 idempotency_in_progress ve Retry-After. 5xx ve 429 yanıtları saklanmaz, aynı anahtarla yeniden denenebilir.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KampanyaOlustur"},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"Kasım indirimi","body":"Merhaba {{ad}}, kasım indirimimiz başladı!","segment":{"include_tags":["vip"]}}}}},"responses":{"201":{"description":"Oluşturuldu (onay bekliyor)","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Kampanya"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/campaigns/{id}":{"get":{"tags":["Kampanyalar"],"operationId":"getCampaign","summary":"Kampanya ve varyant sonuçları","parameters":[{"name":"id","in":"path","required":true,"description":"Kampanya kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Kampanya","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KampanyaAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Kampanyalar"],"operationId":"updateCampaign","summary":"Başlamamış kampanyayı günceller","description":"Yalnız draft ve pending_approval durumundaki kampanya değişir; başka durumda 409 campaign_locked döner. createCampaign ile aynı denetimler uygulanır: içerik politikası (422 content_policy), segment, boş kitle (409 empty_audience), WhatsApp'ta onaylı şablon. Değişen kampanya yeniden onay ister: durum pending_approval olur, onay bilgisi temizlenir, değişikliği yapan oluşturan sayılır (dört göz açıkken kendi yazdığını onaylayamaz; anahtarla yapılan değişiklik dört gözde panelden onaylanamaz). API gönderim başlatamaz: onay ucu yoktur, kampanya yalnız panelde dört göz onayıyla başlar. body_b, media_url, topic ve scheduled_at null ile temizlenir. Kapsam: campaigns:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":120},"body":{"type":"string","minLength":5,"maxLength":4000},"body_b":{"type":["string","null"],"minLength":5,"maxLength":4000},"media_url":{"type":["string","null"],"maxLength":500},"template":{"type":"object","additionalProperties":false,"required":["name","language"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","minLength":1,"maxLength":20},"params":{"type":"array","items":{"type":"string"}},"params_b":{"type":"array","items":{"type":"string"}}}},"topic":{"type":["string","null"],"maxLength":40},"scheduled_at":{"type":["string","null"],"format":"date-time"},"segment":{"type":"object","description":"Etiket, son görülme, sipariş, kaynak, özel alan ve sıcaklık koşulları; createCampaign ile aynı biçim. Boş nesne: botun bütün izinli kişileri."}},"minProperties":1},"example":{"name":"Kasım indirimi","body":"Merhaba, kasım indirimimiz başladı!"}}}},"responses":{"200":{"description":"Başlamamış kampanyayı günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Kampanya"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]},"delete":{"tags":["Kampanyalar"],"operationId":"deleteCampaign","summary":"Gönderilmemiş kampanyayı siler","description":"Yalnız henüz gönderim yapılmamış draft, pending_approval ve cancelled kampanyalar silinir; başlamışsa 409 campaign_started döner. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","responses":{"200":{"description":"Gönderilmemiş kampanyayı siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]}},"/api/v1/campaigns/{id}/cancel":{"post":{"tags":["Kampanyalar"],"operationId":"cancelCampaign","summary":"Bitmemiş kampanyayı iptal et","description":"Gönderim sürüyorsa kalan alıcılara gitmez; gönderilmiş mesajlar geri alınmaz. Kapsam: write.","parameters":[{"name":"id","in":"path","required":true,"description":"Kampanya kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"İptal edildi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Kampanya"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps":{"get":{"tags":["Mini App"],"operationId":"listMiniApps","summary":"Mini App'leri listele","parameters":[{"name":"bot_id","in":"query","description":"Yalnız bu bot","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 100); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Mini App'ler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MiniApp"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Mini App"],"operationId":"createMiniApp","summary":"Mini App oluşturur","description":"Şablonun hazır taslağıyla, yayınlanmamış başlar. Bot kanala bağlı olmalıdır (409 not_connected). form_preset yalnız form şablonunda kullanılır. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["bot_id","name","template"],"properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":2,"maxLength":60},"template":{"enum":["katalog","form","baglanti"]},"form_preset":{"enum":["iletisim","randevu","anket","basvuru","bos"]}}},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"Randevu formu","template":"form","form_preset":"randevu"}}}},"responses":{"201":{"description":"Mini App oluşturur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}]}},"/api/v1/miniapps/{id}/submissions":{"get":{"tags":["Mini App"],"operationId":"listMiniAppSubmissions","summary":"Mini App gönderimleri ve siparişleri","parameters":[{"name":"id","in":"path","required":true,"description":"Mini App kimliği","schema":{"type":"string","format":"uuid"}},{"name":"kind","in":"query","description":"Tür süzgeci (randevu ve iptal_talebi AI talep araçlarından gelir)","schema":{"enum":["form","order","randevu","iptal_talebi"]}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Gönderimler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MiniAppGonderimi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/orders/{id}":{"patch":{"tags":["Mini App"],"operationId":"updateOrder","summary":"Sipariş durumunu değiştir","description":"notify true ise müşteriye bot üzerinden durum mesajı gider; bunun için messages:send kapsamı da gerekir. Durum değişip bildirim gidemezse yanıt yine 200'dür ve data.notification { sent: false, error } içerir. Kapsam: write.","parameters":[{"name":"id","in":"path","required":true,"description":"Sipariş (gönderim) kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"additionalProperties":false,"properties":{"status":{"enum":["yeni","hazirlaniyor","tamamlandi","iptal"]},"notify":{"type":"boolean","default":false}}},"example":{"status":"hazirlaniyor","notify":true}}}},"responses":{"200":{"description":"Güncellendi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"notification":{"type":"object","required":["sent","error"],"description":"Yalnız bildirim gönderilemediğinde bulunur","properties":{"sent":{"const":false},"error":{"type":"string"}}}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"get":{"tags":["Mini App"],"operationId":"getOrder","summary":"Sipariş ayrıntısı","description":"Ödemenin teslimat içeriği ve Telegram tahsilat kimliği dönmez. Kapsam: miniapps:read.","responses":{"200":{"description":"Sipariş ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Siparis"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]}},"/api/v1/automations":{"get":{"tags":["Otomasyonlar"],"operationId":"listAutomations","summary":"Otomasyonları listele","parameters":[{"name":"bot_id","in":"query","description":"Yalnız bu bot","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 100); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak; eski date-time imleçleri de kabul edilir)","schema":{"type":"string"}}],"responses":{"200":{"description":"Otomasyonlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Otomasyon"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç (cursor parametresine aynen verilir); son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Otomasyonlar"],"operationId":"createAutomation","summary":"Otomasyon oluşturur","description":"Otomasyon kapalı başlar. trigger_config ve steps verilmezse tetikleyicinin hazır başlangıcı kullanılır; verilenler panelle aynı kurallarla doğrulanır (400 automation_invalid). Webhook adımının adresi herkese açık https olmalıdır. Yönetici yetkisi gerekir. Kapsam: automations:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["bot_id","name","trigger"],"properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":2,"maxLength":60},"trigger":{"enum":["yeni_kisi","anahtar_kelime","etiket_eklendi","sessiz","miniapp_gonderim"]},"trigger_config":{"type":"object"},"steps":{"type":"array","items":{"type":"object"}}}},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"Fiyat sorusu","trigger":"anahtar_kelime","trigger_config":{"kelimeler":["fiyat"],"eslesme":"icerir","aiBastir":true,"tekrarGun":0},"steps":[{"tur":"mesaj","metin":"Fiyat listemizi hemen paylaşıyoruz."},{"tur":"devret"}]}}}},"responses":{"201":{"description":"Otomasyon oluşturur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OtomasyonDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}]}},"/api/v1/automations/{id}":{"patch":{"tags":["Otomasyonlar"],"operationId":"updateAutomation","summary":"Otomasyonu etkinleştir ya da durdur","description":"Etkinleştirmede panelle aynı doğrulama yapılır; durdurmada süren çalıştırmalar da durur. Kapsam: write.","parameters":[{"name":"id","in":"path","required":true,"description":"Otomasyon kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["active"],"additionalProperties":false,"properties":{"active":{"type":"boolean"}}},"example":{"active":true}}}},"responses":{"200":{"description":"Güncellendi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Otomasyon"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"get":{"tags":["Otomasyonlar"],"operationId":"getAutomation","summary":"Otomasyon ayrıntısı","description":"Tetikleyici ayarı ve adımlarla döner. Üye rolü yalnız erişebildiği botların otomasyonlarını görür. Kapsam: automations:read.","responses":{"200":{"description":"Otomasyon ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OtomasyonDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]},"put":{"tags":["Otomasyonlar"],"operationId":"saveAutomation","summary":"Otomasyonu kaydeder","description":"Ad, tetikleyici ayarı ve adımların tamamını değiştirir; tetikleyici değişmez. Geçersiz yapılandırma 400 automation_invalid döner. Açma ve kapatma PATCH ile yapılır. Yönetici yetkisi gerekir. Kapsam: automations:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","trigger_config","steps"],"properties":{"name":{"type":"string","minLength":2,"maxLength":60},"trigger_config":{"type":"object"},"steps":{"type":"array","items":{"type":"object"}}}},"example":{"name":"Fiyat sorusu","trigger_config":{"kelimeler":["fiyat"],"eslesme":"icerir","aiBastir":true,"tekrarGun":0},"steps":[{"tur":"mesaj","metin":"Fiyat listemizi hemen paylaşıyoruz."},{"tur":"devret"}]}}}},"responses":{"200":{"description":"Otomasyonu kaydeder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OtomasyonDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]},"delete":{"tags":["Otomasyonlar"],"operationId":"deleteAutomation","summary":"Otomasyonu siler","description":"Otomasyon ve çalıştırma geçmişi geri alınamaz biçimde silinir. Yönetici yetkisi gerekir. Kapsam: automations:write.","responses":{"200":{"description":"Otomasyonu siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]}},"/api/v1/templates":{"get":{"tags":["Botlar"],"operationId":"listTemplates","summary":"WhatsApp botunun onaylı şablonları","parameters":[{"name":"bot_id","in":"query","required":true,"description":"WhatsApp botu","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Şablonlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Sablon"}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/webhooks":{"get":{"tags":["Webhook"],"operationId":"listWebhooks","summary":"Webhook'ları listele","responses":{"200":{"description":"Webhook'lar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Webhook"],"operationId":"createWebhook","summary":"Webhook oluştur","description":"İmza sırrı (secret) yalnız bu yanıtta döner. Adres herkese açık https olmalıdır; localhost ve özel ağ adresleri 400 döner. Ardışık 50 başarısız teslimde webhook kapanır (active: false); enableWebhook ya da panel ile yeniden açılır. Kapsam: write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","events"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Herkese açık https adresi"},"description":{"type":"string","maxLength":120},"events":{"type":"array","minItems":1,"maxItems":30,"items":{"$ref":"#/components/schemas/WebhookOlayi"},"description":"Olay adları, ör. message.received"}}},"example":{"url":"https://ornek.com/hiboty-webhook","description":"CRM","events":["message.received","conversation.handoff"]}}}},"responses":{"201":{"description":"Oluşturuldu","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/Webhook"},{"type":"object","required":["secret"],"properties":{"secret":{"type":"string"}}}]}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/webhooks/{id}":{"delete":{"tags":["Webhook"],"operationId":"deleteWebhook","summary":"Webhook'u sil","parameters":[{"name":"id","in":"path","required":true,"description":"Webhook kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Silindi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"get":{"tags":["Webhook"],"operationId":"getWebhook","summary":"Webhook ayrıntısı","description":"İmza sırrı dönmez. Yönetici yetkisi gerekir. Kapsam: webhooks:read.","responses":{"200":{"description":"Webhook ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]},"patch":{"tags":["Webhook"],"operationId":"updateWebhook","summary":"Webhook'u günceller","description":"Yalnız gönderilen alanlar değişir; imza sırrı değişmez. Adres herkese açık https olmalıdır. active true hata sayacını sıfırlar. Yönetici yetkisi gerekir. Kapsam: webhooks:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","maxLength":500},"description":{"type":"string","maxLength":120},"events":{"type":"array","minItems":1,"maxItems":30,"items":{"$ref":"#/components/schemas/WebhookOlayi"}},"active":{"type":"boolean"}},"minProperties":1},"example":{"events":["message.received","conversation.handoff"],"active":true}}}},"responses":{"200":{"description":"Webhook'u günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}},"parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}]}},"/api/v1/webhooks/{id}/enable":{"post":{"tags":["Webhook"],"operationId":"enableWebhook","summary":"Kapanmış webhook'u yeniden aç","description":"Ardışık 50 başarısız teslimde kapanan webhook'u açar ve hata sayacını sıfırlar. Kapsam: write.","parameters":[{"name":"id","in":"path","required":true,"description":"Webhook kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Açıldı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/usage":{"get":{"tags":["Sistem"],"operationId":"getUsage","summary":"Plan ve bu ayın kullanımı","responses":{"200":{"description":"Kullanım","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Kullanim"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/openapi.json":{"get":{"tags":["Sistem"],"operationId":"getOpenApi","summary":"Bu OpenAPI belgesi","security":[],"responses":{"200":{"description":"OpenAPI 3.1 belgesi","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/health":{"get":{"tags":["Sistem"],"operationId":"health","summary":"Sağlık kontrolü (kimlik gerekmez)","security":[],"parameters":[{"name":"cron","in":"query","description":"1 verilirse arka plan işleri durmuşsa da 503 döner","schema":{"enum":["1"]}}],"responses":{"200":{"description":"Sağlıklı","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"enum":["ok","degraded"]},"db":{"enum":["ok","error"]},"cron":{"enum":["ok","stale"]},"cron_age_s":{"type":["integer","null"]},"latency_ms":{"type":"integer"},"time":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Veritabanı ya da (cron=1 ile) arka plan işleri çalışmıyor","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"degraded"},"db":{"enum":["ok","error"]},"time":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/automations/{id}/runs":{"get":{"tags":["Otomasyonlar"],"operationId":"listAutomationRuns","summary":"Otomasyonun çalıştırmalarını listeler","description":"En yeni önce: durum, adım, hata, adım günlüğü ve kişi kimliği. Hata ve günlük metinleri kaydedildiği dilde (Türkçe) döner. Kişinin yanıtlarını taşıyan çalıştırma bağlamı dönmez. Kapsam: automations:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Otomasyonun çalıştırmalarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OtomasyonCalistirmasi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}":{"get":{"tags":["Mini App"],"operationId":"getMiniApp","summary":"Mini App ayrıntısı","description":"Taslak, yayındaki sürüm ve menü düğmesi durumuyla döner. Üye rolü yalnız erişebildiği botların uygulamalarını görür. Kapsam: miniapps:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Mini App ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Mini App"],"operationId":"updateMiniAppDraft","summary":"Taslağı günceller","description":"Yayındaki sürüm değişmez; değişiklik yayınlanınca görünür. config şablon şemasına uymalıdır, uymazsa 400 miniapp_invalid döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":60},"config":{"type":"object"}},"minProperties":1},"example":{"name":"Menü","config":{"baslik":"Menü","urunler":[{"id":"urun1","ad":"Kahve","fiyat":"90 TL"}]}}}}},"responses":{"200":{"description":"Taslağı günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Mini App"],"operationId":"deleteMiniApp","summary":"Mini App'i siler","description":"Uygulama, sürümleri ve gönderimleri geri alınamaz biçimde silinir; menü düğmesine bağlıysa Telegram menüsü varsayılana döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Mini App'i siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/publish":{"post":{"tags":["Mini App"],"operationId":"publishMiniApp","summary":"Taslağı yayınlar","description":"Taslaktan yeni değişmez sürüm oluşur ve herkese açılır; yayın onayı açıksa sürüm onay bekler ve yayındaki sürüm değişmez. Plan Mini App içermiyorsa 403 plan_limit, taslak geçersizse 400 miniapp_invalid döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Taslağı yayınlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/unpublish":{"post":{"tags":["Mini App"],"operationId":"unpublishMiniApp","summary":"Yayından kaldırır","description":"Herkese açık sayfa kapanır; menü düğmesine bağlıysa Telegram menüsü varsayılana döner. Sürümler silinmez. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Yayından kaldırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/rollback":{"post":{"tags":["Mini App"],"operationId":"rollbackMiniApp","summary":"Önceki sürüme döner","description":"Verilen sürüm yeniden yayına alınır, taslak değişmez. Plan Mini App içermiyorsa 403 plan_limit döner; sürüm bu uygulamanın değilse 404. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["version_id"],"properties":{"version_id":{"type":"string","format":"uuid"}}},"example":{"version_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"}}}},"responses":{"200":{"description":"Önceki sürüme döner","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/menu-button":{"post":{"tags":["Mini App"],"operationId":"setMiniAppMenuButton","summary":"Telegram menü düğmesini ayarlar","description":"enabled true botun menü düğmesini bu uygulamaya bağlar (uygulama yayında olmalı), false varsayılana döndürür. Bir botun tek menü düğmesi olur. Yayında değilse ya da bot bağlı değilse 409, Telegram reddederse 502 döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["enabled"],"properties":{"enabled":{"type":"boolean"}}},"example":{"enabled":true}}}},"responses":{"200":{"description":"Telegram menü düğmesini ayarlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/miniapps/{id}/versions":{"get":{"tags":["Mini App"],"operationId":"listMiniAppVersions","summary":"Sürümleri listeler","description":"Sürümler, en yeni önce. Yayın onayı bekleyen ve reddedilen sürümler status alanıyla ayrılır. Kapsam: miniapps:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Sürümleri listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MiniAppSurumu"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/preview":{"get":{"tags":["Mini App"],"operationId":"getMiniAppPreview","summary":"Taslak önizlemesi","description":"Taslağı gösteren, 2 saat geçerli imzalı adres ve taslak yapılandırma döner. Adresi yalnız güvendiğiniz kişilerle paylaşın. Taslak geçersizse valid false olur ve errors doldurulur. Kapsam: miniapps:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Taslak önizlemesi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppOnizlemesi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/orders":{"get":{"tags":["Mini App"],"operationId":"listOrders","summary":"Siparişleri listeler","description":"En yeni önce. Üye rolü yalnız erişebildiği botların siparişlerini görür. Telegram Stars iadesi API'de yoktur: geri alınamaz para hareketi olduğu için panelde yapılır. Kapsam: miniapps:read.","parameters":[{"name":"status","in":"query","description":"Sipariş durumu","schema":{"enum":["yeni","hazirlaniyor","tamamlandi","iptal"]}},{"name":"app_id","in":"query","description":"Yalnız bu Mini App","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Siparişleri listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Siparis"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/custom-miniapps":{"get":{"tags":["Özel Mini App"],"operationId":"listCustomMiniAppRequests","summary":"Özel Mini App taleplerini listeler","description":"En yeni önce. Teklif ve bağlantılar panelde göründükleri aşamalarda döner. Kapsam: miniapps:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Özel Mini App taleplerini listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OzelMiniAppTalebi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Özel Mini App"],"operationId":"createCustomMiniAppRequest","summary":"Özel Mini App talebi açar","description":"Talep Hiboty ekibine iletilir, teklifi ekip hazırlar. Saatte en fazla 5 talep (429); açık talep sınırı doluysa 409 open_limit döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["title","description"],"properties":{"title":{"type":"string","minLength":3,"maxLength":120},"description":{"type":"string","minLength":30,"maxLength":4000},"examples":{"type":"string","maxLength":1000},"budget":{"type":"string","maxLength":60},"takes_payment":{"type":"boolean"},"handles_personal_data":{"type":"boolean"}}},"example":{"title":"Randevu uygulaması","description":"Müşterilerin hizmet seçip randevu alabildiği, hatırlatma gönderen bir uygulama istiyoruz.","budget":"500 USD","takes_payment":false,"handles_personal_data":true}}}},"responses":{"201":{"description":"Özel Mini App talebi açar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OzelMiniAppTalebi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/custom-miniapps/{id}":{"get":{"tags":["Özel Mini App"],"operationId":"getCustomMiniAppRequest","summary":"Özel Mini App talebi ayrıntısı","description":"Yalnız bu organizasyonun talepleri görünür; ekibin iç notları dönmez. Kapsam: miniapps:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Özel Mini App talebi ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OzelMiniAppTalebi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/custom-miniapps/{id}/accept":{"post":{"tags":["Özel Mini App"],"operationId":"acceptCustomMiniAppQuote","summary":"Teklifi kabul eder","description":"Yalnız teklif aşamasında geçerlidir, başka durumda 409 invalid_status döner. Kabulden sonra ödeme bağlantısı iletilir ve iptal ekip üzerinden yürür. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Teklifi kabul eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OzelMiniAppTalebi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/custom-miniapps/{id}/approve-preview":{"post":{"tags":["Özel Mini App"],"operationId":"approveCustomMiniAppPreview","summary":"Önizlemeyi onaylar","description":"Yalnız önizleme aşamasında geçerlidir, başka durumda 409 invalid_status döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Önizlemeyi onaylar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OzelMiniAppTalebi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/custom-miniapps/{id}/cancel":{"post":{"tags":["Özel Mini App"],"operationId":"cancelCustomMiniAppRequest","summary":"Talebi iptal eder","description":"Teklif kabul edilmeden önce geçerlidir, başka durumda 409 invalid_status döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Talebi iptal eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OzelMiniAppTalebi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/import":{"post":{"tags":["Kişiler"],"operationId":"importContacts","summary":"CSV metninden kişileri içe aktarır","description":"En fazla 2 MB ve 5.000 satır; ayraç noktalı virgül, virgül ya da sekme olabilir. Yeni kişilerin izni \"unknown\" başlar; var olanın izni yalnız \"izin yok\" yönünde değişir, dolu bilgileri korunur, etiketleri birleşir. Özel alan sütunları anahtar ya da adla eşleşir. errors en fazla 20 satır döner. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["bot_id","csv"],"properties":{"bot_id":{"type":"string","format":"uuid"},"csv":{"type":"string","maxLength":2097152}}},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","csv":"kanal_kimligi;ad;etiketler\n123456789;Ayşe Yılmaz;vip"}}}},"responses":{"200":{"description":"CSV metninden kişileri içe aktarır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KisiIceAktarmaSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/export":{"get":{"tags":["Kişiler"],"operationId":"exportContacts","summary":"Kişileri CSV parçaları hâlinde dışa aktarır","description":"Her sayfa en fazla 1000 kişi taşır. Her satır CRLF ile biter; BOM ve başlık yalnız ilk sayfadadır, csv parçalarını sırayla uç uca ekleyince tek dosya olur. Formül enjeksiyonuna karşı = + - @ ile başlayan hücreler kaçışlanır. Her sayfa denetim kaydına yazılır. Yönetici yetkisi gerekir. Kapsam: contacts:read.","parameters":[{"name":"consent","in":"query","description":"İzin durumu","schema":{"enum":["opted_in","opted_out","unknown"]}},{"name":"tag","in":"query","description":"Bu etiketi taşıyanlar","schema":{"type":"string"}},{"name":"q","in":"query","description":"Ad, kullanıcı adı, telefon ya da kanal kimliğinde arama","schema":{"type":"string"}},{"name":"bot_id","in":"query","description":"Yalnız bu bot","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–1000, varsayılan 1000); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":1000,"default":1000}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Kişileri CSV parçaları hâlinde dışa aktarır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"csv":{"type":"string"},"row_count":{"type":"integer"},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/bulk":{"post":{"tags":["Kişiler"],"operationId":"bulkContacts","summary":"Kişilere toplu işlem uygular","description":"tag_add, tag_remove, opt_out ya da delete; tek seferde en fazla 200 kişi. delete geri alınamaz ve yönetici ister. Üye yalnız erişebildiği botların kişilerini işler; diğer kimlikler sessizce dışarıda kalır, affected gerçekten değişen sayıdır. Kapsam: contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["operation","ids"],"properties":{"operation":{"enum":["tag_add","tag_remove","opt_out","delete"]},"ids":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"string","format":"uuid"}},"tag":{"type":"string","maxLength":32,"description":"tag_add ve tag_remove için gerekli"}}},"example":{"operation":"tag_add","ids":["3fa85f64-5717-4562-b3fc-2c963f66afa6"],"tag":"vip"}}}},"responses":{"200":{"description":"Kişilere toplu işlem uygular","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"operation":{"type":"string"},"affected":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/{id}/clear-memory":{"post":{"tags":["Kişiler"],"operationId":"clearContactMemory","summary":"Kişinin AI hafızasını temizler","description":"Eski mesajlar yeniden özetlenmez. Kişinin botuna erişebilen her üye yapabilir. Kapsam: contacts:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Kişinin AI hafızasını temizler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"memory_cleared":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/{id}/revoke-links":{"post":{"tags":["Kişiler"],"operationId":"revokeContactLinks","summary":"Kişiye gönderilmiş bağlantıları iptal eder","description":"Daha önce gönderilen tercih ve Mini App bağlantıları çalışmaz olur; yeni gönderilenler çalışır. Kapsam: contacts:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Kişiye gönderilmiş bağlantıları iptal eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"links_revoked":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contacts/{id}/profile-link":{"post":{"tags":["Kişiler"],"operationId":"linkContactProfile","summary":"Kaydı başka bir kayıtla aynı müşteri profiline bağlar","description":"İki kaydın botuna da erişim gerekir; diğer kayıt erişilemiyorsa 404 döner. Bağlanamazsa 409 profile_link_failed, \"profil\" özelliği kapalıysa 409 feature_disabled döner. Kapsam: contacts:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["other_contact_id"],"properties":{"other_contact_id":{"type":"string","format":"uuid"}}},"example":{"other_contact_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"}}}},"responses":{"200":{"description":"Kaydı başka bir kayıtla aynı müşteri profiline bağlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"other_contact_id":{"type":"string","format":"uuid"},"profile_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Kişiler"],"operationId":"unlinkContactProfile","summary":"Kaydı müşteri profilinden ayırır","description":"Kayıt silinmez. Profilde değilse 409 not_linked, \"profil\" özelliği kapalıysa 409 feature_disabled döner. Kapsam: contacts:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Kaydı müşteri profilinden ayırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"unlinked":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contact-tags":{"get":{"tags":["Kişiler"],"operationId":"listContactTags","summary":"Etiketleri kullanım sayılarıyla listeler","description":"Üye yalnız erişebildiği botların kişilerindeki etiketleri görür. En çok kullanılan önce gelir. Kapsam: contacts:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Etiketleri kullanım sayılarıyla listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/KisiEtiketi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contact-tags/rename":{"post":{"tags":["Kişiler"],"operationId":"renameContactTag","summary":"Etiketi yeniden adlandırır","description":"Organizasyondaki bütün kişilere uygulanır; eşleşme harf farkı gözetmez. Otomasyon adımları ve kampanya segmentleri otomatik değişmez. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tag","new_name"],"properties":{"tag":{"type":"string","minLength":1,"maxLength":100},"new_name":{"type":"string","minLength":1,"maxLength":32}}},"example":{"tag":"vip","new_name":"VIP müşteri"}}}},"responses":{"200":{"description":"Etiketi yeniden adlandırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"affected_contacts":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contact-tags/merge":{"post":{"tags":["Kişiler"],"operationId":"mergeContactTags","summary":"Etiketleri tek etikette birleştirir","description":"Tek seferde en fazla 50 etiket. Organizasyondaki bütün kişilere uygulanır; otomasyon adımları ve kampanya segmentleri otomatik değişmez. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tags","target"],"properties":{"tags":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"target":{"type":"string","minLength":1,"maxLength":32}}},"example":{"tags":["vip","premium"],"target":"VIP"}}}},"responses":{"200":{"description":"Etiketleri tek etikette birleştirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"affected_contacts":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contact-tags/delete":{"post":{"tags":["Kişiler"],"operationId":"deleteContactTags","summary":"Etiketleri bütün kişilerden kaldırır","description":"Tek seferde en fazla 50 etiket; kişiler silinmez. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tags"],"properties":{"tags":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}}}},"example":{"tags":["eski-kampanya"]}}}},"responses":{"200":{"description":"Etiketleri bütün kişilerden kaldırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"affected_contacts":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contact-fields":{"get":{"tags":["Kişiler"],"operationId":"listContactFields","summary":"Özel alan tanımlarını listeler","description":"Panelde olduğu gibi üye rolü de okuyabilir. Kapsam: contacts:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Özel alan tanımlarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/KisiOzelAlani"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Kişiler"],"operationId":"createContactField","summary":"Özel alan oluşturur","description":"En fazla 30 alan (409 limit_reached); aynı anahtar 409 field_exists döner. key küçük harfle başlar, a–z, 0–9 ve _ içerir; ad, telefon gibi sistem anahtarları kullanılamaz. options yalnız secim türünde gerekir. AI yazma izni kapalı başlar. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["key","label","type"],"properties":{"key":{"type":"string","minLength":2,"maxLength":32},"label":{"type":"string","minLength":1,"maxLength":50},"type":{"enum":["metin","sayi","tarih","secim"]},"options":{"type":"array","maxItems":30,"items":{"type":"string","maxLength":50}}}},"example":{"key":"sehir","label":"Şehir","type":"secim","options":["İstanbul","Ankara"]}}}},"responses":{"201":{"description":"Özel alan oluşturur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KisiOzelAlani"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/contact-fields/{id}":{"patch":{"tags":["Kişiler"],"operationId":"updateContactField","summary":"Özel alanı günceller","description":"Anahtar ve tür değişmez; options yalnız secim türünde geçerlidir. Listeden çıkan seçeneği taşıyan kişilerin değeri silinir (cleared_contacts). ai_writable, AI kayıt aracının bu alana yazmasına izin verir. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","minLength":1,"maxLength":50},"options":{"type":"array","maxItems":30,"items":{"type":"string","maxLength":50}},"ai_writable":{"type":"boolean"}},"minProperties":1},"example":{"label":"Yaşadığı şehir","ai_writable":true}}}},"responses":{"200":{"description":"Özel alanı günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string","description":"Alan anahtarı: CSV başlığı, attributes anahtarı ve {{anahtar}} değişkeni; değişmez"},"label":{"type":"string"},"type":{"enum":["metin","sayi","tarih","secim"]},"options":{"type":"array","items":{"type":"string"}},"ai_writable":{"type":"boolean"},"cleared_contacts":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Kişiler"],"operationId":"deleteContactField","summary":"Özel alanı siler","description":"Alanın değeri bütün kişilerden geri alınamaz biçimde kaldırılır. Yönetici yetkisi gerekir. Kapsam: contacts:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Özel alanı siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"},"cleared_contacts":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}":{"get":{"tags":["Sohbetler"],"operationId":"getConversation","summary":"Sohbet ayrıntısı","description":"Kişi özeti, bot, atanan üye, erteleme ve mesaj seli durumunu döner. Üye rolü yalnız erişebildiği botların sohbetlerini görür. Kapsam: conversations:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Sohbet ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SohbetAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/assign":{"post":{"tags":["Sohbetler"],"operationId":"assignConversation","summary":"Sohbeti ekip üyesine atar","description":"user_id null ise atama kalkar ve durum değişmez. Atanan varsa sohbet temsilciye geçer, AI susar ve ilk geçişte conversation.handoff olayı yayınlanır. Hedef ekipte değilse 409 not_team_member, bota erişimi yoksa 409 bot_access_denied döner. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":["string","null"],"format":"uuid"}}},"example":{"user_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"}}}},"responses":{"200":{"description":"Sohbeti ekip üyesine atar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SohbetAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/read":{"post":{"tags":["Sohbetler"],"operationId":"markConversationRead","summary":"Sohbeti okundu işaretler","description":"Okunmamış sayacını sıfırlar. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Sohbeti okundu işaretler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SohbetAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/snooze":{"post":{"tags":["Sohbetler"],"operationId":"snoozeConversation","summary":"Sohbeti erteler","description":"option: 1s (1 saat), 3s (3 saat), yarin ve pazartesi (organizasyon saatiyle 09:00), custom ya da null (ertelemeyi kaldırır). custom için until gerekir: saat farkı taşıyan ISO an ya da farksız değer (organizasyon saatiyle okunur); şimdiden sonra ve en fazla 30 gün ileride olmalıdır. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["option"],"properties":{"option":{"enum":["1s","3s","yarin","pazartesi","custom",null]},"until":{"type":"string","maxLength":40,"description":"Yalnız option custom iken"}}},"example":{"option":"yarin"}}}},"responses":{"200":{"description":"Sohbeti erteler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SohbetAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/clear-flood":{"post":{"tags":["Sohbetler"],"operationId":"clearConversationFlood","summary":"Mesaj seli duraklatmasını kaldırır","description":"Mesaj seli nedeniyle duraklatılan AI yanıtı hemen yeniden açılır; duraklatma yoksa bir şey değişmez. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Mesaj seli duraklatmasını kaldırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SohbetAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/reply":{"post":{"tags":["Sohbetler"],"operationId":"replyToConversation","summary":"Temsilci yanıtı gönderir","description":"Müşteriye gerçek mesaj gider (test modunda simüle edilir); sohbet temsilciye geçer ve AI susar. image_url bu organizasyonun yüklediği görselin /u/ adresi olmalıdır ve dış adres kabul edilmez; görselle body açıklamadır ve boş olabilir. Plan sınırını aşan bot (403 bot_plan_restricted), aylık mesaj kotası (429 message_quota_exceeded) ve kişinin iletişim reddi (403 opted_out) POST /messages ile aynı uygulanır. Kanal hatası 502 channel_error döner. Kapsam: messages:send.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","maxLength":4000},"image_url":{"type":"string","maxLength":200}}},"example":{"body":"Merhaba, siparişiniz bugün kargoya verildi."}}}},"responses":{"201":{"description":"Temsilci yanıtı gönderir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"conversation_id":{"type":"string","format":"uuid"},"status":{"const":"sent"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/conversations/{id}/notes":{"get":{"tags":["Sohbetler"],"operationId":"listConversationNotes","summary":"Dahili notları listeler","description":"Yalnız ekibin gördüğü notlar, en yeni önce. Kapsam: conversations:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Dahili notları listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SohbetNotu"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Sohbetler"],"operationId":"createConversationNote","summary":"Dahili not ekler","description":"Müşteriye gitmez. Metinde @Ad ile anılan ve bu bota erişimi olan üyelere bildirim gider; API anahtarıyla yazıldığında yazan API görünür. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":2000}}},"example":{"body":"@Zeynep iade talebini kontrol eder misin?"}}}},"responses":{"201":{"description":"Dahili not ekler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SohbetNotu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/{id}/notes/{note_id}":{"delete":{"tags":["Sohbetler"],"operationId":"deleteConversationNote","summary":"Dahili notu siler","description":"Notu yazan ya da yönetici silebilir. API anahtarının kullanıcısı olmadığından yönetici yetkisi gerekir (403 forbidden_role). Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"note_id","in":"path","required":true,"description":"note_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Dahili notu siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/conversations/bulk":{"post":{"tags":["Sohbetler"],"operationId":"bulkConversations","summary":"Sohbetlerde toplu işlem yapar","description":"operation: close (anket açıksa müşteriye memnuniyet sorusu gider), assign, read. En fazla 100 kimlik. user_id yalnız assign içindir ve orada zorunludur; null atamayı kaldırır. Erişilemeyen ya da bulunmayan sohbetler işlenmez; hedefin bota erişimi olmayan sohbetler skipped sayılır. Hedef ekipte değilse 409 not_team_member döner. Kapsam: conversations:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["operation","ids"],"properties":{"operation":{"enum":["close","assign","read"]},"ids":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","format":"uuid"}},"user_id":{"type":["string","null"],"format":"uuid"}}},"example":{"operation":"read","ids":["3fa85f64-5717-4562-b3fc-2c963f66afa6"]}}}},"responses":{"200":{"description":"Sohbetlerde toplu işlem yapar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"operation":{"enum":["close","assign","read"]},"requested":{"type":"integer"},"affected":{"type":"integer"},"skipped":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/messages/{id}/retry":{"post":{"tags":["Mesajlar"],"operationId":"retryMessage","summary":"Başarısız mesajı yeniden dener","description":"Yalnız başarısız giden mesajlar, en fazla 5 kez (aksi 409 message_not_retryable). Müşteriye gerçek mesaj gider. İzni geri çekilmiş kişiye otomasyon mesajı gitmez (403 opted_out). Boş AI yanıtı yeniden üretilir ve yeni kayıt olarak yazılır. messages:send kapsamı da gerekir; plan sınırını aşan bot gönderemez (403 bot_plan_restricted), aylık mesaj kotası uygulanır (429 message_quota_exceeded). Kanal hatası 502 channel_error döner. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Başarısız mesajı yeniden dener","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"retried":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/messages/{id}/feedback":{"post":{"tags":["Mesajlar"],"operationId":"rateAiReply","summary":"AI yanıtını değerlendirir","description":"value: up, down ya da null (kaldırır). note yalnız down için saklanır. Yalnız AI yanıtları değerlendirilir; başka mesaj 404 döner. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["value"],"properties":{"value":{"enum":["up","down",null]},"note":{"type":"string","maxLength":500}}},"example":{"value":"down","note":"Kargo süresini yanlış söyledi"}}}},"responses":{"200":{"description":"AI yanıtını değerlendirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"value":{"enum":["up","down",null]},"note":{"type":["string","null"]},"rated_at":{"type":["string","null"],"format":"date-time"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/saved-replies":{"get":{"tags":["Hazır yanıtlar"],"operationId":"listSavedReplies","summary":"Hazır yanıtları listeler","description":"Organizasyonun hazır yanıtları, en yeni önce. Kapsam: conversations:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Hazır yanıtları listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/HazirYanit"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Hazır yanıtlar"],"operationId":"createSavedReply","summary":"Hazır yanıt ekler","description":"Kısa ad organizasyonda tekildir (409 shortcut_exists); en fazla 200 hazır yanıt (409 limit_reached). Yönetici yetkisi gerekir. Kapsam: conversations:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["shortcut","body"],"properties":{"shortcut":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[\\p{L}\\p{N}_-]+$"},"body":{"type":"string","minLength":1,"maxLength":2000}}},"example":{"shortcut":"kargo","body":"Merhaba {{isim}}, kargonuz yola çıktı."}}}},"responses":{"201":{"description":"Hazır yanıt ekler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/HazirYanit"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/saved-replies/{id}":{"get":{"tags":["Hazır yanıtlar"],"operationId":"getSavedReply","summary":"Hazır yanıt ayrıntısı","description":"Tek hazır yanıtı döner. Kapsam: conversations:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Hazır yanıt ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/HazirYanit"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Hazır yanıtlar"],"operationId":"updateSavedReply","summary":"Hazır yanıtı günceller","description":"Yalnız gönderilen alanlar değişir. Kısa ad doluysa 409 shortcut_exists döner. Yönetici yetkisi gerekir. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"shortcut":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[\\p{L}\\p{N}_-]+$"},"body":{"type":"string","minLength":1,"maxLength":2000}},"minProperties":1},"example":{"body":"Merhaba {{isim}}, kargonuz bugün teslim edilecek."}}}},"responses":{"200":{"description":"Hazır yanıtı günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/HazirYanit"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Hazır yanıtlar"],"operationId":"deleteSavedReply","summary":"Hazır yanıtı siler","description":"Yönetici yetkisi gerekir. Kapsam: conversations:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Hazır yanıtı siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/campaigns/{id}/results":{"get":{"tags":["Kampanyalar"],"operationId":"getCampaignResults","summary":"Varyant sonuçları ve A/B kararı","description":"Hedef, gönderilen, başarısız ve yanıt sayıları; otomatik kazananda A/B aşaması ve kararı. Yalnız okur: API gönderim başlatmaz ve onay vermez, kampanya panelde dört göz onayıyla başlar. Kapsam: campaigns:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Varyant sonuçları ve A/B kararı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KampanyaSonuclari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/campaigns/audience-count":{"post":{"tags":["Kampanyalar"],"operationId":"countCampaignAudience","summary":"Segmentle eşleşen izinli kişileri sayar","description":"Yan etkisizdir, hiçbir şey kaydetmez. Kitleyi yalnız izinli kişiler oluşturur; konu verilirse o konuyu kapatanlar çıkar. Kapsam: campaigns:read.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["bot_id"],"properties":{"bot_id":{"type":"string","format":"uuid"},"segment":{"type":"object","description":"Etiket, son görülme, sipariş, kaynak, özel alan ve sıcaklık koşulları; createCampaign ile aynı biçim. Boş nesne: botun bütün izinli kişileri."},"topic":{"type":"string","maxLength":40}}},"example":{"bot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","segment":{"include_tags":["vip"]},"topic":"firsat"}}}},"responses":{"200":{"description":"Segmentle eşleşen izinli kişileri sayar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KampanyaKitleSayisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/campaigns/best-time":{"get":{"tags":["Kampanyalar"],"operationId":"getCampaignBestTime","summary":"Önerilen gönderim saati","description":"Son 90 günün gelen mesajlarından, sessiz saat ve mesai kurallarına uyan en etkili gün ve saat; veri azsa öneri boş döner ve reason nedeni söyler. Kapsam: campaigns:read.","parameters":[{"name":"bot_id","in":"query","description":"Bot kimliği","schema":{"type":"string","format":"uuid"},"required":true}],"responses":{"200":{"description":"Önerilen gönderim saati","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/KampanyaEnIyiSaat"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/overview":{"get":{"tags":["Raporlar"],"operationId":"getReportOverview","summary":"Genel rapor özeti","description":"Bu ayın mesaj ve AI kullanımı (organizasyon geneli), kişi, izinli ve devredilen sohbet sayıları; seçili dönemin bot, saat ve gün dağılımı; kampanya özeti. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","parameters":[{"name":"days","in":"query","description":"Dönem (gün): 7, 30 ya da 90; varsayılan 30","schema":{"type":"integer","enum":[7,30,90],"default":30}}],"responses":{"200":{"description":"Genel rapor özeti","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporGenelBakis"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/delivery":{"get":{"tags":["Raporlar"],"operationId":"getDeliveryTelemetry","summary":"Teslim telemetrisi","description":"Giden mesajların başarı oranı, kaynak bazında başarısızlar ve hata nedenleri. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","parameters":[{"name":"days","in":"query","description":"Dönem (gün): 7, 30 ya da 90; varsayılan 30","schema":{"type":"integer","enum":[7,30,90],"default":30}}],"responses":{"200":{"description":"Teslim telemetrisi","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporTeslim"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/agents":{"get":{"tags":["Raporlar"],"operationId":"getAgentReport","summary":"Temsilci performansı","description":"İlk yanıt ve çözüm süreleri, SLA uyumu, bekleyen sohbetler ve temsilci bazlı sayılar. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","parameters":[{"name":"days","in":"query","description":"Dönem (gün): 7, 30 ya da 90; varsayılan 30","schema":{"type":"integer","enum":[7,30,90],"default":30}}],"responses":{"200":{"description":"Temsilci performansı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporTemsilci"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/csat":{"get":{"tags":["Raporlar"],"operationId":"getCsatReport","summary":"Memnuniyet raporu","description":"Ortalama puan, memnun oranı, 1-5 dağılımı ve temsilci bazında ortalama. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","parameters":[{"name":"days","in":"query","description":"Dönem (gün): 7, 30 ya da 90; varsayılan 30","schema":{"type":"integer","enum":[7,30,90],"default":30}}],"responses":{"200":{"description":"Memnuniyet raporu","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporCsat"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/ai-quality":{"get":{"tags":["Raporlar"],"operationId":"getAiQualityReport","summary":"AI kalite raporu","description":"Temsilcilerin AI yanıtlarına verdiği geri bildirimin özeti. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","parameters":[{"name":"days","in":"query","description":"Dönem (gün): 7, 30 ya da 90; varsayılan 30","schema":{"type":"integer","enum":[7,30,90],"default":30}}],"responses":{"200":{"description":"AI kalite raporu","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporAiKalite"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/cohorts":{"get":{"tags":["Raporlar"],"operationId":"getCohortReport","summary":"Kitle kohortları","description":"Son 8 haftanın kişi kohortları ve sonraki haftalarda bota yeniden yazma oranı. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","responses":{"200":{"description":"Kitle kohortları","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporKohort"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/revenue":{"get":{"tags":["Raporlar"],"operationId":"getRevenueReport","summary":"Gelir atfı ve ROI","description":"Kampanya, edinme bağlantısı ve tıkla-WhatsApp reklamlarına atfedilen gelir (Mini App ve mağaza siparişleri), maliyet ve ROI; bot sohbetiyle eşleşen mağaza siparişleri totals.store içindedir. from ve to birlikte verilir (YYYY-MM-DD, organizasyon günü); verilmezse son 30 gün. Aralık en çok 1 yıldır. Üye rolü yalnız erişebildiği botların verisini görür. Kapsam: reports:read.","parameters":[{"name":"from","in":"query","description":"Başlangıç günü (YYYY-MM-DD)","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Bitiş günü, dahil (YYYY-MM-DD)","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Gelir atfı ve ROI","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporGelir"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/usage":{"get":{"tags":["Raporlar"],"operationId":"getUsageReport","summary":"Plan ve kullanım","description":"Plan, limitler, bu ayın mesaj ve AI yanıt kullanımı, token toplamı, AI ve mesaj ek bakiyesi. Organizasyon genelidir. group_by=bot|channel verilirse breakdown alanında bu ayın giden mesaj, AI yanıtı, medya ve Meta tahmini bot ya da kanal başına döner; satırların toplamı genel toplamla eşleşir. Üye rolü kırılımda yalnız erişebildiği botları görür. Kapsam: reports:read.","parameters":[{"name":"group_by","in":"query","description":"Kullanım kırılımı: bot ya da channel","schema":{"enum":["bot","channel"]}}],"responses":{"200":{"description":"Plan ve kullanım","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporKullanim"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/costs/{kind}/{id}":{"put":{"tags":["Raporlar"],"operationId":"setReportCost","summary":"Kampanya ya da bağlantı maliyetini yazar","description":"ROI hesabının toplam maliyeti; amount null maliyeti siler. Değişiklik denetim kaydına eski ve yeni değerle yazılır. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","parameters":[{"name":"kind","in":"path","required":true,"description":"kind kimliği","schema":{"enum":["campaign","link"]}},{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":["number","null"],"minimum":0},"currency":{"enum":["TRY","USD","EUR"]}}},"example":{"amount":1250.5,"currency":"TRY"}}}},"responses":{"200":{"description":"Kampanya ya da bağlantı maliyetini yazar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporMaliyet"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/communities":{"get":{"tags":["Topluluklar"],"operationId":"listCommunities","summary":"Telegram topluluklarını listeler","description":"Botun eklendiği gruplar ve kanallar, en yeni önce. Üye rolünde yalnız erişebildiği botların toplulukları döner. Kapsam: communities:read.","parameters":[{"name":"bot_id","in":"query","description":"Yalnız bu bot","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Telegram topluluklarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Topluluk"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/communities/{id}":{"get":{"tags":["Topluluklar"],"operationId":"getCommunity","summary":"Topluluk ayrıntısı","description":"Ayarlar, moderasyon kuralları, botun durumu ve izinleri, üye sayısı ve forum konuları. Bot jetonu dönmez. Kapsam: communities:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Topluluk ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ToplulukAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Topluluklar"],"operationId":"updateCommunity","summary":"Topluluk ayarlarını günceller","description":"Yalnız gönderilen alanlar değişir; rules içinde de yalnız gönderilen kurallar değişir. Karşılama açıkken mesaj boş olamaz; verify modunda katılım mesajı ve butonu gerekir. Botta eksik yetki kaydı engellemez, warnings dizisinde bildirilir. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"welcome_enabled":{"type":"boolean"},"welcome_message":{"type":"string","maxLength":1000},"welcome_delete_after_sec":{"type":"integer","enum":[0,60,300,1800,3600]},"ai_enabled":{"type":"boolean"},"ai_hourly_limit":{"type":"integer","minimum":1,"maximum":500},"join_request_mode":{"enum":["manual","approve","verify"]},"join_request_message":{"type":"string","maxLength":1000},"join_request_button":{"type":"string","maxLength":64},"join_approved_message":{"type":"string","maxLength":1000},"rules":{"type":"object","additionalProperties":false,"properties":{"block_links":{"type":"boolean"},"block_forwards":{"type":"boolean"},"banned_words":{"type":"array","maxItems":200,"items":{"type":"string","minLength":1,"maxLength":200},"description":"Virgül ya da satır sonu içeren öğe birden çok kelimeye bölünür"},"flood_count":{"type":"integer","minimum":0,"maximum":50},"flood_seconds":{"type":"integer","minimum":3,"maximum":300},"action":{"enum":["delete","warn","mute"]},"exempt_admins":{"type":"boolean"}}}},"minProperties":1},"example":{"welcome_enabled":true,"welcome_message":"Hoş geldin {{isim}}!","rules":{"block_links":true,"flood_count":5,"flood_seconds":10,"action":"warn"}}}}},"responses":{"200":{"description":"Topluluk ayarlarını günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ToplulukGuncelleme"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Topluluklar"],"operationId":"removeCommunity","summary":"Topluluğu kaldırır","description":"Topluluk kaydı, planlı gönderileri, davet bağlantıları ve istatistikleri silinir; bot Telegram grubundan çıkarılmaz. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Topluluğu kaldırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/refresh-webhook":{"post":{"tags":["Botlar"],"operationId":"refreshBotWebhook","summary":"Telegram webhook'unu yeniden kurar","description":"Bot grup ya da kanal olaylarını almıyorsa kullanılır; Telegram'a istek gider. Telegram botu bağlı değilse 409 not_connected, sunucu adresi HTTPS değilse 409 https_required, Telegram reddederse 502 channel_error döner. Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Telegram webhook'unu yeniden kurar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"webhook_refreshed":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/communities/{id}/refresh-members":{"post":{"tags":["Topluluklar"],"operationId":"refreshCommunityMembers","summary":"Üye sayısını Telegram'dan yeniler","description":"Telegram'a istek gider. Üye rolü de çağırabilir, ama bota erişimi olmalıdır. Telegram hatası 502 channel_error döner; bot bağlı değilse 409 not_connected. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Üye sayısını Telegram'dan yeniler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"member_count":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/communities/{id}/invite-links":{"get":{"tags":["Topluluklar"],"operationId":"listCommunityInviteLinks","summary":"Davet bağlantılarını listeler","description":"Her bağlantının katılım ve ayrılma sayısıyla, en yeni önce. Kapsam: communities:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Davet bağlantılarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DavetBaglantisi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Topluluklar"],"operationId":"createCommunityInviteLink","summary":"Davet bağlantısı oluşturur","description":"Telegram'da adlandırılmış davet bağlantısı açar. join_request bağlantısında member_limit kullanılamaz. Bot yönetici değilse ya da can_invite_users izni yoksa 409 bot_permission; topluluktaki etkin bağlantı sayısı sınırdaysa 409 limit_reached; Telegram hatası 502 channel_error. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":32},"member_limit":{"type":["integer","null"],"minimum":1,"maximum":99999},"expires_in_days":{"type":["integer","null"],"minimum":1,"maximum":365},"join_request":{"type":"boolean"}}},"example":{"name":"Instagram","member_limit":100,"expires_in_days":30,"join_request":false}}}},"responses":{"201":{"description":"Davet bağlantısı oluşturur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/DavetBaglantisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/communities/{id}/invite-links/{link_id}":{"delete":{"tags":["Topluluklar"],"operationId":"revokeCommunityInviteLink","summary":"Davet bağlantısını iptal eder","description":"Bağlantı Telegram'da da iptal edilir; zaten iptal edilmişse aynı sonuç döner. Bot gruptan çıkarıldıysa yalnız kayıt iptal edilir. Telegram hatası 502 channel_error. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"link_id","in":"path","required":true,"description":"link_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Davet bağlantısını iptal eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/DavetBaglantisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/scheduled-posts":{"get":{"tags":["Planlı gönderiler"],"operationId":"listScheduledPosts","summary":"Planlı gönderileri listeler","description":"En son oluşturulan önce. from ve to planlanan zamana uygulanır (to hariç). Üye rolünde yalnız erişebildiği botların gönderileri döner. Kapsam: communities:read.","parameters":[{"name":"community_id","in":"query","description":"Yalnız bu topluluk","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","description":"Yalnız bu durum","schema":{"enum":["pending_approval","rejected","scheduled","sending","sent","failed","uncertain","canceled"]}},{"name":"from","in":"query","description":"Bu andan itibaren","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","description":"Bu andan önce","schema":{"type":"string","format":"date-time"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Planlı gönderileri listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlanliGonderi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Planlı gönderiler"],"operationId":"createScheduledPost","summary":"Gönderi planlar ya da hemen yayınlar","description":"community_ids bir ya da en çok 20 hedef alır; birden çok hedef tek işlemde kaydedilir (biri geçersizse hiçbiri açılmaz). scheduled_at ya da publish_now gerekir. Üye rolünün gönderisi yönetici onayına düşer (pending_approval) ve publish_now ile de yayınlanmaz. İçerik politikası engeli 422 content_policy, dikkat ifadeleri ve kanal yetkisi eksikliği warnings dizisinde döner. Hemen yayında kanal hatası kaydı geri almaz: sonuç posts içindeki status ve error alanlarındadır. Test modunda gönderi Telegram'a gitmez, simulated true olur. Tekrarda çift gönderiyi önlemek için Idempotency-Key kullanın. whatsapp bloğu verilirse aynı içerikten WhatsApp kampanya taslağı açılır: yalnız onaylı MARKETING şablonuyla ve yalnız izinli (opted_in) kişilere, yönetici onayından sonra gider; write kapsamı gerekir. WhatsApp tarafı hatalıysa hiçbir kayıt açılmaz (404 template_not_found, 400 template_not_allowed ya da template_params, 409 empty_audience veya channel_not_configured, 502 channel_error). Kapsam: communities:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["community_ids","text"],"properties":{"community_ids":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","format":"uuid"}},"text":{"type":"string","minLength":1,"maxLength":4096,"description":"Görselli gönderide en fazla 1024 karakter"},"publish_now":{"type":"boolean"},"topic_ids":{"type":"object","description":"Forum grubunda hedef konu: topluluk kimliği → konu kimliği","additionalProperties":{"type":"integer","minimum":1}},"image_url":{"type":["string","null"],"maxLength":1000,"description":"Herkese açık https adresi"},"button_text":{"type":["string","null"],"maxLength":64},"button_url":{"type":["string","null"],"maxLength":1000,"description":"https adresi; button_text ile birlikte"},"silent":{"type":"boolean"},"pin":{"type":"boolean"},"repeat":{"enum":["none","daily","weekly"]},"scheduled_at":{"type":"string","format":"date-time","description":"Saat dilimi ofsetiyle ISO 8601 anı"},"whatsapp":{"type":"object","additionalProperties":false,"required":["bot_id","template_name","template_language"],"properties":{"bot_id":{"type":"string","format":"uuid","description":"WhatsApp botu"},"template_name":{"type":"string","minLength":1,"maxLength":512,"description":"Meta'da onaylı, MARKETING kategorisinde ve medya başlıksız şablon"},"template_language":{"type":"string","minLength":2,"maxLength":15},"template_params":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":1024},"description":"Başlık ve gövde değişkenleri sırayla; satır sonları tek boşluğa çevrilir"},"topic":{"type":"string","maxLength":40,"description":"İsteğe bağlı kampanya konusu; konuyu kapatan kişiler kitleye girmez"}}}}},"example":{"community_ids":["3fa85f64-5717-4562-b3fc-2c963f66afa6"],"text":"Yeni kampanyamız başladı!","button_text":"İncele","button_url":"https://ornek.com/kampanya","repeat":"none","scheduled_at":"2030-01-15T10:00:00+03:00"}}}},"responses":{"201":{"description":"Gönderi planlar ya da hemen yayınlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/scheduled-posts/calendar":{"get":{"tags":["Planlı gönderiler"],"operationId":"getPostCalendar","summary":"Ay takvimini gönderilerle döner","description":"Panel takvimiyle aynı aralık: Pazartesi başlayan haftalar, organizasyon saat dilimi. Her gün gönderileriyle döner; çok hedefli tur tek öğedir. month verilmezse bu ay. Kapsam: communities:read.","parameters":[{"name":"month","in":"query","description":"YYYY-MM","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"}}],"responses":{"200":{"description":"Ay takvimini gönderilerle döner","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/GonderiTakvimi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/scheduled-posts/{id}":{"get":{"tags":["Planlı gönderiler"],"operationId":"getScheduledPost","summary":"Planlı gönderi ayrıntısı","description":"Çok hedefli gönderide turun hedefleri ve özet durumu da döner. Kapsam: communities:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Planlı gönderi ayrıntısı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiAyrintisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Planlı gönderiler"],"operationId":"updateScheduledPost","summary":"Planlı gönderiyi düzenler","description":"Yalnız scheduled ve pending_approval durumundaki gönderi düzenlenir; gönderimi başlamışsa 409 post_locked. Yönetici her gönderiyi, üye yalnız kendi onay bekleyenini düzenler; durum değişmez, üye gönderisi onay bekler. Çok hedefli gönderide aynı turun bütün hedefleri birlikte değişir. Doğrulama ve içerik politikası oluşturmayla aynıdır (422 content_policy). Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string","minLength":1,"maxLength":4096},"topic_ids":{"type":"object","description":"Forum grubunda hedef konu: topluluk kimliği → konu kimliği","additionalProperties":{"type":"integer","minimum":1}},"image_url":{"type":["string","null"],"maxLength":1000,"description":"Herkese açık https adresi"},"button_text":{"type":["string","null"],"maxLength":64},"button_url":{"type":["string","null"],"maxLength":1000,"description":"https adresi; button_text ile birlikte"},"silent":{"type":"boolean"},"pin":{"type":"boolean"},"repeat":{"enum":["none","daily","weekly"]},"scheduled_at":{"type":"string","format":"date-time","description":"Saat dilimi ofsetiyle ISO 8601 anı"}},"minProperties":1},"example":{"text":"Kampanyamız yarın başlıyor!","scheduled_at":"2030-01-16T10:00:00+03:00"}}}},"responses":{"200":{"description":"Planlı gönderiyi düzenler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Planlı gönderiler"],"operationId":"cancelScheduledPost","summary":"Planlı gönderiyi iptal eder","description":"Yönetici her gönderiyi, üye yalnız kendi onay bekleyenini iptal eder. Çok hedefli gönderide gönderilmemiş hedefler ve serinin sonraki turları iptal edilir; gönderilmiş hedefler değişmez. İptal edilecek bir şey kalmadıysa 409 post_locked. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Planlı gönderiyi iptal eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"canceled":{"type":"boolean"},"canceled_targets":{"type":"integer"},"sent_targets":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/scheduled-posts/{id}/publish":{"post":{"tags":["Planlı gönderiler"],"operationId":"publishScheduledPost","summary":"Gönderiyi hemen yayınlar","description":"Çok hedefli gönderide turun planlı hedefleri yayınlanır, her hedefin sonucu posts içinde döner; süreye sığmayan hedefler planlı kalır. Başarısız hedef ya da gönderi bu uçla yeniden denenir. Tek hedefte kanal hatası 502 channel_error, politika engeli 422 content_policy, planlı değilse 409 post_locked döner. Test modunda Telegram'a gitmez. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Gönderiyi hemen yayınlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/scheduled-posts/{id}/approve":{"post":{"tags":["Planlı gönderiler"],"operationId":"approveScheduledPost","summary":"Onay bekleyen gönderiyi onaylar","description":"İçerik güncel politikayla yeniden denetlenir (422 content_policy). Zamanı geçmişse hemen yayınlanır; yayın hatası onayı geri almaz ve warnings içinde döner. Çok hedefli gönderide turun bütün hedefleri onaylanır. Onay beklemiyorsa 409 post_locked. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Onay bekleyen gönderiyi onaylar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/scheduled-posts/{id}/reject":{"post":{"tags":["Planlı gönderiler"],"operationId":"rejectScheduledPost","summary":"Onay bekleyen gönderiyi reddeder","description":"Neden isteğe bağlıdır ve gönderene bildirilir. Çok hedefli gönderide turun bütün hedefleri reddedilir. Onay beklemiyorsa 409 post_locked. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"reason":{"type":"string","maxLength":300}}},"example":{"reason":"Görseli güncelleyin."}}}},"responses":{"200":{"description":"Onay bekleyen gönderiyi reddeder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/scheduled-posts/{id}/resend":{"post":{"tags":["Planlı gönderiler"],"operationId":"resendUncertainPost","summary":"Sonucu belirsiz gönderiyi yeniden gönderir","description":"Yalnız uncertain durumundaki gönderi ya da hedef için. Dikkat: önceki deneme Telegram'a ulaşmış olabilir, mesaj ikinci kez görünebilir; önce kanalı kontrol edin. Diğer hedeflere dokunulmaz. Belirsiz değilse 409 post_locked, kanal hatası 502 channel_error. Yönetici yetkisi gerekir. Kapsam: communities:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Sonucu belirsiz gönderiyi yeniden gönderir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlanliGonderiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"422":{"$ref":"#/components/responses/IcerikPolitikasi"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/organization":{"get":{"tags":["Organizasyon"],"operationId":"getOrganization","summary":"Organizasyon ayarlarını getirir","description":"Plan, marka, gönderim politikası, çalışma saatleri, SLA, test modu, saklama süresi ve askı durumu döner. Ödeme kimlikleri ve anahtarlar dönmez. Yönetici yetkisi gerekir. Kapsam: organization:read.","responses":{"200":{"description":"Organizasyon ayarlarını getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OrganizasyonAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Organizasyon"],"operationId":"updateOrganization","summary":"Organizasyon ayarlarını günceller","description":"Yalnız gönderilen alanlar değişir; bir alan geçersizse hiçbiri yazılmaz. test_mode açıkken giden mesajlar kanala gönderilmez; kısa data_retention_days eski konuşma verisini kalıcı siler. campaign_four_eyes (dört göz) API ile yazılamaz: gönderim onay denetimi panelde kalır. Yönetici yetkisi gerekir. Kapsam: organization:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":80},"brand":{"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"],"maxLength":60},"logo_url":{"type":["string","null"],"maxLength":1000,"description":"https adresi ya da yüklenen görselin path değeri"},"color":{"type":["string","null"],"description":"#RRGGBB"}}},"timezone":{"type":"string","description":"IANA saat dilimi"},"campaign_frequency_hours":{"enum":[0,12,24,48,72,168]},"quiet_hours_start":{"type":["integer","null"],"minimum":0,"maximum":23},"quiet_hours_end":{"type":["integer","null"],"minimum":0,"maximum":23},"business_hours":{"type":["object","null"],"additionalProperties":false,"required":["days","start","end","message"],"properties":{"days":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"start":{"type":"string","description":"SS:DD"},"end":{"type":"string","description":"SS:DD"},"message":{"type":"string"}},"description":"null: kapalı"},"csat":{"type":["object","null"],"additionalProperties":false,"required":["question","thank_you"],"properties":{"question":{"type":"string"},"thank_you":{"type":"string"}},"description":"null: kapalı"},"sla_target_minutes":{"enum":[5,15,30,60,120,240,480,1440]},"sla_escalation":{"type":"boolean"},"test_mode":{"type":"boolean"},"data_retention_days":{"enum":[90,180,365,730,null],"description":"null: süresiz"}},"minProperties":1},"example":{"name":"Örnek Mağaza","timezone":"Europe/Istanbul","quiet_hours_start":22,"quiet_hours_end":8,"sla_target_minutes":30}}}},"responses":{"200":{"description":"Organizasyon ayarlarını günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OrganizasyonAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/organization/content-policy":{"get":{"tags":["Organizasyon"],"operationId":"getContentPolicy","summary":"İçerik politikasını getirir","description":"Kapalı olsa da kayıtlı politika döner. Yönetici yetkisi gerekir. Kapsam: organization:read.","responses":{"200":{"description":"İçerik politikasını getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/IcerikPolitikasiAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"put":{"tags":["Organizasyon"],"operationId":"updateContentPolicy","summary":"İçerik politikasını değiştirir","description":"Politikanın tamamı değişir: gönderilmeyen liste boşalır, gönderilmeyen sınır kalkar. Değerler sabit dizgidir, düzenli ifade kabul edilmez. Açıksa kampanya ve planlı gönderiler bu kurallarla denetlenir. Yönetici yetkisi gerekir. Kapsam: organization:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["enabled"],"properties":{"enabled":{"type":"boolean"},"blocked_phrases":{"type":"array","items":{"type":"string"},"description":"En fazla 300 ifade"},"warned_phrases":{"type":"array","items":{"type":"string"},"description":"En fazla 300 ifade"},"allowed_domains":{"type":"array","items":{"type":"string"},"description":"En fazla 200 alan adı"},"blocked_domains":{"type":"array","items":{"type":"string"},"description":"En fazla 200 alan adı"},"max_links":{"type":["integer","null"],"minimum":0,"maximum":20},"max_caps_percent":{"type":["integer","null"],"minimum":10,"maximum":100}}},"example":{"enabled":true,"blocked_phrases":["garantili kazanç"],"warned_phrases":["son fırsat"],"allowed_domains":["ornek.com"],"blocked_domains":[],"max_links":2,"max_caps_percent":60}}}},"responses":{"200":{"description":"İçerik politikasını değiştirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/IcerikPolitikasiAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/organization/ai":{"get":{"tags":["Organizasyon"],"operationId":"getAiSettings","summary":"AI ayarlarını getirir","description":"Anahtarlar hiçbir zaman okunmaz; yalnız *_key_set döner. Yönetici yetkisi gerekir. Kapsam: organization:read.","responses":{"200":{"description":"AI ayarlarını getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AiAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Organizasyon"],"operationId":"updateAiSettings","summary":"AI ayarlarını günceller","description":"Yalnız gönderilen alanlar değişir. api_key yalnız yazılır, seçili sağlayıcının anahtarıdır ve kaydedilmeden önce sağlayıcıda doğrulanır: geçersizse 400, sağlayıcıya ulaşılamazsa 502. remove_key seçili sağlayıcının anahtarını siler. Sağlayıcı değişip model gönderilmezse o sağlayıcının varsayılan modeli seçilir. Yönetici yetkisi gerekir. Kapsam: organization:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"provider":{"enum":["anthropic","openrouter","openai"]},"model":{"type":"string","maxLength":200},"monthly_limit":{"type":"integer","minimum":0,"maximum":1000000},"api_key":{"type":"string","maxLength":500,"writeOnly":true},"remove_key":{"type":"boolean"}},"minProperties":1},"example":{"provider":"openrouter","model":"anthropic/claude-sonnet-5.5","monthly_limit":2000}}}},"responses":{"200":{"description":"AI ayarlarını günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AiAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/organization/stores":{"get":{"tags":["Organizasyon"],"operationId":"listStores","summary":"Mağaza bağlantılarını listeler","description":"Şifreli anahtarlar dönmez; yalnız credentials_set ve webhook_secret_set döner. Özellik kapalıysa 409 feature_disabled. Yönetici yetkisi gerekir. Kapsam: organization:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Mağaza bağlantılarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MagazaBaglantisi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/organization/stores/{platform}":{"put":{"tags":["Organizasyon"],"operationId":"saveStore","summary":"Mağaza bağlantısını kaydeder","description":"WooCommerce için key ve secret, Shopify için token gerekir. Adres herkese açık https olmalıdır. Mağazaya gerçek bir test isteği gider; başarısızsa kaydedilmez (400). Gönderilmeyen anahtar ve ayarlar korunur, ancak adres değişirse anahtarlar yeniden gönderilmelidir. Özellik kapalıysa 409 feature_disabled. Yönetici yetkisi gerekir. Kapsam: organization:write.","parameters":[{"name":"platform","in":"path","required":true,"description":"platform kimliği","schema":{"type":"string","enum":["woocommerce","shopify"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["store_url"],"properties":{"store_url":{"type":"string","maxLength":500},"key":{"type":"string","writeOnly":true},"secret":{"type":"string","writeOnly":true},"token":{"type":"string","writeOnly":true},"webhook_secret":{"type":"string","writeOnly":true},"notify_statuses":{"type":"array","items":{"type":"string"}},"language":{"enum":["tr","en"]},"notify_opted_out":{"type":"boolean"},"wa_template":{"type":["object","null"],"additionalProperties":false,"required":["name","language"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","minLength":1,"maxLength":20}}}}},"example":{"store_url":"https://magazam.ornek.com","key":"ck_ornekanahtar","secret":"cs_ornekgizli","notify_statuses":["completed"],"language":"tr","notify_opted_out":true}}}},"responses":{"200":{"description":"Mağaza bağlantısını kaydeder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MagazaBaglantisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Organizasyon"],"operationId":"deleteStore","summary":"Mağaza bağlantısını kaldırır","description":"Sipariş sorgulama ve durum bildirimleri durur. Özellik kapalıysa 409 feature_disabled. Yönetici yetkisi gerekir. Kapsam: organization:write.","parameters":[{"name":"platform","in":"path","required":true,"description":"platform kimliği","schema":{"type":"string","enum":["woocommerce","shopify"]}}],"responses":{"200":{"description":"Mağaza bağlantısını kaldırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"platform":{"type":"string","enum":["woocommerce","shopify"]},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/organization/stores/{platform}/test":{"post":{"tags":["Organizasyon"],"operationId":"testStore","summary":"Mağaza bağlantısını sınar","description":"Mağazaya gerçek bir istek gider ve sonuç last_error alanına yazılır; başarısız bağlantı da 200 döner (connected false). Özellik kapalıysa 409 feature_disabled. Yönetici yetkisi gerekir. Kapsam: organization:write.","parameters":[{"name":"platform","in":"path","required":true,"description":"platform kimliği","schema":{"type":"string","enum":["woocommerce","shopify"]}}],"responses":{"200":{"description":"Mağaza bağlantısını sınar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"connected":{"type":"boolean"},"error":{"type":["string","null"]}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/media":{"get":{"tags":["Medya"],"operationId":"listMedia","summary":"Medya kütüphanesini listeler","description":"En yeni önce; q görünen adda arar. Yönetici yetkisi gerekir. Kapsam: organization:read.","parameters":[{"name":"q","in":"query","description":"Görünen adda arama","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Medya kütüphanesini listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MedyaOgesi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Medya"],"operationId":"uploadMedia","summary":"Görsel yükler","description":"En fazla 2 MB; JPG, PNG, WebP ya da GIF (tür dosyanın içeriğinden belirlenir, SVG kabul edilmez). Organizasyon başına en fazla 500 görsel (409 limit_reached); toplam boyut plan depolama kotasını aşamaz (413 storage_quota_exceeded; kullanım getUsage storage alanında); dakikada 30 yükleme (429). Yönetici yetkisi gerekir. Kapsam: organization:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["file_name","file_base64"],"properties":{"file_name":{"type":"string","maxLength":255},"file_base64":{"type":"string","description":"Dosyanın base64 içeriği (data: öneki olmadan)"}}},"example":{"file_name":"logo.png","file_base64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="}}}},"responses":{"201":{"description":"Görsel yükler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MedyaOgesi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"413":{"$ref":"#/components/responses/DepolamaKotasi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/media/{id}/usage":{"get":{"tags":["Medya"],"operationId":"getMediaUsage","summary":"Görselin kullanıldığı yerleri getirir","description":"Kampanya, planlı gönderi, marka logosu, Mini App, otomasyon ve sohbet geçmişi taranır. Yönetici yetkisi gerekir. Kapsam: organization:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Görselin kullanıldığı yerleri getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MedyaKullanimi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/media/{id}":{"delete":{"tags":["Medya"],"operationId":"deleteMedia","summary":"Görseli siler","description":"Kullanılan görsel silinmez (409 media_in_use). Dosya da kalıcı silinir. Yönetici yetkisi gerekir. Kapsam: organization:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Görseli siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/audit-logs":{"get":{"tags":["Denetim"],"operationId":"listAuditLogs","summary":"Denetim kaydını listeler","description":"En yeni önce. Ham ayrıntı dönmez: summary temizlenmiş özettir (e-posta, telefon, IP, sır ve serbest metin içermez), işlemi yapan yalnız user_id ile görünür. Yönetici yetkisi gerekir. Kapsam: organization:read.","parameters":[{"name":"category","in":"query","description":"İşlem kategorisi","schema":{"enum":["auth","account","org","team","bot","conversation","contact","campaign","automation","knowledge","community","post","miniapp","upload","apikey","webhook","plan","billing","affiliate","store"]}},{"name":"user_id","in":"query","description":"İşlemi yapan kullanıcı","schema":{"type":"string","format":"uuid"}},{"name":"from","in":"query","description":"Başlangıç günü (YYYY-MM-DD, UTC)","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Bitiş günü, dahil (YYYY-MM-DD, UTC)","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Denetim kaydını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DenetimKaydi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/billing":{"get":{"tags":["Abonelik"],"operationId":"getBilling","summary":"Plan, limit, kullanım ve abonelik durumunu getirir","description":"Yalnız okunur: satın alma, plan değişikliği, iptal, kart ve ek paket işlemleri Creem ödeme sayfasında kalır (manage_url). Ödeme sağlayıcısı kimlikleri dönmez. Yönetici yetkisi gerekir. Kapsam: organization:read.","responses":{"200":{"description":"Plan, limit, kullanım ve abonelik durumunu getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AbonelikOzeti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/team/members":{"get":{"tags":["Ekip"],"operationId":"listTeamMembers","summary":"Ekip üyelerini listeler","description":"Yönetici yetkisi gerekir. Kapsam: team:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Ekip üyelerini listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EkipUyesi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/team/members/{id}":{"patch":{"tags":["Ekip"],"operationId":"updateTeamMember","summary":"Üyenin rolünü ve bot erişimini değiştirir","description":"Rol yalnız sahip yetkisiyle değişir ve sahip rolü verilemez (sahiplik devri panelde kalır). bot_ids yalnız üye rolünde geçerlidir; null bütün botlar demektir. Yönetici yetkisi gerekir. Kapsam: team:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"role":{"enum":["admin","member"]},"bot_ids":{"type":["array","null"],"maxItems":200,"items":{"type":"string","format":"uuid"}}},"minProperties":1},"example":{"role":"member","bot_ids":["3fa85f64-5717-4562-b3fc-2c963f66afa6"]}}}},"responses":{"200":{"description":"Üyenin rolünü ve bot erişimini değiştirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/EkipUyesi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Ekip"],"operationId":"removeTeamMember","summary":"Üyeyi ekipten çıkarır","description":"Sahip ve anahtarı oluşturan kişi çıkarılamaz (409 member_not_removable); yöneticiyi yalnız sahip çıkarır. Üyenin sohbet atamaları boşalır. Yönetici yetkisi gerekir. Kapsam: team:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Üyeyi ekipten çıkarır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"},"unassigned_conversations":{"type":"integer"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/team/invitations":{"get":{"tags":["Ekip"],"operationId":"listTeamInvitations","summary":"Bekleyen davetleri listeler","description":"Davet bağlantısı dönmez. Yönetici yetkisi gerekir. Kapsam: team:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Bekleyen davetleri listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EkipDaveti"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Ekip"],"operationId":"createTeamInvitation","summary":"Ekibe davet gönderir","description":"Plan koltuk sınırı panelle aynıdır (403 plan_limit). Davet e-postayla gider, bağlantı yanıtta dönmez; e-posta gidemediyse email_sent false olur. Yönetici yetkisi gerekir. Kapsam: team:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["email","role"],"properties":{"email":{"type":"string","format":"email"},"role":{"enum":["admin","member"]}}},"example":{"email":"ayse@ornek.com","role":"member"}}}},"responses":{"201":{"description":"Ekibe davet gönderir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"role":{"enum":["admin","member"]},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"email_sent":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/team/invitations/{id}":{"delete":{"tags":["Ekip"],"operationId":"cancelTeamInvitation","summary":"Daveti iptal eder","description":"Yönetici yetkisi gerekir. Kapsam: team:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Daveti iptal eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/webhooks/{id}/deliveries":{"get":{"tags":["Webhook"],"operationId":"listWebhookDeliveries","summary":"Teslim geçmişini listeler","description":"Olayın içeriği (kişisel veri taşıyabilir) dönmez; yalnız durum, deneme sayısı ve hata döner. Yönetici yetkisi gerekir. Kapsam: webhooks:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Teslim geçmişini listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookTeslimi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/webhooks/{id}/test":{"post":{"tags":["Webhook"],"operationId":"testWebhook","summary":"Test olayı (ping) gönderir","description":"Adrese gerçek bir istek gider (özel ağ adresleri reddedilir). Kapalı webhook 409 webhook_inactive döner. Yönetici yetkisi gerekir. Kapsam: webhooks:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Test olayı (ping) gönderir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"delivered":{"type":"boolean"},"status":{"type":["integer","null"]}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/api-keys":{"get":{"tags":["API anahtarları"],"operationId":"listApiKeys","summary":"API anahtarlarını listeler","description":"Anahtarın kendisi ve özeti dönmez; yalnız başlangıcı döner. Yeni anahtar yalnız panelde üretilir: bir anahtarın kendinden geniş ya da iptalden etkilenmeyen anahtar üretmesi güvenlik açığı olurdu. Yönetici yetkisi gerekir. Kapsam: api_keys:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"API anahtarlarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiAnahtari"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/api-keys/{id}":{"delete":{"tags":["API anahtarları"],"operationId":"revokeApiKey","summary":"API anahtarını iptal eder","description":"Anahtar hemen çalışmaz olur; isteği yapan anahtar da iptal edilebilir. Yönetici yetkisi gerekir. Kapsam: api_keys:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"API anahtarını iptal eder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/connected-apps":{"get":{"tags":["API anahtarları"],"operationId":"listConnectedApps","summary":"OAuth ile bağlı uygulamaları listeler","description":"Belirteçler dönmez. Yönetici yetkisi gerekir. Kapsam: api_keys:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"OAuth ile bağlı uygulamaları listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BagliUygulama"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/connected-apps/{id}":{"delete":{"tags":["API anahtarları"],"operationId":"revokeConnectedApp","summary":"Bağlı uygulamanın erişimini kaldırır","description":"Yönetici yetkisi gerekir. Kapsam: api_keys:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Bağlı uygulamanın erişimini kaldırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/usage/requests":{"get":{"tags":["API anahtarları"],"operationId":"getApiRequestLog","summary":"API istek günlüğü","description":"Son günlerin istek sayısı, hata oranı ve p95 süresi ile son istekler (yeniden eskiye). API anahtarı ve OAuth istekleri kaydedilir; 429 yanıtları kaydedilmez. Günlük 30 gün saklanır. Yönetici yetkisi gerekir. Kapsam: api_keys:read.","parameters":[{"name":"days","in":"query","description":"Özet aralığı (gün, 1–30, varsayılan 7)","schema":{"type":"integer","minimum":1,"maximum":30,"default":7}},{"name":"limit","in":"query","description":"Dönecek son istek sayısı (1–100, varsayılan 100)","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"API istek günlüğü","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ApiIstekOzeti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/integrations/crm":{"get":{"tags":["Organizasyon"],"operationId":"listCrmConnections","summary":"CRM bağlantılarını listele","description":"HubSpot ve Pipedrive bağlantıları; token dönmez, yalnız token_set döner. Kuyruktaki ve başarısız eşitleme işi sayısı da döner. Yönetici yetkisi gerekir. Kapsam: organization:read.","responses":{"200":{"description":"CRM bağlantılarını listele","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CrmBaglantisi"}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Organizasyon"],"operationId":"saveCrmConnection","summary":"CRM bağlantısını kaydet","description":"Token CRM'e salt okuma isteğiyle sınanır; başarısızsa kaydedilmez (400 crm_connection_failed). HubSpot: private app token'ı. Pipedrive: API token'ı ve company_domain (ör. sirketim.pipedrive.com). Kayıtlı bağlantıda token gönderilmezse kayıtlı token korunur. Token şifreli saklanır ve hiçbir yanıtta dönmez. Kişiler telefon ya da e-postayla eşleşip tek yönlü eşitlenir; devir ve Mini App siparişi not ya da fırsat olarak açılır. Yönetici yetkisi gerekir. Kapsam: organization:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["platform"],"properties":{"platform":{"enum":["hubspot","pipedrive"]},"token":{"type":"string","maxLength":500,"description":"HubSpot private app token'ı ya da Pipedrive API token'ı"},"company_domain":{"type":"string","maxLength":200,"description":"Yalnız Pipedrive: şirket alt alanı"},"field_mapping":{"type":"object","additionalProperties":false,"properties":{"tag_field":{"type":["string","null"],"description":"Etiketlerin yazılacağı CRM alanı (HubSpot özellik adı, Pipedrive 40 karakterlik özel alan anahtarı)"},"email_field":{"type":["string","null"],"description":"Doğrulanmış e-posta yoksa kullanılacak Hiboty özel alan anahtarı"},"order_as_deal":{"type":"boolean","description":"Mini App siparişini fırsat olarak aç (varsayılan true)"},"deal_stage":{"type":["string","null"],"description":"Fırsat aşaması: HubSpot dealstage iç kimliği, Pipedrive stage_id"},"note_language":{"enum":["tr","en"]}}}}},"example":{"platform":"hubspot","token":"pat-eu1-…","field_mapping":{"tag_field":"hiboty_tags","order_as_deal":true}}}}},"responses":{"201":{"description":"CRM bağlantısını kaydet","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CrmBaglantisi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Organizasyon"],"operationId":"deleteCrmConnection","summary":"CRM bağlantısını kaldır","description":"Eşitleme durur; CRM'deki kayıtlar silinmez. Yönetici yetkisi gerekir. Kapsam: organization:write.","parameters":[{"name":"platform","in":"query","description":"Kaldırılacak CRM","schema":{"enum":["hubspot","pipedrive"]},"required":true}],"responses":{"200":{"description":"CRM bağlantısını kaldır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"platform":{"enum":["hubspot","pipedrive"]},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/integrations/crm/test":{"post":{"tags":["Organizasyon"],"operationId":"testCrmConnection","summary":"CRM bağlantısını sına","description":"Kayıtlı token'la CRM'e salt okuma isteği gider; sonuç bağlantının durumuna yazılır. Başarısız bağlantı da 200 döner (connected: false); geçersiz token bağlantıyı status: hata yapar. Yönetici yetkisi gerekir. Kapsam: organization:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["platform"],"properties":{"platform":{"enum":["hubspot","pipedrive"]}}},"example":{"platform":"pipedrive"}}}},"responses":{"200":{"description":"CRM bağlantısını sına","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"connected":{"type":"boolean"},"error":{"type":["string","null"]},"error_message":{"type":["string","null"]},"connection":{"$ref":"#/components/schemas/CrmBaglantisi"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/commands":{"post":{"tags":["Botlar"],"operationId":"setBotCommands","summary":"Telegram komut menüsünü kur","description":"Telegram botunun komut menüsünü setMyCommands ile kurar. Gövde boşsa varsayılan menü kurulur: /start, /help ve (yalnız küçük İngilizce harf, rakam ve alt çizgi içeriyorsa) devir kelimesi; Türkçe açıklamalar varsayılan, İngilizceler \"en\" dil kapsamına yazılır. commands verilirse aynı liste iki kapsama yazılır (en fazla 100 komut; komut 1–32 karakter, açıklama 1–256). Menü bağlantıda otomatik kurulur; connect yanıtında warning telegram_commands_failed ise bu uçla yeniden deneyin. Bot bağlı değilse 409 not_connected. Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"commands":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["command","description"],"properties":{"command":{"type":"string","maxLength":33},"description":{"type":"string","maxLength":256}}}}}},"example":{"commands":[{"command":"start","description":"Start"},{"command":"menu","description":"Menu"}]}}}},"responses":{"200":{"description":"Telegram komut menüsünü kur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/TelegramKomutMenusu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/bots/{id}/payments":{"get":{"tags":["Botlar"],"operationId":"getBotPaymentSettings","summary":"Kartla ödeme ayarını getir","description":"Telegram Payments (kartla ödeme) durumu. Sağlayıcı token'ı hiçbir yanıtta dönmez; yalnız provider_token_set ve test_mode döner. Telegram Stars ödemeleri bu ayardan bağımsızdır. Kapsam: bots:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Kartla ödeme ayarını getir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotOdemeAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"put":{"tags":["Botlar"],"operationId":"updateBotPaymentSettings","summary":"Kartla ödeme sağlayıcı token'ını kaydet","description":"BotFather › Payments'tan alınan sağlayıcı token'ını (123:TEST:… ya da 123:LIVE:…) şifreli kaydeder; provider_token null ise token silinir ve kartla ödeme kapanır. Token yalnız biçim olarak denetlenir; geçerliliğini Telegram ilk faturada doğrular. Kaydetmek için bot Telegram'a bağlı olmalıdır (409 not_connected). Kartlı ödemenin iadesi sağlayıcı panelinden yapılır. Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["provider_token"],"properties":{"provider_token":{"type":["string","null"],"maxLength":300,"description":"Sağlayıcı token'ı; null token'ı siler"}}},"example":{"provider_token":"284685063:TEST:…"}}}},"responses":{"200":{"description":"Kartla ödeme sağlayıcı token'ını kaydet","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BotOdemeAyari"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/feed-import":{"post":{"tags":["Mini App"],"operationId":"importMiniAppFeed","summary":"Ürün beslemesini kataloğa aktarır","description":"Google Merchant XML/RSS, CSV ya da JSON beslemesini katalog şablonlu Mini App'in taslağına aktarır; yalnız url ya da content verilir. İlk 50 ürün alınır, fazlası warnings içinde bildirilir; aynı kimlikli ürünlerin yıldız fiyatı ve teslimat içeriği korunur. Yayındaki sürüm değişmez, yayın elle yapılır. dry_run true ise yalnız önizleme döner. auto_refresh true ise adres saklanır ve taslak günde bir yenilenir. ai_knowledge true ise katalog botun AI bilgi kaynağına da yazılır. Adres herkese açık olmalıdır; iç ağ adresleri 400 feed_invalid döner. Saatte en fazla 30 istek. Yönetici yetkisi gerekir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":2000,"description":"Herkese açık http/https besleme adresi"},"content":{"type":"string","maxLength":2000000,"description":"Beslemenin kendisi (dosya içeriği)"},"format":{"enum":["xml","csv","json"],"description":"Verilmezse içerikten tahmin edilir"},"dry_run":{"type":"boolean"},"auto_refresh":{"type":"boolean"},"ai_knowledge":{"type":"boolean"}},"minProperties":1},"example":{"url":"https://shop.example.com/feeds/google.xml","dry_run":false,"auto_refresh":true,"ai_knowledge":true}}}},"responses":{"200":{"description":"Ürün beslemesini kataloğa aktarır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/UrunBeslemeSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/publish-approvals":{"get":{"tags":["Botlar"],"operationId":"listPublishApprovals","summary":"Onay bekleyen değişiklikleri listeler","description":"Yayın onayı açıkken bekleyen bot yapılandırma, araç ve kaynak değişiklikleri ile Mini App yayınları, yeniden eskiye. Yönetici olmayan için boş liste döner. Kapsam: bots:read.","parameters":[{"name":"bot_id","in":"query","description":"Yalnız bu botun değişiklikleri","schema":{"type":"string","format":"uuid"}},{"name":"miniapp_id","in":"query","description":"Yalnız bu Mini App'in yayınları","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Onay bekleyen değişiklikleri listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/YayinOnayi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/versions/{version_id}/approve":{"post":{"tags":["Botlar"],"operationId":"approveBotVersion","summary":"Bekleyen bot değişikliğini onaylar","description":"Değişiklik onaylayanın yetkisiyle uygulanır. Organizasyonda değerlendirme eşiği varsa son koşunun başarı oranı eşiğin altındaysa 409 threshold döner. Yönetici yetkisi gerekir. Dört göz açıkken değişikliği yapan kişi onaylayamaz (403 four_eyes); API anahtarıyla onay verilemez. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"version_id","in":"path","required":true,"description":"version_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Bekleyen bot değişikliğini onaylar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/YayinOnayiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/{id}/versions/{version_id}/reject":{"post":{"tags":["Botlar"],"operationId":"rejectBotVersion","summary":"Bekleyen bot değişikliğini reddeder","description":"Değişiklik uygulanmaz; yönetici ya da değişikliği yapan kişi (geri çekme) reddedebilir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"version_id","in":"path","required":true,"description":"version_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Bekleyen bot değişikliğini reddeder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/YayinOnayiSonucu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/versions/{version_id}/approve":{"post":{"tags":["Mini App"],"operationId":"approveMiniAppVersion","summary":"Onay bekleyen Mini App sürümünü yayınlar","description":"İçerik özeti (config_sha256) doğrulanır ve sürüm yayına girer; özet tutmazsa 409 integrity döner. Plan Mini App içermiyorsa 403 plan_limit. Yönetici yetkisi gerekir. Dört göz açıkken değişikliği yapan kişi onaylayamaz (403 four_eyes); API anahtarıyla onay verilemez. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"version_id","in":"path","required":true,"description":"version_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Onay bekleyen Mini App sürümünü yayınlar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/miniapps/{id}/versions/{version_id}/reject":{"post":{"tags":["Mini App"],"operationId":"rejectMiniAppVersion","summary":"Onay bekleyen Mini App sürümünü reddeder","description":"Sürüm yayına girmez; yönetici ya da yayını isteyen kişi reddedebilir. Kapsam: miniapps:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"version_id","in":"path","required":true,"description":"version_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Onay bekleyen Mini App sürümünü reddeder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MiniAppDetayi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/bulk":{"post":{"tags":["Botlar"],"operationId":"bulkBotAction","summary":"Birden çok botta toplu işlem","description":"Seçilen botları duraklatır (pause), sürdürür (resume) ya da ayarlarını topluca değiştirir (update: ai_enabled, handoff_keyword, voice_transcription). En fazla 100 bot. Her bot ayrı işlenir ve yanıt bot başına sonuç döner (kısmi başarı): erişilemeyen bot not_found, plan sınırı dışındaki bot plan_limit, bağlanmamış bot not_connected nedeniyle atlanır. Ayar değişikliği her bot için sürüm kaydı oluşturur; yayın onayı açıksa her bot için bekleyen değişiklik açılır (pending_approval). Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["action","bot_ids"],"properties":{"action":{"enum":["pause","resume","update"]},"bot_ids":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string"}},"settings":{"type":"object","additionalProperties":false,"properties":{"ai_enabled":{"type":"boolean"},"handoff_keyword":{"type":"string","minLength":2,"maxLength":40},"voice_transcription":{"type":"boolean"}}}}},"example":{"action":"update","bot_ids":["6f1c2a4e-1b7d-4c1a-9a51-3f2b8d7e9c10"],"settings":{"ai_enabled":true}}}}},"responses":{"200":{"description":"Birden çok botta toplu işlem","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/TopluBotIslemi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/evaluations/run-all":{"post":{"tags":["Botlar"],"operationId":"runAllBotEvaluations","summary":"Tüm botlarda değerlendirme setini çalıştırır","description":"Vakası olan ve plan sınırı içindeki botlar sıraya alınır ve arka planda sırayla çalıştırılır; her vaka bir AI yanıtı üretir ve aylık AI kotasından düşer, müşteriye mesaj gitmez. Önce dry_run: true ile tahmini alın (responses_needed); çalıştırmak için max_responses en az bu sayı olmalıdır, değilse 409 budget_not_confirmed. Kota yetmezse 429 ai_quota_exceeded; organizasyonda sırada ya da çalışan bir değerlendirme varsa 409 run_in_progress. bot_ids verilmezse erişilebilen bütün botlar. Sonuçlar GET /api/v1/bots/evaluations ve botun eval-runs ucundan izlenir. Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"bot_ids":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","format":"uuid"}},"dry_run":{"type":"boolean"},"max_responses":{"type":"integer","minimum":0,"description":"Onaylanan en fazla AI yanıtı (bütçe onayı)"}}},"example":{"dry_run":true}}}},"responses":{"200":{"description":"Tüm botlarda değerlendirme setini çalıştırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FiloDegerlendirmeBaslatma"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bots/evaluations":{"get":{"tags":["Botlar"],"operationId":"getFleetEvaluation","summary":"Filo değerlendirme özeti","description":"Erişilebilen her bot için son set çalıştırmasının başarı oranı ve önceki tamamlanmış koşuya göre fark (yüzde puanı); genel ortalama, iyileşen ve kötüleşen bot sayısı. Kapsam: bots:read.","responses":{"200":{"description":"Filo değerlendirme özeti","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FiloDegerlendirmeOzeti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/reports/costs/import":{"post":{"tags":["Raporlar"],"operationId":"importReportCosts","summary":"Reklam maliyetlerini içe aktarır","description":"Kampanya (kind campaign, ref kampanya kimliği), edinme bağlantısı (link, ref bağlantı kodu) ya da tıkla-WhatsApp reklamı (ad, ref Meta reklam kimliği source_id) için dönem maliyetlerini yazar. csv ya da rows verilir; CSV başlığı tur/kind, hedef/ref, tutar/amount, para_birimi/currency, baslangic/period_start, bitis/period_end sütunlarını taşır (ayraç virgül, noktalı virgül ya da sekme). Aynı hedef, dönem ve para birimi güncellenir. Hatalı satırlar errors içinde döner, diğerleri yazılır. Dönemi rapor aralığıyla kesişen maliyetler getRevenueReport ROI'sine eklenir. En fazla 1000 satır. Reklam API'sinden otomatik harcama çekilmez. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"csv":{"type":"string","maxLength":500000,"description":"CSV metni (ilk satır başlık)"},"rows":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["kind","ref","amount","currency","period_start","period_end"],"properties":{"kind":{"enum":["campaign","link","ad"]},"ref":{"type":"string","maxLength":200},"amount":{"type":"number","minimum":0},"currency":{"enum":["TRY","USD","EUR"]},"period_start":{"type":"string","format":"date"},"period_end":{"type":"string","format":"date"}}}}}},"example":{"csv":"tur,hedef,tutar,para_birimi,baslangic,bitis\nad,120226305854810726,1250.50,TRY,2026-11-01,2026-11-30\nlink,INSTA-KASIM,800,TRY,2026-11-01,2026-11-30"}}}},"responses":{"200":{"description":"Reklam maliyetlerini içe aktarır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RaporMaliyetIceAktarma"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bot-templates":{"get":{"tags":["Botlar"],"operationId":"listOrgBotTemplates","summary":"Organizasyon bot şablonlarını listeler","description":"Organizasyonun kaydettiği şablonlar (en yeniden eskiye, en fazla 50). Hazır galeri şablonları için GET /api/v1/bots/templates. Başka organizasyonun şablonu görünmez. Yönetici yetkisi gerekir. Kapsam: bots:read.","responses":{"200":{"description":"Organizasyon bot şablonlarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OrgBotSablonu"}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Botlar"],"operationId":"createOrgBotTemplate","summary":"Botu şablon olarak kaydeder","description":"Botun persona, karşılama, temsilci kelimesi, AI ayarları, bilgi kaynakları ve AI aracı tanımları şablona yazılır (dışa aktarmayla aynı izin listesi). Şablonda kanal token'ı, App Secret, webhook ve imza sırları, gizli başlıklar, kişiler ve sohbetler bulunmaz. Adres içeren araç ve kaynaklar yanıtta listelenir. Aynı ad organizasyonda tekildir (409). Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["bot_id","name"],"properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":2,"maxLength":80},"description":{"type":"string","maxLength":300}}},"example":{"bot_id":"6f1c2a4e-1b7d-4c1a-9a51-3f2b8d7e9c10","name":"Salon bot","description":"Booking and price questions"}}}},"responses":{"201":{"description":"Botu şablon olarak kaydeder","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OrgBotSablonuKaydi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bot-templates/{id}":{"get":{"tags":["Botlar"],"operationId":"getOrgBotTemplate","summary":"Organizasyon şablonunu getirir","description":"Şablonun özeti ve bot dosyası. Şablonda kanal token'ı, App Secret, webhook ve imza sırları, gizli başlıklar, kişiler ve sohbetler bulunmaz. Yönetici yetkisi gerekir. Kapsam: bots:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Organizasyon şablonunu getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OrgBotSablonuAyrinti"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Botlar"],"operationId":"updateOrgBotTemplate","summary":"Şablonun adını ve açıklamasını değiştirir","description":"Yalnız ad ve açıklama değişir; içeriği yenilemek için botu yeniden şablon olarak kaydedin. Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":2,"maxLength":80},"description":{"type":"string","maxLength":300}}},"example":{"name":"Salon bot 2026","description":"Booking, price and cancellation questions"}}}},"responses":{"200":{"description":"Şablonun adını ve açıklamasını değiştirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OrgBotSablonu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Botlar"],"operationId":"deleteOrgBotTemplate","summary":"Şablonu siler","description":"Şablondan oluşturulmuş botlar etkilenmez. Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Şablonu siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/bot-templates/{id}/bots":{"post":{"tags":["Botlar"],"operationId":"createBotFromOrgTemplate","summary":"Şablondan bot oluşturur","description":"Her zaman yeni taslak bot oluşur: kanal bağlanmaz, AI araçları kapalı gelir ve imza sırları yeniden üretilip yalnız bu yanıtta döner. name ve channel verilmezse şablondaki değerler kullanılır. Plan bot sınırı uygulanır (403 plan_limit). Yönetici yetkisi gerekir. Kapsam: bots:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":80},"channel":{"enum":["telegram","whatsapp"]}}},"example":{"name":"Salon Ayse","channel":"whatsapp"}}}},"responses":{"201":{"description":"Şablondan bot oluşturur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/OrgSablondanBot"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/growth-campaigns":{"get":{"tags":["Kampanyalar"],"operationId":"listGrowthCampaigns","summary":"Büyüme kampanyalarını listeler","description":"Telegram büyüme kampanyaları (en yeni önce, en fazla 100); bağlı kaynak sayısı, dönemde kazanılan yeni kişi ve hedefe ilerleme ile. Bot kısıtlı üye yalnız erişebildiği botların bağlantılarını sayar. Kapsam: campaigns:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Büyüme kampanyalarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BuyumeKampanyasi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"post":{"tags":["Kampanyalar"],"operationId":"createGrowthCampaign","summary":"Büyüme kampanyası oluşturur","description":"Hedef kişi, dönem (organizasyon günü, bitiş dahil, en fazla 365 gün) ve isteğe bağlı bütçeyle kampanya açar. Kaynaklar addGrowthCampaignSource ile bağlanır. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","parameters":[{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","goal_contacts","starts_on","ends_on"],"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"goal_contacts":{"type":"integer","minimum":1,"maximum":10000000},"starts_on":{"type":"string","format":"date"},"ends_on":{"type":"string","format":"date"},"budget_amount":{"type":["number","null"],"minimum":0},"budget_currency":{"enum":["TRY","USD","EUR"]}}},"example":{"name":"Instagram launch","goal_contacts":500,"starts_on":"2026-11-01","ends_on":"2026-11-30","budget_amount":7500,"budget_currency":"TRY"}}}},"responses":{"201":{"description":"Büyüme kampanyası oluşturur","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BuyumeKampanyasi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/growth-campaigns/{id}":{"get":{"tags":["Kampanyalar"],"operationId":"getGrowthCampaign","summary":"Büyüme kampanyasını getirir","description":"Kampanyanın ayarları. Huni ve kaynak karşılaştırması getGrowthCampaignReport ile alınır. Kapsam: campaigns:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Büyüme kampanyasını getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BuyumeKampanyasi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"patch":{"tags":["Kampanyalar"],"operationId":"updateGrowthCampaign","summary":"Büyüme kampanyasını günceller","description":"Verilen alanlar değişir; sonuç oluşturma kurallarıyla doğrulanır. budget_amount null bütçeyi kaldırır. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"goal_contacts":{"type":"integer","minimum":1,"maximum":10000000},"starts_on":{"type":"string","format":"date"},"ends_on":{"type":"string","format":"date"},"budget_amount":{"type":["number","null"],"minimum":0},"budget_currency":{"enum":["TRY","USD","EUR"]}},"minProperties":1},"example":{"goal_contacts":750,"ends_on":"2026-12-15"}}}},"responses":{"200":{"description":"Büyüme kampanyasını günceller","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BuyumeKampanyasi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}},"delete":{"tags":["Kampanyalar"],"operationId":"deleteGrowthCampaign","summary":"Büyüme kampanyasını siler","description":"Kampanya silinir; bağlı edinme ve davet bağlantıları, sayaçları ve kişilerin kaynak bilgisi kalır. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Büyüme kampanyasını siler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/growth-campaigns/{id}/report":{"get":{"tags":["Kampanyalar"],"operationId":"getGrowthCampaignReport","summary":"Büyüme kampanyası hunisi ve kaynak karşılaştırması","description":"Huni: izlenen tıklama (Hiboty /g/<kod> düğmesi; Telegram bağlantı tıklaması vermez), başlatma, yeni kişi, sipariş veren kişi, sipariş, ödeme ve davet katılımı. Tıklama, başlatma ve katılım bağlantının toplam sayacıdır; yeni kişi dönemde, siparişler bu kişilerin kayıttan sonraki 30 günüdür (getRevenueReport ile aynı kural). Maliyet: bağlantılara elle girilen ve içe aktarılan (importReportCosts kind link) tutarlar; yoksa bütçe. Kaynak başına aynı ölçüler döner. Kapsam: campaigns:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Büyüme kampanyası hunisi ve kaynak karşılaştırması","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BuyumeKampanyaRaporu"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/growth-campaigns/{id}/sources":{"post":{"tags":["Kampanyalar"],"operationId":"addGrowthCampaignSource","summary":"Kampanyaya kaynak bağlar ya da yeni bağlantı açar","description":"kind acquisition_link: source_id ile mevcut Telegram edinme bağlantısı bağlanır ya da bot_id + name (+ code) ile yeni start bağlantısı (t.me/<bot>?start=<kod>) açılır. kind invite_link: source_id ile mevcut davet bağlantısı ya da community_id + name (+ member_limit, expires_in_days, join_request) ile Telegram'da yeni davet bağlantısı açılır. Başka kampanyadaki bağlantı bu kampanyaya taşınır. Kampanya başına en fazla 50 kaynak. Telegram hatası 502 channel_error döner. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.","schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"enum":["acquisition_link","invite_link"]},"source_id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"community_id":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":40},"code":{"type":"string","maxLength":32,"pattern":"^[A-Za-z0-9_-]{2,32}$"},"member_limit":{"type":["integer","null"],"minimum":1,"maximum":99999},"expires_in_days":{"type":["integer","null"],"minimum":1,"maximum":365},"join_request":{"type":"boolean"}}},"example":{"kind":"acquisition_link","bot_id":"00000000-0000-4000-8000-000000000001","name":"Instagram biyografi","code":"ig-bio"}}}},"responses":{"201":{"description":"Kampanyaya kaynak bağlar ya da yeni bağlantı açar","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Idempotency-Replayed":{"description":"Yanıt daha önceki bir istekten aynen döndüyse true","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/BuyumeKampanyaKaynagi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/growth-campaigns/{id}/sources/{source_id}":{"delete":{"tags":["Kampanyalar"],"operationId":"removeGrowthCampaignSource","summary":"Kaynağı kampanyadan ayırır","description":"Bağlantı kampanyadan çıkar; bağlantının kendisi, Telegram'daki davet bağlantısı ve sayaçlar kalır. Yönetici yetkisi gerekir. Kapsam: campaigns:write.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"source_id","in":"path","required":true,"description":"source_id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Kaynağı kampanyadan ayırır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","deleted"],"properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}}}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/whatsapp-accounts":{"get":{"tags":["Botlar"],"operationId":"listWhatsAppAccounts","summary":"WhatsApp hesaplarını listeler","description":"İşletme portföyü › WhatsApp Business hesabı (WABA) › telefon numarası hiyerarşisi. Aynı WABA'daki numaralar tek hesapta görünür; şablonlar ve Meta faturası hesap düzeyindedir. Erişim anahtarı ve App Secret hiçbir yanıtta dönmez; yalnız access_token_set ve app_secret_set döner. Bot erişimi kısıtlı üye yalnız erişebildiği numaraları ve bu numaraların hesaplarını görür. Kapsam: bots:read.","parameters":[{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"WhatsApp hesaplarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WhatsAppHesabi"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/whatsapp-accounts/{id}":{"get":{"tags":["Botlar"],"operationId":"getWhatsAppAccount","summary":"WhatsApp hesabını getirir","description":"Hesap ve numaraları (kalite, mesajlaşma sınırı, teslim puanı). Erişim anahtarı ve App Secret hiçbir yanıtta dönmez; yalnız access_token_set ve app_secret_set döner. Bot erişimi kısıtlı üye yalnız erişebildiği numaraları ve bu numaraların hesaplarını görür. Kapsam: bots:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"WhatsApp hesabını getirir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/WhatsAppHesabi"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"429":{"$ref":"#/components/responses/HizSiniri"}}}},"/api/v1/whatsapp-accounts/{id}/templates":{"get":{"tags":["Botlar"],"operationId":"listWhatsAppAccountTemplates","summary":"WhatsApp hesabının şablonlarını listeler","description":"Meta'daki bütün şablonlar (durum ve ret nedeniyle), hesap (WABA) düzeyinde; hesaba bağlı her numara aynı şablonları kullanır. Hesap bağlı değilse 409 channel_not_configured, Meta hatasında 502. Kapsam: bots:read.","parameters":[{"name":"id","in":"path","required":true,"description":"id kimliği","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"WhatsApp hesabının şablonlarını listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WhatsAppHesapSablonu"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"404":{"$ref":"#/components/responses/Bulunamadi"},"409":{"$ref":"#/components/responses/Cakisma"},"429":{"$ref":"#/components/responses/HizSiniri"},"502":{"$ref":"#/components/responses/KanalHatasi"}}}},"/api/v1/connections":{"get":{"tags":["Organizasyon"],"operationId":"listConnections","summary":"Bağlantıları listeler","description":"Bot kanalları (Telegram, WhatsApp numarası), WhatsApp hesapları, mağaza, CRM, AI araçları, giden webhook'lar, OAuth uygulamaları ve ürün beslemeleri tek listede: tür, ad, durum, son olay ve son hata. Önce sorunlular gelir. Token, App Secret, imza sırrı ve gizli başlık hiçbir zaman dönmez; adreslerin yalnız alan adı döner. Mağaza, CRM, webhook ve OAuth satırları yalnız yöneticiye listelenir; bot erişimi kısıtlı üye yalnız erişebildiği botların bağlantılarını görür. Kapsam: organization:read.","parameters":[{"name":"kind","in":"query","description":"Yalnız bu tür","schema":{"enum":["telegram_bot","whatsapp_number","whatsapp_account","store","crm","ai_tool","webhook","oauth_app","product_feed"]}},{"name":"status","in":"query","description":"Yalnız bu durum","schema":{"enum":["bagli","uyari","hata","kapali","bagli_degil"]}},{"name":"limit","in":"query","description":"Sayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Önceki yanıttaki next_cursor (opak)","schema":{"type":"string"}}],"responses":{"200":{"description":"Bağlantıları listeler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","next_cursor"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Baglanti"}},"next_cursor":{"type":["string","null"],"description":"Sonraki sayfa için opak imleç; son sayfada null"}}}}}},"400":{"$ref":"#/components/responses/Dogrulama"},"401":{"$ref":"#/components/responses/Yetkisiz"},"403":{"$ref":"#/components/responses/Yasak"},"429":{"$ref":"#/components/responses/HizSiniri"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"hb_live_… | hb_oat_…","description":"Authorization: Bearer hb_live_… (API anahtarı) ya da hb_oat_… (OAuth erişim belirteci)"}},"schemas":{"OtomasyonDetayi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"trigger":{"enum":["yeni_kisi","anahtar_kelime","etiket_eklendi","sessiz","miniapp_gonderim"]},"trigger_config":{"type":"object","description":"Şablona ya da tetikleyiciye göre değişen yapılandırma"},"steps":{"type":"array","items":{"type":"object"}},"active":{"type":"boolean"},"run_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"OtomasyonCalistirmasi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"contact_id":{"type":"string","format":"uuid"},"status":{"enum":["running","waiting","completed","failed","stopped"]},"step_index":{"type":"integer","description":"Sıradaki adımın indeksi (0'dan başlar)"},"error":{"type":["string","null"]},"log":{"type":"array","items":{"type":"object","properties":{"step":{"type":"integer"},"type":{"type":"string"},"result":{"type":"string"},"at":{"type":"string"}}}},"next_run_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"MiniAppDetayi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"template":{"enum":["katalog","form","baglanti"]},"status":{"enum":["draft","published","unpublished"]},"url":{"type":"string"},"menu_button":{"type":"boolean"},"draft":{"type":"object","description":"Şablona ya da tetikleyiciye göre değişen yapılandırma"},"published_version":{"type":["object","null"],"description":"En son yayına alınan sürüm","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"integer"},"config":{"type":"object","description":"Şablona ya da tetikleyiciye göre değişen yapılandırma"},"created_at":{"type":"string","format":"date-time"}}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"MiniAppSurumu":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"integer"},"config":{"type":"object","description":"Şablona ya da tetikleyiciye göre değişen yapılandırma"},"is_published":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"config_sha256":{"type":["string","null"],"description":"Yapılandırmanın kanonik JSON SHA-256 özeti; yayından sonra değişmez, geri almada doğrulanır"},"status":{"enum":["published","pending","rejected"],"description":"pending: yayın onayı bekliyor; rejected: reddedildi"}}},"MiniAppOnizlemesi":{"type":"object","properties":{"url":{"type":"string","description":"Taslağı gösteren imzalı adres; süre sonunda geçersiz olur"},"expires_at":{"type":"string","format":"date-time"},"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}},"config":{"type":"object","description":"Şablona ya da tetikleyiciye göre değişen yapılandırma"}}},"Siparis":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"mini_app_id":{"type":"string","format":"uuid"},"mini_app_name":{"type":"string"},"status":{"enum":["yeni","hazirlaniyor","tamamlandi","iptal"]},"contact_id":{"type":["string","null"],"format":"uuid"},"user_name":{"type":["string","null"]},"data":{"type":"object","description":"Şablona ya da tetikleyiciye göre değişen yapılandırma"},"source":{"type":["string","null"]},"payment":{"type":["object","null"],"description":"Telegram Stars ya da kartlı ödeme varsa (T07). amount en küçük birimdedir (kuruş/sent; Stars'ta yıldız sayısı).","properties":{"status":{"enum":["pending","paid","refunded"]},"method":{"enum":["telegram_stars","telegram_card"]},"currency":{"type":"string","description":"XTR ya da TRY, USD, EUR"},"amount":{"type":["integer","null"]},"amount_stars":{"type":["integer","null"],"description":"Yalnız Stars ödemesinde dolu (geri uyum)"}}},"status_updated_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"OzelMiniAppTalebi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["yeni","incelemede","teklif","kabul","odendi","uretimde","onizleme","onizleme_onay","teslim","iptal","reddedildi"]},"title":{"type":"string"},"description":{"type":"string"},"examples":{"type":"string"},"budget":{"type":"string"},"takes_payment":{"type":"boolean"},"handles_personal_data":{"type":"boolean"},"quote_amount_cents":{"type":["integer","null"]},"monthly_amount_cents":{"type":["integer","null"]},"delivery_days":{"type":["integer","null"]},"quote_note":{"type":["string","null"]},"payment_url":{"type":["string","null"],"description":"Yalnız teklif kabul edildikten sonra döner"},"preview_url":{"type":["string","null"],"description":"Yalnız önizleme aşamasında döner"},"delivery_url":{"type":["string","null"],"description":"Yalnız teslimden sonra döner"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"KisiEtiketi":{"type":"object","properties":{"key":{"type":"string","description":"Karşılaştırma anahtarı; büyük/küçük harf ve I/İ/ı farkı yok sayılır"},"name":{"type":"string","description":"En çok kullanılan yazım"},"variants":{"type":"array","items":{"type":"string"}},"contact_count":{"type":"integer"},"automation_count":{"type":"integer"}}},"KisiOzelAlani":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string","description":"Alan anahtarı: CSV başlığı, attributes anahtarı ve {{anahtar}} değişkeni; değişmez"},"label":{"type":"string"},"type":{"enum":["metin","sayi","tarih","secim"]},"options":{"type":"array","items":{"type":"string"}},"ai_writable":{"type":"boolean"}}},"KisiIceAktarmaSonucu":{"type":"object","properties":{"added":{"type":"integer"},"updated":{"type":"integer"},"skipped":{"type":"integer","description":"Hatalı ya da dosyada yinelenen kimlikli satırlar"},"invalid_field_values":{"type":"integer"},"errors":{"type":"array","items":{"type":"object","properties":{"row":{"type":"integer","description":"Dosyadaki satır numarası (başlık 1. satır)"},"code":{"enum":["missing_channel_id","invalid_telegram_id","invalid_whatsapp_phone"]}}}}}},"SohbetAyrintisi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["open","handoff","closed"]},"unread_count":{"type":"integer"},"last_message_preview":{"type":["string","null"]},"last_message_at":{"type":["string","null"],"format":"date-time"},"handoff_at":{"type":["string","null"],"format":"date-time"},"closed_at":{"type":["string","null"],"format":"date-time"},"snoozed_until":{"type":["string","null"],"format":"date-time","description":"Bu zamana kadar gelen kutusu listesinde gizlenir"},"flood_until":{"type":["string","null"],"format":"date-time","description":"Mesaj seli nedeniyle AI yanıtının duraklatıldığı an"},"created_at":{"type":"string","format":"date-time"},"bot":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"channel":{"type":"string"}}},"contact":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"external_id":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"channel":{"type":"string"},"consent":{"type":"string"}}},"assigned_user":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}}}},"SohbetNotu":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"conversation_id":{"type":"string","format":"uuid"},"user_id":{"type":["string","null"],"format":"uuid","description":"Notu yazan; API anahtarıyla yazıldıysa ya da kullanıcı silindiyse null"},"author_name":{"type":["string","null"]},"body":{"type":"string"},"mentions":{"type":"array","items":{"type":"string","format":"uuid"}},"created_at":{"type":"string","format":"date-time"}}},"HazirYanit":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"shortcut":{"type":"string","description":"Gelen kutusunda /kısa-ad ile eklenir; organizasyonda tekildir"},"body":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"KampanyaVaryantSonucu":{"type":"object","properties":{"variant":{"enum":["a","b"]},"audience":{"type":"integer"},"sent":{"type":"integer"},"failed":{"type":"integer"},"replied":{"type":"integer"}}},"KampanyaSonuclari":{"type":"object","properties":{"campaign_id":{"type":"string","format":"uuid"},"status":{"type":"string"},"audience_count":{"type":"integer"},"sent_count":{"type":"integer"},"failed_count":{"type":"integer"},"replied_count":{"type":"integer","description":"Gönderimden sonraki 72 saat içinde yanıt veren alıcılar"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/KampanyaVaryantSonucu"},"description":"Otomatik kazananda yalnız test grubu"},"remaining_variants":{"type":"array","items":{"$ref":"#/components/schemas/KampanyaVaryantSonucu"},"description":"Otomatik kazananda kalan kitle; klasik A/B'de boş"},"ab_stage":{"type":["string","null"],"enum":["test","waiting","winner",null]},"ab_test_percent":{"type":["integer","null"]},"ab_wait_hours":{"type":["integer","null"]},"ab_decide_at":{"type":["string","null"],"format":"date-time"},"ab_winner":{"type":["string","null"],"enum":["a","b",null]},"ab_decision":{"type":["object","null"],"properties":{"reason":{"type":"string"},"metric":{"type":"string"},"a":{"type":"object","properties":{"sent":{"type":"integer"},"replied":{"type":"integer"},"read":{"type":["integer","null"]}}},"b":{"type":"object","properties":{"sent":{"type":"integer"},"replied":{"type":"integer"},"read":{"type":["integer","null"]}}}}},"ab_decided_at":{"type":["string","null"],"format":"date-time"}}},"KampanyaKitleSayisi":{"type":"object","properties":{"audience_count":{"type":"integer"}}},"KampanyaEnIyiSaat":{"type":"object","properties":{"suggestion":{"type":["object","null"],"properties":{"weekday":{"type":"integer","description":"ISO hafta günü: 1 pazartesi, 7 pazar"},"hour":{"type":"integer"},"interactions":{"type":"integer"}}},"reason":{"type":["string","null"],"enum":["veri_az","kisi_az","uygun_saat_yok","unavailable",null],"description":"Öneri yoksa nedeni; unavailable: hesap zaman aşımına uğradı"},"interactions":{"type":"integer"},"contacts":{"type":"integer"},"next_at":{"type":["string","null"],"format":"date-time"},"timezone":{"type":"string"}}},"RaporGenelBakis":{"type":"object","properties":{"days":{"type":"integer"},"usage":{"type":"object","properties":{"messages":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"}}},"ai_replies":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"effective_limit":{"type":["integer","null"]},"own_key":{"type":"boolean"}}},"ai_tokens":{"type":"integer"}}},"contacts":{"type":"object","properties":{"total":{"type":"integer"},"opted_in":{"type":"integer"}}},"conversations":{"type":"object","properties":{"total":{"type":"integer"},"handoff":{"type":"integer"}}},"bots":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"incoming":{"type":"integer"},"ai":{"type":"integer"},"agent":{"type":"integer"}}}},"hourly":{"type":"array","items":{"type":"integer"},"description":"Organizasyon diliminde saat başına gelen mesaj (24 öğe)"},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"ai":{"type":"integer"},"agent":{"type":"integer"}}}},"campaigns":{"type":"object","properties":{"total":{"type":"integer"},"completed":{"type":"integer"},"delivered":{"type":"integer"}}}}},"RaporTeslim":{"type":"object","properties":{"days":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"},"success_rate":{"type":["number","null"]},"recovered":{"type":"integer"},"sources":{"type":"array","items":{"type":"object","properties":{"sender":{"type":"string"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}},"reasons":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"count":{"type":"integer"}}}},"samples":{"type":"array","items":{"type":"object","properties":{"error":{"type":"string"},"count":{"type":"integer"}}}}}},"RaporTemsilci":{"type":"object","properties":{"days":{"type":"integer"},"handoffs":{"type":"integer"},"resolved":{"type":"integer"},"first_reply_median_seconds":{"type":["number","null"]},"resolution_average_seconds":{"type":["number","null"]},"sla_target_minutes":{"type":"integer"},"sla_compliance":{"type":["number","null"]},"waiting":{"type":"integer"},"oldest_waiting_seconds":{"type":["integer","null"]},"agents":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"open":{"type":"integer"},"replies":{"type":"integer"},"first_reply_median_seconds":{"type":["number","null"]}}}}}},"RaporCsat":{"type":"object","properties":{"days":{"type":"integer"},"enabled":{"type":"boolean"},"responses":{"type":"integer"},"average":{"type":["number","null"]},"satisfied_rate":{"type":["number","null"]},"distribution":{"type":"array","items":{"type":"integer"},"description":"1'den 5'e puan başına yanıt sayısı"},"agents":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"responses":{"type":"integer"},"average":{"type":["number","null"]},"satisfied_rate":{"type":["number","null"]}}}}}},"RaporAiKalite":{"type":"object","properties":{"days":{"type":"integer"},"ai_replies":{"type":"integer"},"rated":{"type":"integer"},"liked":{"type":"integer"},"disliked":{"type":"integer"},"like_rate":{"type":["number","null"]},"coverage":{"type":["number","null"]},"attributed_replies":{"type":"integer"},"unsourced_replies":{"type":"integer"},"unsourced_rate":{"type":["number","null"]}}},"RaporKohort":{"type":"object","properties":{"new_contacts":{"type":"integer"},"first_week_return_rate":{"type":["number","null"]},"cohorts":{"type":"array","items":{"type":"object","properties":{"week":{"type":"string"},"size":{"type":"integer"},"rates":{"type":"array","items":{"type":["number","null"]},"description":"Hafta 0'dan itibaren 0-1 arası oran; henüz gelmemiş hafta null"}}}}}},"RaporGelir":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"range_clamped":{"type":"boolean","description":"Aralık 1 yılı aştığı için bitişten geriye kırpıldı"},"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"bot_name":{"type":"string"},"channel":{"type":"string"},"summary":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"mixed":{"type":["object","null"],"additionalProperties":{"type":"number"},"description":"Farklı para birimli maliyetler (toplanmaz)"}}},"manual_cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]}}},"roi":{"type":"object","properties":{"value":{"type":["number","null"]},"reason":{"type":["string","null"]}}}}}},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"bot_name":{"type":"string"},"channel":{"type":"string"},"summary":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"mixed":{"type":["object","null"],"additionalProperties":{"type":"number"},"description":"Farklı para birimli maliyetler (toplanmaz)"}}},"manual_cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]}}},"roi":{"type":"object","properties":{"value":{"type":["number","null"]},"reason":{"type":["string","null"]}}},"code":{"type":"string"},"new_contacts":{"type":"integer"},"cost_per_contact":{"type":"object","properties":{"value":{"type":["number","null"]},"currency":{"type":["string","null"]},"reason":{"type":["string","null"]}}}}}},"ads":{"type":"array","description":"Tıkla-WhatsApp reklamları (referral source_id); reklam tıklamasından sonraki 30 gün, son dokunuş","items":{"type":"object","properties":{"id":{"type":"string","description":"Meta reklam kimliği (source_id)"},"name":{"type":"string"},"source_type":{"type":"string"},"source_url":{"type":["string","null"]},"new_contacts":{"type":"integer"},"summary":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"mixed":{"type":["object","null"],"additionalProperties":{"type":"number"},"description":"Farklı para birimli maliyetler (toplanmaz)"}}},"roi":{"type":"object","properties":{"value":{"type":["number","null"]},"reason":{"type":["string","null"]}}},"cost_per_contact":{"type":"object","properties":{"value":{"type":["number","null"]},"currency":{"type":["string","null"]},"reason":{"type":["string","null"]}}}}}},"totals":{"type":"object","properties":{"campaigns":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"links":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"store":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}},"description":"Bot sohbetiyle eşleşen mağaza (Shopify/WooCommerce) siparişleri; mağaza para birimiyle ayrı"},"ads":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}}}},"conversions":{"type":"object","properties":{"campaigns":{"type":"object","properties":{"target":{"type":"string"},"total":{"type":"number"},"converted":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number"},"equivalent":{"type":"number"}}}},"unconverted":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"links":{"type":"object","properties":{"target":{"type":"string"},"total":{"type":"number"},"converted":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number"},"equivalent":{"type":"number"}}}},"unconverted":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"store":{"type":"object","properties":{"target":{"type":"string"},"total":{"type":"number"},"converted":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number"},"equivalent":{"type":"number"}}}},"unconverted":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"ads":{"type":"object","properties":{"target":{"type":"string"},"total":{"type":"number"},"converted":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number"},"equivalent":{"type":"number"}}}},"unconverted":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}}}},"exchange_rate":{"type":["object","null"],"properties":{"usd_try":{"type":"number"},"date":{"type":"string"}}},"out_of_scope":{"type":"object","properties":{"miniapp_orders":{"type":"integer"},"orders_without_contact":{"type":"integer"},"store_orders":{"type":["integer","null"],"description":"Bot kısıtlı üyeye gösterilmez (null)"},"store_unmatched":{"type":["integer","null"]}}},"truncated":{"type":"boolean"}}},"RaporKullanim":{"type":"object","properties":{"plan":{"type":"string"},"limits":{"type":"object","properties":{"bots":{"type":"integer"},"seats":{"type":"integer"},"workspaces":{"type":"integer"},"monthly_messages":{"type":"integer"},"monthly_ai_replies":{"type":"integer"},"campaigns":{"type":"boolean"},"api":{"type":"boolean"},"miniapps":{"type":"boolean"}}},"messages":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer","description":"Ek mesaj bakiyesi dahil bu ayın sınırı"},"extra_credits":{"type":"integer","description":"Kalan ek mesaj bakiyesi; plan kotası bitince kullanılır"}}},"ai_replies":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"extra_credits":{"type":"integer"}}},"ai_tokens":{"type":"object","properties":{"input":{"type":"integer"},"output":{"type":"integer"},"total":{"type":"integer"}}},"breakdown":{"$ref":"#/components/schemas/RaporKullanimKirilimi","description":"Yalnız group_by verilince döner"}}},"RaporKullanimKirilimi":{"type":"object","properties":{"group_by":{"enum":["bot","channel"]},"rows":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"Bot kimliği ya da kanal; botu ya da kanalı bilinmeyen kullanım için diger"},"bot_id":{"type":["string","null"],"format":"uuid"},"name":{"type":["string","null"]},"channel":{"enum":["telegram","whatsapp",null]},"messages_out":{"type":"integer","description":"Bu ay giden ve başarısız olmayan mesaj (mesaj kotası birimi)"},"ai_replies":{"type":"integer","description":"Plan kotasına sayılan AI yanıtı (müşteriye kota birimi)"},"media":{"type":"integer","description":"Platform anahtarında sesli mesaj dökümü, görsel betimleme ve sesli yanıt"},"meta_estimate_usd":{"type":["number","null"],"description":"Girilen Meta oranlarıyla tahmini WhatsApp ücreti (USD); oran yoksa null"}}}},"totals":{"type":"object","properties":{"messages_out":{"type":"integer"},"ai_replies":{"type":"integer"},"media":{"type":"integer"},"meta_estimate_usd":{"type":["number","null"]}}}}},"RaporMaliyet":{"type":"object","properties":{"kind":{"enum":["campaign","link"]},"id":{"type":"string","format":"uuid"},"amount":{"type":["number","null"]},"currency":{"type":["string","null"]}}},"ApiUyarisi":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"Topluluk":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"bot_name":{"type":"string"},"bot_username":{"type":["string","null"]},"chat_id":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"username":{"type":["string","null"]},"bot_status":{"type":"string"},"member_count":{"type":"integer"},"last_activity_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"ToplulukAyrintisi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"bot_name":{"type":"string"},"bot_username":{"type":["string","null"]},"chat_id":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"username":{"type":["string","null"]},"bot_status":{"type":"string"},"member_count":{"type":"integer"},"last_activity_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"bot_permissions":{"type":"object","description":"Botun Telegram'daki yönetici izinleri","additionalProperties":{"type":"boolean"}},"welcome_enabled":{"type":"boolean"},"welcome_message":{"type":"string"},"welcome_delete_after_sec":{"type":"integer"},"ai_enabled":{"type":"boolean"},"ai_hourly_limit":{"type":"integer"},"join_request_mode":{"enum":["manual","approve","verify"]},"join_request_message":{"type":"string"},"join_request_button":{"type":"string"},"join_approved_message":{"type":"string"},"rules":{"type":"object","properties":{"block_links":{"type":"boolean"},"block_forwards":{"type":"boolean"},"banned_words":{"type":"array","items":{"type":"string"}},"flood_count":{"type":"integer"},"flood_seconds":{"type":"integer"},"action":{"enum":["delete","warn","mute"]},"exempt_admins":{"type":"boolean"}}},"forum_topics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}},"updated_at":{"type":"string","format":"date-time"}}},"ToplulukGuncelleme":{"type":"object","properties":{"community":{"$ref":"#/components/schemas/ToplulukAyrintisi"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/ApiUyarisi"}}}},"DavetBaglantisi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"community_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"invite_link":{"type":"string"},"member_limit":{"type":["integer","null"]},"expires_at":{"type":["string","null"],"format":"date-time"},"join_request":{"type":"boolean"},"joins":{"type":"integer"},"leaves":{"type":"integer"},"status":{"enum":["active","revoked","expired","full"]},"revoked_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"PlanliGonderi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"community_id":{"type":"string","format":"uuid"},"batch_id":{"type":["string","null"],"format":"uuid","description":"Çok hedefli gönderide aynı formdan çıkan hedeflerin ortak kimliği"},"topic_id":{"type":["integer","null"]},"text":{"type":"string"},"image_url":{"type":["string","null"]},"button_text":{"type":["string","null"]},"button_url":{"type":["string","null"]},"silent":{"type":"boolean"},"pin":{"type":"boolean"},"repeat":{"enum":["none","daily","weekly"]},"status":{"enum":["pending_approval","rejected","scheduled","sending","sent","failed","uncertain","canceled"]},"scheduled_at":{"type":"string","format":"date-time"},"retry_at":{"type":["string","null"],"format":"date-time"},"attempts":{"type":"integer"},"message_id":{"type":["string","null"]},"simulated":{"type":"boolean","description":"Organizasyon test modundayken Telegram'a gönderilmeden yayınlanmış sayıldı"},"error":{"type":["string","null"]},"reject_reason":{"type":["string","null"]},"created_by":{"type":["string","null"],"format":"uuid"},"reviewed_at":{"type":["string","null"],"format":"date-time"},"sent_at":{"type":["string","null"],"format":"date-time"},"clicks":{"type":["integer","null"],"description":"Düğmenin izlenen yönlendirmesindeki tıklama (bot ve önizleme istekleri sayılmaz). Düğmesiz ya da henüz yayınlanmamış gönderide null. Telegram Bot API görüntülenme sayısı vermez."},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"PlanliGonderiAyrintisi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"community_id":{"type":"string","format":"uuid"},"batch_id":{"type":["string","null"],"format":"uuid","description":"Çok hedefli gönderide aynı formdan çıkan hedeflerin ortak kimliği"},"topic_id":{"type":["integer","null"]},"text":{"type":"string"},"image_url":{"type":["string","null"]},"button_text":{"type":["string","null"]},"button_url":{"type":["string","null"]},"silent":{"type":"boolean"},"pin":{"type":"boolean"},"repeat":{"enum":["none","daily","weekly"]},"status":{"enum":["pending_approval","rejected","scheduled","sending","sent","failed","uncertain","canceled"]},"scheduled_at":{"type":"string","format":"date-time"},"retry_at":{"type":["string","null"],"format":"date-time"},"attempts":{"type":"integer"},"message_id":{"type":["string","null"]},"simulated":{"type":"boolean","description":"Organizasyon test modundayken Telegram'a gönderilmeden yayınlanmış sayıldı"},"error":{"type":["string","null"]},"reject_reason":{"type":["string","null"]},"created_by":{"type":["string","null"],"format":"uuid"},"reviewed_at":{"type":["string","null"],"format":"date-time"},"sent_at":{"type":["string","null"],"format":"date-time"},"clicks":{"type":["integer","null"],"description":"Düğmenin izlenen yönlendirmesindeki tıklama (bot ve önizleme istekleri sayılmaz). Düğmesiz ya da henüz yayınlanmamış gönderide null. Telegram Bot API görüntülenme sayısı vermez."},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"batch_status":{"enum":["pending_approval","rejected","scheduled","sending","sent","partial","failed","uncertain","canceled",null],"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"community_id":{"type":"string","format":"uuid"},"status":{"enum":["pending_approval","rejected","scheduled","sending","sent","failed","uncertain","canceled"]}}}}}},"PlanliGonderiSonucu":{"type":"object","properties":{"batch_id":{"type":["string","null"],"format":"uuid"},"posts":{"type":"array","items":{"$ref":"#/components/schemas/PlanliGonderi"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/ApiUyarisi"}},"whatsapp_campaign":{"type":["object","null"],"description":"Yalnız whatsapp bloğu gönderildiyse: açılan kampanya taslağı (onay bekliyor); açılamadıysa null ve warnings içinde whatsapp_campaign_failed","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"audience_count":{"type":"integer"}}}}},"GonderiTakvimi":{"type":"object","properties":{"month":{"type":"string"},"timezone":{"type":"string"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"in_month":{"type":"boolean"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"batch_id":{"type":["string","null"],"format":"uuid"},"status":{"enum":["pending_approval","rejected","scheduled","sending","sent","partial","failed","uncertain","canceled"]},"scheduled_at":{"type":"string","format":"date-time"},"repeat":{"enum":["none","daily","weekly"]},"text":{"type":"string"},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"community_id":{"type":"string","format":"uuid"},"community_title":{"type":"string"},"status":{"enum":["pending_approval","rejected","scheduled","sending","sent","failed","uncertain","canceled"]}}}}}}}}}}}},"OrganizasyonAyari":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"plan":{"type":"string"},"brand":{"type":"object","properties":{"name":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"color":{"type":["string","null"]}}},"timezone":{"type":"string"},"campaign_frequency_hours":{"type":"integer"},"quiet_hours_start":{"type":["integer","null"]},"quiet_hours_end":{"type":["integer","null"]},"campaign_four_eyes":{"type":"boolean","description":"Yalnız okunur; panelden değişir"},"business_hours":{"type":["object","null"],"properties":{"days":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"start":{"type":"string","description":"SS:DD"},"end":{"type":"string","description":"SS:DD"},"message":{"type":"string"}}},"csat":{"type":["object","null"],"properties":{"question":{"type":"string"},"thank_you":{"type":"string"}}},"sla_target_minutes":{"type":"integer"},"sla_escalation":{"type":"boolean"},"test_mode":{"type":"boolean"},"data_retention_days":{"type":["integer","null"]},"suspended":{"type":"boolean"},"suspended_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"legal_hold":{"type":"boolean","description":"Yalnız okunur; yasal saklama açıkken saklama süresi, kişi silme ve organizasyon silme durur (kişi silme 409 legal_hold döner, talep askıda kaydedilir). Panelden yalnız sahip değiştirir."},"legal_hold_at":{"type":["string","null"],"format":"date-time"}}},"IcerikPolitikasiAyari":{"type":"object","properties":{"enabled":{"type":"boolean"},"blocked_phrases":{"type":"array","items":{"type":"string"}},"warned_phrases":{"type":"array","items":{"type":"string"}},"allowed_domains":{"type":"array","items":{"type":"string"}},"blocked_domains":{"type":"array","items":{"type":"string"}},"max_links":{"type":["integer","null"]},"max_caps_percent":{"type":["integer","null"]}}},"AiAyari":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"monthly_limit":{"type":"integer"},"anthropic_key_set":{"type":"boolean"},"openrouter_key_set":{"type":"boolean"},"openai_key_set":{"type":"boolean"}}},"MagazaBaglantisi":{"type":"object","properties":{"platform":{"type":"string","enum":["woocommerce","shopify"]},"store_url":{"type":"string"},"notify_statuses":{"type":"array","items":{"type":"string"}},"language":{"enum":["tr","en"]},"notify_opted_out":{"type":"boolean"},"wa_template":{"type":["object","null"],"properties":{"name":{"type":"string"},"language":{"type":"string"}}},"credentials_set":{"type":"boolean"},"webhook_secret_set":{"type":"boolean"},"last_error":{"type":["string","null"]},"last_event_at":{"type":["string","null"],"format":"date-time"}}},"MedyaOgesi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","description":"Tam adres"},"path":{"type":"string","description":"Göreli adres (/u/…); brand.logo_url gibi alanlarda kullanılabilir"},"name":{"type":["string","null"]},"mime":{"type":"string"},"size":{"type":"integer"},"created_at":{"type":"string","format":"date-time"}}},"MedyaKullanimi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"in_use":{"type":"boolean"},"usages":{"type":"array","items":{"type":"object","properties":{"place":{"enum":["campaign","scheduled_post","brand_logo","mini_app","automation","message"]},"count":{"type":"integer"}}}}}},"DenetimKaydi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"action":{"type":"string"},"action_name":{"type":"string"},"category":{"type":"string"},"user_id":{"type":["string","null"],"format":"uuid"},"target":{"type":["string","null"]},"summary":{"type":"string","description":"Temizlenmiş özet; e-posta, telefon, IP ve serbest metin içermez"},"created_at":{"type":"string","format":"date-time"}}},"AbonelikOzeti":{"type":"object","properties":{"plan":{"type":"string"},"limits":{"type":"object","properties":{"bots":{"type":"integer"},"monthly_messages":{"type":"integer"},"ai_replies":{"type":"integer"},"seats":{"type":"integer"},"workspaces":{"type":"integer"},"campaigns":{"type":"boolean"},"api":{"type":"boolean"},"mini_apps":{"type":"boolean"},"storage_mb":{"type":"integer"}}},"usage":{"type":"object","properties":{"messages":{"type":"integer"},"ai_replies":{"type":"integer"},"bots":{"type":"integer"},"seats":{"type":"integer"},"storage_bytes":{"type":"integer"}}},"subscription":{"type":["object","null"],"properties":{"status":{"type":"string"},"plan":{"type":"string"},"period":{"type":"string"},"current_period_end":{"type":["string","null"],"format":"date-time"},"canceled_at":{"type":["string","null"],"format":"date-time"}}},"ai_extra_credits":{"type":"integer"},"price":{"type":"object","properties":{"currency":{"type":"string","enum":["USD"]},"monthly_amount_cents":{"type":"integer"},"yearly_amount_cents":{"type":"integer"}},"description":"Planın geçerli liste fiyatı (USD sent, vergiler dahil); ücretsiz planda 0. Mevcut abonelik, başladığı fiyattan yenilenebilir."},"manage_url":{"type":"string"}}},"WebhookOlayi":{"type":"string","enum":["message.received","message.sent","conversation.handoff","contact.created","contact.consent_changed","campaign.completed","post.published","miniapp.submission","miniapp.order_updated"],"description":"Webhook olay adı; teslim yükünde test için ping de gelebilir"},"EkipUyesi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"role":{"enum":["owner","admin","member"]},"bot_ids":{"type":["array","null"],"items":{"type":"string","format":"uuid"},"description":"Üye rolünde erişebildiği botlar; null: bütün botlar"},"created_at":{"type":"string","format":"date-time"}}},"EkipDaveti":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"role":{"enum":["admin","member"]},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"WebhookTeslimi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event":{"type":"string"},"status":{"enum":["pending","delivered","failed"]},"attempts":{"type":"integer"},"response_status":{"type":["integer","null"]},"error":{"type":["string","null"]},"delivered_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"ApiAnahtari":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"prefix":{"type":"string","description":"Anahtarın başı; anahtarın kendisi hiçbir yanıtta dönmez"},"scopes":{"type":"array","items":{"type":"string"}},"access_level":{"type":"string"},"last_used_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"BagliUygulama":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"last_used_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"ApiIstegi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"method":{"type":"string"},"path":{"type":"string","description":"Yol şablonu; kayıt kimlikleri {id} biçiminde yazılır"},"status":{"type":"integer"},"duration_ms":{"type":"integer"},"credential":{"type":"object","properties":{"type":{"enum":["api_key","oauth"]},"id":{"type":["string","null"],"format":"uuid"},"name":{"type":["string","null"],"description":"Anahtarın adı ve başı ya da OAuth uygulamasının adı; silinmişse null"}}},"created_at":{"type":"string","format":"date-time"}}},"ApiIstekOzeti":{"type":"object","properties":{"period_days":{"type":"integer"},"total":{"type":"integer"},"errors":{"type":"integer","description":"4xx ve 5xx yanıt sayısı"},"error_rate":{"type":"number","description":"errors / total (0–1); istek yoksa 0"},"p95_ms":{"type":["integer","null"],"description":"Yanıt süresinin 95. yüzdeliği (ms); istek yoksa null"},"requests":{"type":"array","items":{"$ref":"#/components/schemas/ApiIstegi"}}}},"CrmBaglantisi":{"type":"object","properties":{"platform":{"enum":["hubspot","pipedrive"]},"name":{"type":"string"},"status":{"enum":["aktif","hata"],"description":"hata: token geçersiz ya da yetkisi eksik; eşitleme durur"},"token_set":{"type":"boolean"},"company_domain":{"type":["string","null"]},"field_mapping":{"type":"object","properties":{"tag_field":{"type":["string","null"]},"email_field":{"type":["string","null"]},"order_as_deal":{"type":"boolean"},"deal_stage":{"type":["string","null"]},"note_language":{"enum":["tr","en"]}}},"last_sync_at":{"type":["string","null"],"format":"date-time"},"last_error":{"type":["string","null"],"description":"Hata kodu: token_gecersiz, izin_eksik, hiz_siniri, sunucu, ulasilamadi, bulunamadi, istek_reddedildi"},"last_error_message":{"type":["string","null"]},"last_error_at":{"type":["string","null"],"format":"date-time"},"pending_jobs":{"type":"integer"},"failed_jobs":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"TelegramKomutMenusu":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid"},"commands":{"type":"array","items":{"type":"object","properties":{"command":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"},"description":{"type":"string","minLength":1,"maxLength":256}}}}}},"BotOdemeAyari":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid"},"card_payments_enabled":{"type":"boolean","description":"Bot Telegram'a bağlı ve sağlayıcı token'ı kayıtlıysa true; Mini App'te kart fiyatlı ürünler kartla satılır"},"provider_token_set":{"type":"boolean"},"test_mode":{"type":["boolean","null"],"description":"Token test sağlayıcısına aitse (…:TEST:…) true; token yoksa null"},"refund_note":{"type":"string","description":"Kartlı ödemenin iadesi ödeme sağlayıcısının panelinden yapılır"}}},"UrunBeslemeSonucu":{"type":"object","properties":{"saved":{"type":"boolean","description":"false: dry_run önizlemesi, taslak değişmedi"},"format":{"enum":["xml","csv","json"]},"mapping":{"type":"object","description":"Katalog alanı → beslemedeki sütun ya da etiket adı","properties":{"id":{"type":"string"},"ad":{"type":"string"},"aciklama":{"type":"string"},"fiyat":{"type":"string"},"gorsel":{"type":"string"},"stok":{"type":"string"}}},"total":{"type":"integer","description":"Beslemedeki kullanılabilir (adlı, stokta, tekil) ürün sayısı"},"imported":{"type":"integer","description":"Kataloğa giren ürün sayısı (en fazla 50)"},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"enum":["kesildi","stok_yok","eksik","tekrar","kirpildi","cikarilacak"]},"count":{"type":"integer"},"message":{"type":"string"}}}},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"price":{"type":"string"},"image_url":{"type":"string"}}}},"feed":{"type":"object","properties":{"url":{"type":["string","null"]},"auto_refresh":{"type":"boolean"},"ai_knowledge":{"type":"boolean"},"synced_at":{"type":["string","null"],"format":"date-time"},"checked_at":{"type":["string","null"],"format":"date-time"},"error":{"type":["string","null"]}}}}},"YayinOnayi":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Bekleyen sürümün kimliği (bot sürümü ya da Mini App sürümü)"},"type":{"enum":["bot","miniapp"]},"target_id":{"type":"string","format":"uuid","description":"Bot ya da Mini App kimliği"},"target_name":{"type":"string"},"version":{"type":"integer"},"action":{"enum":["yapilandirma","geri_alma","arac_ekle","arac_guncelle","arac_durum","arac_sil","kaynak_ekle","kaynak_guncelle","kaynak_sil","yayin"]},"summary":{"type":"array","items":{"type":"string"},"description":"Değişen alan, araç ya da kaynak adları; içerik yer almaz"},"requested_by":{"type":["string","null"]},"requested_at":{"type":"string","format":"date-time"},"own_request":{"type":"boolean","description":"İstek bu kullanıcıya ait mi (dört göz açıkken kendisi onaylayamaz)"},"api_key_request":{"type":"boolean"}}},"YayinOnayiSonucu":{"type":"object","properties":{"status":{"enum":["approved","rejected"]},"signing_secret":{"type":["string","null"],"description":"Onayla eklenen özel aracın imza sırrı; yalnız bu yanıtta döner"},"tools_need_secret":{"type":"array","items":{"type":"string"},"description":"Gizli başlık değeri girilene kadar pasif kalan araçlar"}}},"TopluBotIslemi":{"type":"object","properties":{"action":{"enum":["pause","resume","update"]},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"unchanged":{"type":"integer"},"pending_approval":{"type":"integer"},"skipped":{"type":"integer"}}},"results":{"type":"array","items":{"type":"object","properties":{"bot_id":{"type":"string","description":"İstekteki kimlik (geçersiz biçimde olabilir; o zaman reason not_found)"},"name":{"type":["string","null"]},"status":{"enum":["succeeded","unchanged","pending_approval","skipped"]},"reason":{"type":["string","null"],"enum":["not_found","forbidden_role","plan_limit","not_connected","error",null],"description":"Atlanma nedeni"},"version":{"type":["integer","null"],"description":"Ayar değişikliğinde oluşan sürüm numarası (yayın onayı açıksa bekleyen sürüm)"}}}}}},"FiloDegerlendirmeBaslatma":{"type":"object","properties":{"dry_run":{"type":"boolean"},"responses_needed":{"type":"integer","description":"Sıraya girecek botların toplam vaka sayısı; her vaka bir AI yanıtı üretir"},"quota_left":{"type":["integer","null"],"description":"Bu ay kalan AI yanıtı; kendi AI anahtarıyla null (plan kotasından düşmez)"},"quota_enough":{"type":"boolean"},"key_set":{"type":"boolean"},"in_progress":{"type":"boolean","description":"Organizasyonda sırada ya da çalışan bir değerlendirme var"},"queued":{"type":"integer","description":"Sıraya alınan bot sayısı (dry_run'da girecek olan)"},"run_ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Sıraya alınan çalıştırmaların kimlikleri; dry_run'da boş"},"bots":{"type":"array","items":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"cases":{"type":"integer"},"skipped_reason":{"type":["string","null"],"enum":["no_cases","plan_limit",null]}}}}}},"FiloDegerlendirmeOzeti":{"type":"object","properties":{"in_progress":{"type":"boolean"},"queued":{"type":"integer"},"overview":{"type":"object","properties":{"bots":{"type":"integer"},"evaluated":{"type":"integer"},"average_pass_rate":{"type":["number","null"]},"improved":{"type":"integer"},"worsened":{"type":"integer"}}},"bots":{"type":"array","items":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"channel":{"type":"string"},"cases":{"type":"integer"},"status":{"type":["string","null"],"enum":["queued","running","completed","aborted",null],"description":"Son set çalıştırmasının durumu"},"last_run":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"finished_at":{"type":"string"},"summary":{"type":"object","properties":{"total":{"type":"integer"},"passed":{"type":"integer"},"failed":{"type":"integer"},"errored":{"type":"integer"},"not_run":{"type":"integer"}}},"pass_rate":{"type":["number","null"]}}},"previous_pass_rate":{"type":["number","null"]},"change":{"type":["number","null"],"description":"Önceki tamamlanmış koşuya göre başarı oranı farkı (yüzde puanı)"}}}}}},"RaporMaliyetIceAktarma":{"type":"object","properties":{"imported":{"type":"integer","description":"Yeni eklenen maliyet satırı"},"updated":{"type":"integer","description":"Aynı hedef, dönem ve para birimiyle önceden var olduğu için tutarı güncellenen satır"},"errors":{"type":"array","items":{"type":"object","properties":{"line":{"type":"integer","description":"CSV'de başlık 1 olmak üzere satır numarası; rows'ta dizideki sıra (1'den)"},"error":{"enum":["tur","hedef","tutar","birim","donem","hedef_yok","tekrar"],"description":"tur: kind geçersiz; hedef: ref boş; tutar; birim: para birimi; donem: tarih ya da sıra; hedef_yok: kampanya ya da bağlantı bulunamadı; tekrar: aynı satır dosyada iki kez"}}}},"total":{"type":"integer"}}},"OrgBotSablonu":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"channel":{"enum":["telegram","whatsapp"]},"knowledge_count":{"type":"integer"},"tool_count":{"type":"integer"},"created_by":{"type":["string","null"],"description":"Kaydeden kişinin adı"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"OrgBotSablonuAyrinti":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"channel":{"enum":["telegram","whatsapp"]},"knowledge_count":{"type":"integer"},"tool_count":{"type":"integer"},"created_by":{"type":["string","null"],"description":"Kaydeden kişinin adı"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"file":{"type":"object","description":"Bot dosyası (GET /api/v1/bots/{id}/export ile aynı biçim, sırsız)"}}},"OrgBotSablonuKaydi":{"type":"object","properties":{"template":{"$ref":"#/components/schemas/OrgBotSablonu"},"urls":{"type":"array","items":{"type":"object","properties":{"kind":{"enum":["tool","knowledge"]},"name":{"type":"string"},"url":{"type":"string"},"has_query":{"type":"boolean","description":"Sorgu dizgesi var; sır içerebilir"}}},"description":"Şablonda açıkça yer alan adresler"}}},"OrgSablondanBot":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"knowledge_count":{"type":"integer"},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"signing_secret":{"type":"string"}}},"description":"Yeni imza sırları yalnız bu yanıtta bir kez döner; araçlar kapalı gelir"}}},"BuyumeKampanyasi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"goal_contacts":{"type":"integer"},"starts_on":{"type":"string","format":"date"},"ends_on":{"type":"string","format":"date"},"budget":{"type":["object","null"],"properties":{"amount":{"type":"number"},"currency":{"type":"string"}}},"status":{"enum":["scheduled","active","ended"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"acquisition_links":{"type":"integer","description":"Yalnız listede: bağlı edinme bağlantısı"},"invite_links":{"type":"integer","description":"Yalnız listede: bağlı davet bağlantısı"},"new_contacts":{"type":"integer","description":"Yalnız listede: dönemde kazanılan yeni kişi"},"progress_percent":{"type":"number","description":"Yalnız listede: hedefe ilerleme (100'ü aşabilir)"}}},"BuyumeKampanyaRaporu":{"type":"object","properties":{"campaign":{"$ref":"#/components/schemas/BuyumeKampanyasi"},"range":{"type":["object","null"],"description":"Sayılan dönem; kampanya başlamadıysa null","properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"}}},"days_left":{"type":"integer"},"progress":{"type":"object","properties":{"new_contacts":{"type":"integer"},"goal_contacts":{"type":"integer"},"percent":{"type":"number"},"remaining":{"type":"integer"}}},"funnel":{"type":"object","properties":{"clicks":{"type":["integer","null"],"description":"Hiboty /g/<kod> izlenen gönderi düğmesi tıklamaları; izlenen düğme yoksa null (Telegram bağlantı tıklaması vermez)"},"starts":{"type":"integer","description":"Start parametresiyle gelen /start mesajları (bağlantının toplamı, mevcut kişiler dahil)"},"new_contacts":{"type":"integer","description":"Dönemde bağlantılarla kazanılan yeni kişi"},"activated_contacts":{"type":"integer","description":"Bu yeni kişilerden sipariş veren"},"orders":{"type":"integer"},"paid_orders":{"type":"integer"},"joins":{"type":"integer","description":"Davet bağlantılarıyla katılım (chat_member invite_link; bağlantının toplamı)"},"leaves":{"type":"integer"}}},"rates":{"type":"object","properties":{"contacts_per_start":{"type":["number","null"]},"activation":{"type":["number","null"]},"paid_per_order":{"type":["number","null"]},"member_retention":{"type":["number","null"]}}},"revenue":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"spend":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"mixed":{"type":["object","null"],"additionalProperties":{"type":"number"}}}},"cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"mixed":{"type":["object","null"],"additionalProperties":{"type":"number"}}}},"cost_source":{"type":["string","null"],"enum":["spend","budget",null],"description":"spend: bağlantı maliyetleri (elle + içe aktarılan), budget: kampanya bütçesi"},"budget_usage_percent":{"type":["number","null"]},"cost_per_contact":{"type":"object","properties":{"value":{"type":["number","null"]},"currency":{"type":["string","null"]},"reason":{"type":["string","null"],"enum":["maliyet_yok","kisi_yok",null]}}},"roi":{"type":"object","properties":{"value":{"type":["number","null"]},"reason":{"type":["string","null"],"enum":["maliyet_yok","maliyet_sifir","para_birimi",null]}}},"acquisition_links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["acquisition_link"]},"name":{"type":"string"},"code":{"type":"string"},"bot_id":{"type":"string","format":"uuid"},"bot_name":{"type":"string"},"url":{"type":["string","null"]},"clicks":{"type":["integer","null"]},"starts":{"type":"integer"},"new_contacts":{"type":"integer"},"activated_contacts":{"type":"integer"},"paid_orders":{"type":"integer"},"revenue":{"type":"object","properties":{"orders":{"type":"integer"},"cancelled":{"type":"integer"},"refunded":{"type":"integer"},"gross":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"net":{"type":"object","properties":{"amounts":{"type":"object","additionalProperties":{"type":"number"},"description":"Para birimine göre tutarlar; hiçbir zaman tek sayıda toplanmaz"},"stars":{"type":"integer"}}},"unpriced_items":{"type":"integer"}}},"cost":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"mixed":{"type":["object","null"],"additionalProperties":{"type":"number"}}}},"cost_per_contact":{"type":"object","properties":{"value":{"type":["number","null"]},"currency":{"type":["string","null"]},"reason":{"type":["string","null"],"enum":["maliyet_yok","kisi_yok",null]}}},"roi":{"type":"object","properties":{"value":{"type":["number","null"]},"reason":{"type":["string","null"],"enum":["maliyet_yok","maliyet_sifir","para_birimi",null]}}}}}},"invite_links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["invite_link"]},"name":{"type":"string"},"community_id":{"type":"string","format":"uuid"},"community_name":{"type":"string"},"invite_link":{"type":"string"},"joins":{"type":"integer"},"leaves":{"type":"integer"},"net_members":{"type":"integer"},"revoked":{"type":"boolean"},"expires_at":{"type":["string","null"],"format":"date-time"}}}},"truncated":{"type":"boolean"}}},"BuyumeKampanyaKaynagi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["acquisition_link","invite_link"]},"name":{"type":"string"},"code":{"type":["string","null"]},"url":{"type":["string","null"]}}},"WhatsAppHesabi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"waba_id":{"type":"string","description":"WhatsApp Business hesabı (WABA) kimliği"},"business_id":{"type":["string","null"],"description":"Meta işletme portföyü kimliği (Embedded Signup business_id ya da bağlarken verilen)"},"name":{"type":["string","null"],"description":"Meta'daki WABA adı (Graph name alanı)"},"display_name":{"type":"string"},"currency":{"type":["string","null"]},"timezone_id":{"type":["string","null"]},"embedded":{"type":"boolean"},"status":{"enum":["bagli","uyari","hata","bagli_degil"]},"access_token_set":{"type":"boolean"},"app_secret_set":{"type":"boolean"},"last_synced_at":{"type":["string","null"],"format":"date-time"},"last_error":{"type":["string","null"]},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid"},"bot_name":{"type":"string"},"bot_status":{"type":"string"},"display_phone":{"type":["string","null"]},"phone_number_id":{"type":["string","null"]},"quality":{"enum":["GREEN","YELLOW","RED","UNKNOWN",null]},"messaging_limit":{"type":["string","null"]},"delivery_score":{"type":["integer","null"]},"last_webhook_at":{"type":["string","null"],"format":"date-time"},"last_error":{"type":["string","null"]}}}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"WhatsAppHesapSablonu":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"language":{"type":"string"},"category":{"type":["string","null"]},"status":{"type":["string","null"]},"body":{"type":"string"},"rejected_reason":{"type":["string","null"]}}},"Baglanti":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Kaynak kaydın kimliği (bot, WhatsApp hesabı, mağaza, CRM, araç, webhook, OAuth istemcisi ya da Mini App)"},"kind":{"enum":["telegram_bot","whatsapp_number","whatsapp_account","store","crm","ai_tool","webhook","oauth_app","product_feed"]},"name":{"type":"string"},"detail":{"type":["string","null"],"description":"Sırsız tanıtıcı: @kullanıcı adı, görünen telefon, WABA kimliği ya da adresin yalnız alan adı"},"status":{"enum":["bagli","uyari","hata","kapali","bagli_degil"]},"bot_id":{"type":["string","null"],"format":"uuid"},"bot_name":{"type":["string","null"]},"last_event_at":{"type":["string","null"],"format":"date-time"},"last_error":{"type":["string","null"]},"panel_path":{"type":"string","description":"Bağlantının panelde yönetildiği sayfa"}}},"BotAyrinti":{"type":"object","required":["id","name","channel","status","connected"],"description":"Jeton, App Secret, webhook sırrı ve doğrulama jetonu bu görünümde yoktur.","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"channel":{"$ref":"#/components/schemas/Kanal"},"status":{"enum":["draft","active","paused","error"]},"connected":{"type":"boolean","description":"Kanal jetonu kayıtlı mı"},"persona":{"type":"string"},"welcome_message":{"type":"string"},"handoff_keyword":{"type":"string"},"ai_enabled":{"type":"boolean"},"voice_transcription":{"type":"boolean"},"image_understanding":{"type":"boolean"},"ai_tools":{"type":"boolean"},"voice_reply":{"enum":["kapali","sesliye_sesli","her_zaman"],"description":"Sesli yanıt (TTS): kapali, sesliye_sesli (sesli mesaja sesli yanıt) ya da her_zaman. OpenAI anahtarı yoksa uygulanmaz, yanıt metin gider."},"reply_language":{"enum":["tr","en","de","fr","es","it","pt","nl","ru","ar","az",null],"description":"Sabit yanıt dili; null ise bot müşterinin dilinde yanıt verir (otomatik)."},"appointment_tool":{"type":"boolean","description":"AI randevu talebi aracı (randevu_talebi) açık mı; talep botun Mini App'ine kind=randevu olarak kaydedilir."},"cancel_request_tool":{"type":"boolean","description":"AI sipariş iptal talebi aracı (siparis_iptal_talebi) açık mı; yalnız yeni siparişe kind=iptal_talebi kaydı açar, iptal/iade yapmaz."},"show_source_links":{"type":"boolean","description":"AI yanıtı URL bilgi kaynağına dayanıyorsa müşteriye giden yanıtın sonuna kaynak bağlantısı eklenir."},"telegram_username":{"type":["string","null"]},"whatsapp_phone":{"type":["string","null"]},"whatsapp_phone_number_id":{"type":["string","null"]},"whatsapp_business_account_id":{"type":["string","null"]},"whatsapp_embedded":{"type":"boolean"},"whatsapp_app_secret_set":{"type":"boolean"},"webhook_url":{"type":["string","null"],"description":"Elle kurulan WhatsApp webhook'u için geri çağırma adresi"},"webhook_verified_at":{"type":["string","null"],"format":"date-time"},"last_webhook_at":{"type":["string","null"],"format":"date-time"},"last_error":{"type":["string","null"]},"whatsapp_quality":{"enum":["GREEN","YELLOW","RED","UNKNOWN",null],"description":"WhatsApp numara kalite puanı (Meta quality_rating); günde bir ve phone_number_quality_update olayıyla güncellenir. RED iken kampanya başlamaz."},"whatsapp_messaging_limit":{"type":["string","null"],"description":"Mesajlaşma sınırı (TIER_250, TIER_2K, TIER_10K, TIER_100K, TIER_UNLIMITED …)"},"whatsapp_quality_at":{"type":["string","null"],"format":"date-time"},"delivery_score":{"type":["integer","null"],"minimum":0,"maximum":100,"description":"Son 30 günün teslim, okunma, hata, engelleme ve izin kapatma oranlarından teslim edilebilirlik puanı; veri azsa null"},"delivery_score_reasons":{"type":"array","items":{"enum":["veri_az","hata_yuksek","engel_yuksek","optout_yuksek","teslim_dusuk","okunma_dusuk","kalite_sari","kalite_kirmizi"]},"description":"Puanı düşüren nedenler"},"delivery_score_at":{"type":["string","null"],"format":"date-time"},"whatsapp_account_id":{"type":["string","null"],"format":"uuid","description":"Numaranın bağlı olduğu WhatsApp hesabı (WABA) kaydı (getWhatsAppAccount)"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"BotOlustur":{"type":"object","required":["name","channel"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":80},"channel":{"$ref":"#/components/schemas/Kanal"},"template":{"enum":["eticaret","restoran","randevu","egitim","destek","guzellik","klinik","emlak","otel","otomotiv","etkinlik","spor"],"description":"Galeri şablonu (listBotTemplates)"},"language":{"enum":["tr","en"],"description":"Şablon ve SSS dili; verilmezse isteğin dili"},"faqs":{"type":"array","maxItems":10,"description":"Verilirse şablonun SSS'lerinin yerine geçer","items":{"type":"object","required":["question","answer"],"additionalProperties":false,"properties":{"question":{"type":"string","minLength":2,"maxLength":160},"answer":{"type":"string","minLength":1,"maxLength":2000}}}},"persona":{"type":"string","maxLength":6000},"welcome_message":{"type":"string","maxLength":1000},"handoff_keyword":{"type":"string","minLength":2,"maxLength":40},"ai_enabled":{"type":"boolean","default":true},"voice_transcription":{"type":"boolean","default":false},"image_understanding":{"type":"boolean","default":false},"ai_tools":{"type":"boolean","default":true}}},"BotGuncelle":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":2,"maxLength":80},"persona":{"type":"string","maxLength":6000},"welcome_message":{"type":"string","maxLength":1000},"handoff_keyword":{"type":"string","minLength":2,"maxLength":40},"ai_enabled":{"type":"boolean"},"voice_transcription":{"type":"boolean"},"image_understanding":{"type":"boolean"},"ai_tools":{"type":"boolean"},"voice_reply":{"enum":["kapali","sesliye_sesli","her_zaman"],"description":"Sesli yanıt (TTS) ayarı; sürüm geçmişine girmez."},"reply_language":{"enum":["tr","en","de","fr","es","it","pt","nl","ru","ar","az",null],"description":"Sabit yanıt dili; null otomatik. Sürüm geçmişine girmez."},"appointment_tool":{"type":"boolean","description":"Randevu talebi aracı; sürüm geçmişine girmez."},"cancel_request_tool":{"type":"boolean","description":"Sipariş iptal talebi aracı; sürüm geçmişine girmez."},"show_source_links":{"type":"boolean","description":"Müşteriye kaynak bağlantısı gösterme; sürüm geçmişine girmez."}}},"BotBagla":{"type":"object","additionalProperties":false,"description":"Telegram botunda yalnız token; WhatsApp botunda phone_number_id, business_account_id, access_token (App Secret kayıtlı değilse app_secret de).","properties":{"token":{"type":"string","description":"BotFather jetonu"},"phone_number_id":{"type":"string","pattern":"^\\d{5,}$"},"business_account_id":{"type":"string","pattern":"^\\d{5,}$"},"access_token":{"type":"string","minLength":20},"app_secret":{"type":"string"},"webhook_verify_token":{"type":"string","minLength":16,"maxLength":128,"description":"Meta webhook doğrulaması için seçtiğiniz değer; hiçbir yanıtta dönmez"},"business_id":{"type":"string","pattern":"^d{5,30}$","description":"İsteğe bağlı Meta işletme portföyü kimliği; WhatsApp hesabı (WABA) kaydına yazılır"}}},"BotSablonu":{"type":"object","properties":{"code":{"type":"string"},"sector":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"persona":{"type":"string"},"welcome_message":{"type":"string"},"handoff_keyword":{"type":"string"},"faqs":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"}}}}}},"BotTaslagi":{"type":"object","properties":{"persona":{"type":"string"},"welcome_message":{"type":"string"},"faqs":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"}}}},"website_error":{"type":["string","null"]}}},"BotDosyasiGirdisi":{"type":"object","required":["file"],"additionalProperties":false,"properties":{"file":{"type":["object","string"],"additionalProperties":true,"description":"exportBot'un döndürdüğü dosya (nesne ya da JSON metni), en fazla 512 KB"}}},"BilgiKaynagi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"type":{"enum":["text","faq","url"]},"title":{"type":"string"},"length":{"type":"integer"},"url":{"type":["string","null"]},"status":{"type":"string"},"freshness":{"enum":["taze","eskidi","hata","gozden_gecir"]},"last_error":{"type":["string","null"]},"fetched_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"BilgiKaynagiAyrinti":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"type":{"enum":["text","faq","url"]},"title":{"type":"string"},"length":{"type":"integer"},"url":{"type":["string","null"]},"status":{"type":"string"},"freshness":{"enum":["taze","eskidi","hata","gozden_gecir"]},"last_error":{"type":["string","null"]},"fetched_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"content":{"type":"string"},"question":{"type":["string","null"]},"answer":{"type":["string","null"]},"changed":{"type":"boolean"}}},"BilgiKaynagiOlustur":{"type":"object","required":["type","title"],"additionalProperties":false,"properties":{"type":{"enum":["text","faq","url","file"]},"title":{"type":"string","minLength":2,"maxLength":160},"content":{"type":"string","minLength":10,"maxLength":60000,"description":"type=text"},"question":{"type":"string","maxLength":500,"description":"type=faq"},"answer":{"type":"string","maxLength":5000,"description":"type=faq"},"url":{"type":"string","format":"uri","maxLength":2000,"description":"type=url; herkese açık http/https sayfa"},"file_name":{"type":"string","maxLength":200,"description":"type=file; txt, md, csv, tsv, json, html"},"file_base64":{"type":"string","description":"type=file; UTF-8 metin dosyasının base64 içeriği, en fazla 256 KB"}}},"OzelAracAlani":{"type":"object","required":["name","type"],"additionalProperties":false,"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$"},"type":{"enum":["string","number","boolean","enum"]},"required":{"type":"boolean","default":false},"description":{"type":"string","maxLength":300},"options":{"type":"array","maxItems":20,"items":{"type":"string"}}}},"OzelArac":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/OzelAracAlani"}},"url":{"type":["string","null"],"description":"Yalnız yönetici görür"},"host":{"type":"string"},"secret_header_name":{"type":["string","null"]},"enabled":{"type":"boolean"},"last_called_at":{"type":["string","null"],"format":"date-time"},"last_status":{"type":["integer","null"]},"signing_secret":{"type":"string"}}},"OzelAracOlustur":{"type":"object","required":["name","description","url"],"additionalProperties":false,"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,40}$"},"description":{"type":"string","minLength":10,"maxLength":1000},"fields":{"type":"array","maxItems":12,"items":{"$ref":"#/components/schemas/OzelAracAlani"}},"url":{"type":"string","format":"uri","description":"Herkese açık https adresi"},"secret_header_name":{"type":"string","maxLength":60},"secret_header_value":{"type":"string","maxLength":2000},"enabled":{"type":"boolean","default":true}}},"OzelAracGuncelle":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string"},"description":{"type":"string"},"fields":{"type":"array","maxItems":12,"items":{"$ref":"#/components/schemas/OzelAracAlani"}},"url":{"type":"string","format":"uri"},"secret_header_name":{"type":"string"},"secret_header_value":{"type":"string"},"remove_secret_header":{"type":"boolean"},"enabled":{"type":"boolean"}}},"AlanFarki":{"type":"object","properties":{"field":{"type":"string"},"before":{"type":["string","boolean"]},"after":{"type":["string","boolean"]}}},"BotSurumu":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"source":{"enum":["panel","api","geri_alma"]},"restored_from_version":{"type":["integer","null"]},"readable":{"type":"boolean"},"changes":{"type":"array","items":{"$ref":"#/components/schemas/AlanFarki"}},"truncated":{"type":"boolean"},"tools_changed":{"type":"boolean"},"sources_changed":{"type":"boolean"},"tool_changes":{"type":"array","items":{"$ref":"#/components/schemas/AracDegisimi"}},"source_changes":{"type":"array","items":{"$ref":"#/components/schemas/KaynakDegisimi"}}}},"AracDegisimi":{"type":"object","properties":{"name":{"type":"string"},"change":{"enum":["eklendi","silindi","degisti"]}}},"KaynakDegisimi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"change":{"enum":["eklendi","silindi","degisti"]}}},"BotSurumAyrinti":{"type":"object","properties":{"version":{"type":"integer"},"changes":{"type":"array","items":{"$ref":"#/components/schemas/AlanFarki"}},"restore":{"type":["object","null"],"properties":{"available":{"type":"boolean"},"changes":{"type":"array","items":{"$ref":"#/components/schemas/AlanFarki"}},"skipped_fields":{"type":"array","items":{"type":"string"}},"restore_token":{"type":["string","null"]},"reason":{"type":["string","null"]},"tool_changes":{"type":"array","items":{"$ref":"#/components/schemas/AracDegisimi"}},"changed_sources":{"type":"array","items":{"$ref":"#/components/schemas/KaynakDegisimi"}},"tools_need_secret":{"type":"array","items":{"type":"string"}}}},"tool_changes":{"type":"array","items":{"$ref":"#/components/schemas/AracDegisimi"}},"source_changes":{"type":"array","items":{"$ref":"#/components/schemas/KaynakDegisimi"}}}},"TelegramVitrinDili":{"type":"object","required":["name","short_description","description"],"additionalProperties":false,"properties":{"name":{"type":"string","maxLength":64},"short_description":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":512}}},"BotVitrini":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Kanal"},"tr":{"$ref":"#/components/schemas/TelegramVitrinDili"},"en":{"$ref":"#/components/schemas/TelegramVitrinDili"},"about":{"type":"string"},"description":{"type":"string"},"vertical":{"type":"string"},"website":{"type":["string","null"]}}},"BotVitrinGuncelle":{"type":"object","additionalProperties":false,"properties":{"tr":{"$ref":"#/components/schemas/TelegramVitrinDili"},"en":{"$ref":"#/components/schemas/TelegramVitrinDili"},"about":{"type":"string","maxLength":139},"description":{"type":"string","maxLength":512},"vertical":{"type":"string"},"website":{"type":"string","maxLength":256}}},"DegerlendirmeVakasi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"question":{"type":"string"},"must_include":{"type":"array","items":{"type":"string"}},"must_not_include":{"type":"array","items":{"type":"string"}},"expect_handoff":{"type":"boolean"}}},"DegerlendirmeVakasiGirdisi":{"type":"object","required":["question"],"additionalProperties":false,"description":"En az bir beklenti gerekir.","properties":{"question":{"type":"string","minLength":2,"maxLength":1000},"must_include":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":200}},"must_not_include":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":200}},"expect_handoff":{"type":"boolean","default":false}}},"DegerlendirmeOzeti":{"type":"object","properties":{"total":{"type":"integer"},"passed":{"type":"integer"},"failed":{"type":"integer"},"errored":{"type":"integer"},"not_run":{"type":"integer"}}},"DegerlendirmeCalistirma":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["cases","security"]},"status":{"type":"string"},"started_at":{"type":"string"},"finished_at":{"type":["string","null"]},"model":{"type":["string","null"]},"summary":{"$ref":"#/components/schemas/DegerlendirmeOzeti"}}},"DegerlendirmeAyrinti":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["cases","security"]},"status":{"type":"string"},"started_at":{"type":"string"},"finished_at":{"type":["string","null"]},"model":{"type":["string","null"]},"summary":{"$ref":"#/components/schemas/DegerlendirmeOzeti"},"comparison":{"type":["object","null"],"properties":{"improved":{"type":"integer"},"worsened":{"type":"integer"},"added":{"type":"integer"},"removed":{"type":"integer"}}},"results":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"question":{"type":"string"},"status":{"type":"string"},"reply":{"type":"string"},"handed_off":{"type":"boolean"},"refused":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"object","additionalProperties":true}},"error":{"type":["string","null"]},"change":{"type":["string","null"]}}}}}},"EdinmeBaglantisi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"code":{"type":"string"},"prefill_text":{"type":"string"},"url":{"type":["string","null"]},"starts":{"type":"integer"},"new_contacts":{"type":"integer"},"orders":{"type":"integer"},"last_start_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"WhatsAppSablonu":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"language":{"type":"string"},"category":{"type":["string","null"]},"status":{"type":["string","null"]},"body":{"type":"string"},"rejected_reason":{"type":["string","null"]}}},"WhatsAppSablonuOlustur":{"type":"object","required":["name","category","language","body"],"additionalProperties":false,"properties":{"name":{"type":"string","pattern":"^[a-z0-9_]+$","maxLength":512},"category":{"enum":["MARKETING","UTILITY"]},"language":{"type":"string","examples":["tr"]},"header":{"type":"string","maxLength":60},"body":{"type":"string","minLength":1,"maxLength":1024,"description":"{{1}}, {{2}} değişkenleri sırayla"},"examples":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":200},"description":"Her değişken için örnek"},"footer":{"type":"string","maxLength":60},"buttons":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true,"properties":{"type":{"enum":["quick_reply","url"]},"text":{"type":"string","maxLength":25},"url":{"type":"string","description":"type=url için https:// adresi"}}}}}},"AiGeriBildirim":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"conversation_id":{"type":"string","format":"uuid"},"question":{"type":["string","null"]},"reply":{"type":"string"},"note":{"type":["string","null"]},"created_at":{"type":["string","null"],"format":"date-time"}}},"Kampanya":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string"},"body":{"type":"string"},"template_name":{"type":["string","null"]},"topic":{"type":["string","null"]},"audience_count":{"type":"integer"},"sent_count":{"type":"integer"},"failed_count":{"type":"integer"},"scheduled_at":{"type":["string","null"],"format":"date-time"},"started_at":{"type":["string","null"],"format":"date-time"},"completed_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"best_time":{"type":"boolean","description":"En iyi saatte otomatik planlandı"},"paused_at":{"type":["string","null"],"format":"date-time"},"pause_reason":{"enum":["hata_orani","kalite_red",null],"description":"Otomatik duraklatma: hata_orani (ilk 200 alıcıdan sonra hata oranı %20'yi aştı; panelden devam ettirilir) ya da kalite_red (WhatsApp kalitesi düzelince kendiliğinden sürer)"}}},"KampanyaAyrinti":{"allOf":[{"$ref":"#/components/schemas/Kampanya"},{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"variant":{"type":"string"},"audience":{"type":"integer"},"sent":{"type":"integer"},"failed":{"type":"integer"},"replied":{"type":"integer"}}}}}}]},"KampanyaOlustur":{"type":"object","required":["bot_id","name"],"additionalProperties":false,"description":"body ya da template alanlarından tam olarak biri gerekir.","properties":{"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":2,"maxLength":120},"body":{"type":"string","minLength":5,"maxLength":4000,"description":"Telegram metni; {{ad}}, {{tercihler}} değişkenleri kullanılabilir"},"body_b":{"type":"string","minLength":5,"maxLength":4000,"description":"Telegram A/B testi için ikinci metin"},"media_url":{"type":"string","maxLength":500,"description":"Telegram görseli (https ya da yükleme adresi)"},"template":{"type":"object","required":["name","language"],"additionalProperties":false,"description":"WhatsApp onaylı şablonu; params_b ile A/B testi","properties":{"name":{"type":"string"},"language":{"type":"string"},"params":{"type":"array","items":{"type":"string"}},"params_b":{"type":"array","items":{"type":"string"}}}},"topic":{"type":"string","description":"Konu: duyuru, firsat, bilgilendirme, etkinlik, yeni_urun"},"scheduled_at":{"type":"string","format":"date-time","description":"İleri tarihli gönderim"},"best_time":{"type":"boolean","description":"En iyi saatte gönder: zaman botun geçmiş etkileşiminden, organizasyon saat dilimi, sessiz saat ve mesai kurallarıyla seçilir. scheduled_at ile birlikte verilemez; öneri yoksa 409 best_time_unavailable."},"segment":{"$ref":"#/components/schemas/KampanyaSegmenti"}}},"KampanyaSegmenti":{"type":"object","additionalProperties":false,"description":"Kitle süzgeci; koşullar VE ile birleşir. Alan yoksa ya da {} ise botun tüm izinli kişileri seçilir. Bilinmeyen alan, geçersiz değer ya da içi boş süzgeç 400 döner; uyan kişi yoksa 409 empty_audience döner, kampanya tüm kitleye düşmez.","properties":{"include_tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":32},"description":"Bu etiketlere göre dahil et (büyük/küçük harf duyarsız)"},"exclude_tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":32},"description":"Bu etiketlerden biri olanı çıkar"},"match":{"enum":["any","all"],"default":"any","description":"include_tags: herhangi biri (any) ya da hepsi (all)"},"last_seen":{"type":"object","additionalProperties":false,"minProperties":1,"maxProperties":1,"description":"Tam olarak biri: within_days (son N gün içinde görülen) ya da older_than_days (N günden uzun süredir görülmeyen, hiç görülmemiş dahil)","properties":{"within_days":{"type":"integer","minimum":1,"maximum":3650},"older_than_days":{"type":"integer","minimum":1,"maximum":3650}}},"order":{"enum":["placed","none"],"description":"Mini App siparişi vermiş (placed) ya da vermemiş (none)"},"source":{"type":"array","maxItems":20,"items":{"type":"string"},"description":"Edinme kaynağı kodlarından herhangi biri; \"-\" bağlantısız gelenleri seçer"},"fields":{"type":"array","maxItems":5,"description":"Özel alan koşulları (hepsi sağlanmalı)","items":{"type":"object","required":["key","type","op"],"additionalProperties":false,"properties":{"key":{"type":"string","description":"Özel alan anahtarı"},"type":{"enum":["text","number","date","choice"]},"op":{"enum":["exists","empty","eq","neq","gt","lt","contains"],"description":"gt/lt yalnız number ve date, contains yalnız text ile"},"value":{"type":["string","number"],"description":"exists ve empty dışında gerekli"}}}}}},"MiniApp":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"template":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"MiniAppGonderimi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["form","order","randevu","iptal_talebi"]},"status":{"type":"string"},"contact_id":{"type":["string","null"],"format":"uuid"},"user_name":{"type":["string","null"]},"data":{"type":"object"},"source":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"}}},"Otomasyon":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"trigger":{"type":"string"},"active":{"type":"boolean"},"run_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"Sablon":{"type":"object","properties":{"name":{"type":"string"},"language":{"type":"string"},"category":{"type":["string","null"]},"parameter_count":{"type":"integer"},"body":{"type":"string","description":"Şablon gövdesi"},"header_parameter":{"type":"boolean","description":"Başlıkta parametre var"}}},"Webhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string"},"description":{"type":"string"},"events":{"type":"array","items":{"$ref":"#/components/schemas/WebhookOlayi"}},"active":{"type":"boolean"},"failure_count":{"type":"integer"},"last_status":{"type":["integer","null"]},"last_delivery_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"Kullanim":{"type":"object","properties":{"plan":{"type":"string"},"messages":{"type":"object","description":"limit ek mesaj bakiyesi dahil bu ayın gerçek sınırıdır; plan_limit planın kotası, extra_credits kalan ek mesaj bakiyesi (plan kotası bitince kullanılır)","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"plan_limit":{"type":"integer"},"extra_credits":{"type":"integer"}}},"ai_replies":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"}}},"storage":{"type":"object","description":"Medya kütüphanesinin toplam boyutu ve plan depolama kotası (bayt); kota dolunca uploadMedia 413 storage_quota_exceeded döner","properties":{"used_bytes":{"type":"integer"},"limit_bytes":{"type":"integer"}}}}},"Hata":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","examples":["validation_error","unauthorized","scope","plan_limit","forbidden_role","not_found","rate_limited","not_connected","already_connected","invalid_credentials","channel_error","ai_not_configured","ai_quota_exceeded","stale_version","source_fetch_failed","idempotency_conflict","idempotency_in_progress"]},"message":{"type":"string"}}}}},"Izin":{"enum":["opted_in","opted_out","unknown"]},"SohbetDurumu":{"enum":["open","handoff","closed"]},"Kanal":{"enum":["telegram","whatsapp"]},"Bot":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"channel":{"$ref":"#/components/schemas/Kanal"},"status":{"type":"string"},"telegram_username":{"type":["string","null"]},"whatsapp_phone":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"}}},"Kisi":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"channel":{"$ref":"#/components/schemas/Kanal"},"external_id":{"type":"string","description":"Telegram chat id ya da WhatsApp numarası"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"phone":{"type":["string","null"]},"consent":{"$ref":"#/components/schemas/Izin"},"acquisition_source":{"type":["string","null"]},"attributes":{"$ref":"#/components/schemas/OzelAlanlar"},"last_seen_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"}}},"KisiAyrinti":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"channel":{"$ref":"#/components/schemas/Kanal"},"external_id":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"phone":{"type":["string","null"]},"consent":{"$ref":"#/components/schemas/Izin"},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"attributes":{"$ref":"#/components/schemas/OzelAlanlar"},"last_seen_at":{"type":["string","null"],"format":"date-time"}}},"OzelAlanlar":{"type":"object","description":"Özel alan anahtarı → değer (metin, sayı, YYYY-MM-DD tarih ya da seçenek)","additionalProperties":{"type":["string","number"]}},"KisiGuncelle":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":["string","null"],"maxLength":120},"notes":{"type":["string","null"],"maxLength":4000},"tags":{"$ref":"#/components/schemas/EtiketListesi"},"add_tags":{"$ref":"#/components/schemas/EtiketListesi"},"remove_tags":{"$ref":"#/components/schemas/EtiketListesi"},"attributes":{"type":"object","maxProperties":30,"additionalProperties":{"type":["string","number","null"]}}}},"EtiketListesi":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":32}},"IzinDurumu":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"consent":{"$ref":"#/components/schemas/Izin"},"source":{"type":["string","null"],"description":"Son değişikliğin kaynağı (ilk_mesaj, cikis_kelimesi, api, tercih_sayfasi …)"},"history":{"type":"array","items":{"type":"object","properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"source":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}}}}},"Sohbet":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"bot_id":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/SohbetDurumu"},"unread_count":{"type":"integer"},"last_message_preview":{"type":["string","null"]},"last_message_at":{"type":["string","null"],"format":"date-time"},"contact":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"external_id":{"type":"string"},"name":{"type":["string","null"]},"channel":{"$ref":"#/components/schemas/Kanal"},"consent":{"$ref":"#/components/schemas/Izin"}}}}},"Mesaj":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"direction":{"enum":["in","out"]},"sender":{"type":"string","description":"contact, bot, agent, api, system …"},"body":{"type":"string"},"status":{"type":"string"},"external_id":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"ai_sources":{"type":["array","null"],"description":"AI yanıtının dayandığı bilgi kaynağı parçaları; null: atıf kaydı yok (AI dışı ya da eski mesaj), boş dizi: kaynak dışı yanıt.","items":{"type":"object","required":["id","title","chunk","url"],"properties":{"id":{"type":["string","null"],"format":"uuid"},"title":{"type":"string"},"chunk":{"type":"integer","description":"Kaynaktaki parça sırası (0'dan)"},"url":{"type":["string","null"],"description":"URL kaynağının adresi"}}}}}},"MesajGonder":{"type":"object","required":["bot_id","to"],"additionalProperties":false,"properties":{"bot_id":{"type":"string","format":"uuid"},"to":{"type":"string","minLength":3,"maxLength":64,"description":"Telegram chat id ya da WhatsApp numarası (kişi daha önce bota yazmış olmalı)"},"message":{"type":"string","minLength":1,"maxLength":4000},"template":{"type":"object","required":["name","language"],"additionalProperties":false,"properties":{"name":{"type":"string"},"language":{"type":"string","examples":["tr"]},"params":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":1024},"description":"{{isim}} ve {{özel_alan}} değişkenleri kişiye göre doldurulur"}}}},"oneOf":[{"required":["message"]},{"required":["template"]}]}},"responses":{"Dogrulama":{"description":"Geçersiz istek (validation_error); bilinmeyen alan adı mesajda belirtilir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"Yetkisiz":{"description":"API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized)","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"Yasak":{"description":"Kapsam yok (scope), plan izin vermiyor ya da bot sınırı dolu (plan_limit), rol yetmiyor (forbidden_role), kişi izin vermemiş ya da organizasyon askıda","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"Bulunamadi":{"description":"Kayıt bulunamadı","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"Cakisma":{"description":"İşlem bu durumda yapılamaz: bot aktif değil, kanal bağlantısı eksik (not_connected), kanal başka bota bağlı (already_connected), AI anahtarı yok (ai_not_configured), geri alma önizlemesi bayat (stale_version), kitle boş (empty_audience), kampanya bitmiş, sınır dolu ya da Idempotency-Key çakışması (idempotency_conflict, idempotency_in_progress)","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"IcerikPolitikasi":{"description":"İçerik organizasyonun kural tabanlı içerik politikasına takıldı (content_policy); mesaj ifadeyi ve alanı belirtir","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"KanalHatasi":{"description":"Telegram/WhatsApp isteği başarısız (channel_error) ya da AI sağlayıcısı yanıt üretemedi (ai_error)","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"DepolamaKotasi":{"description":"Plan depolama kotası dolu (storage_quota_exceeded); görsel silinince ya da plan yükselince yükleme açılır","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"HizSiniri":{"description":"İstek sınırı (rate_limited), aylık mesaj kotası (message_quota_exceeded) ya da AI kotası (ai_quota_exceeded) aşıldı. rate_limited katmanları: anahtar başına dakikalık, OAuth kullanıcısı başına dakikalık, organizasyonun bütün anahtarları için plana göre dakikalık ve günlük (UTC) toplam. 429'da X-RateLimit-* aşılan katmanın değerlerini taşır, X-RateLimit-Scope katmanı söyler","headers":{"X-RateLimit-Limit":{"description":"Dakikalık istek sınırı","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Penceredeki kalan istek","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (Unix saniye)","schema":{"type":"integer"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye; aylık kotada ayın sıfırlanmasına kalan süre","schema":{"type":"integer"}},"X-RateLimit-Scope":{"description":"Aşılan hız katmanı: key, user, organization (dakikalık) ya da organization_day (günlük)","schema":{"type":"string","enum":["key","user","organization","organization_day"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}}