{"openapi":"3.0.0","paths":{"/integrations/external-consent/{clientKey}/consents":{"post":{"description":"Bir olay (`externalEventId`) 1–50 karar içerir. Aynı `Idempotency-Key` (yoksa `externalEventId`) + aynı gövde güvenle yeniden gönderilebilir (saklı sonuç döner); aynı anahtar + farklı gövde 409'dur. Her karar için sonuç `APPLIED` / `DUPLICATE` / `REJECTED(code)` olarak döner. ETK kararları commit sonrası İYS kuyruğuna alınır; KVKK gitmez. İmza: `X-Rizaal-Signature: v1=<hex HMAC-SHA256(secret, timestamp + \".\" + rawBody)>`.","operationId":"ExternalConsentIngestController_ingest","parameters":[{"name":"idempotency-key","required":true,"in":"header","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","description":"Opsiyonel; yoksa `externalEventId` kullanılır. 191 karakterden uzun anahtarlar reddedilmez, SHA-256 ile kısaltılır.","required":false,"schema":{"type":"string"}},{"name":"X-Rizaal-Signature","in":"header","description":"`v1=<hex>` HMAC-SHA256 imzası (ham gövde üzerinde).","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Timestamp","in":"header","description":"Unix saniye; ±300 sn tolerans.","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Api-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"`Bearer <API anahtarı>` (alternatif: X-Rizaal-Api-Key).","required":false,"schema":{"type":"string"}},{"name":"clientKey","required":true,"in":"path","schema":{"example":"ai-connect"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentEventDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentIngestResponseDto"}}}},"400":{"description":"Geçersiz gövde (örn. method geçersiz/eksik, offset'siz decidedAt)."},"401":{"description":"Kimlik doğrulama başarısız."},"402":{"description":"MODULE_NOT_IN_PLAN: doğrudan (`direct`) bağlantıda şirketin paketinde API Erişimi modülü yok."},"409":{"description":"IDEMPOTENCY_CONFLICT: aynı anahtar farklı gövdeyle."},"413":{"description":"Gövde 256 KB'ı aşıyor."},"422":{"description":"CUSTOMER_MISMATCH: müşteri kimliği bağlantıyla eşleşmiyor."},"429":{"description":"İstek limiti aşıldı."},"503":{"description":"Rıza kanıt altyapısı hazır değil (kanıtsız kabul yok)."}},"summary":"Tek olay: dış sistemde alınan KVKK/ETK kararlarını bildir","tags":["External Consent"]}},"/integrations/external-consent/{clientKey}/consents/batch":{"post":{"description":"Her olay kendi `externalEventId`'siyle ayrı idempotent işlenir; bir olayın hatası (CUSTOMER_MISMATCH, IDEMPOTENCY_CONFLICT) yalnız o olayın `error` alanında döner. `Idempotency-Key` verilirse her olayın anahtarı `<key>:<externalEventId>` olur.","operationId":"ExternalConsentIngestController_ingestBatch","parameters":[{"name":"idempotency-key","required":true,"in":"header","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Rizaal-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Timestamp","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Api-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"clientKey","required":true,"in":"path","schema":{"example":"ai-connect"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentBatchDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentBatchResponseDto"}}}},"400":{"description":"Geçersiz gövde / 100'den fazla olay."},"401":{"description":"Kimlik doğrulama başarısız."},"402":{"description":"MODULE_NOT_IN_PLAN: doğrudan (`direct`) bağlantıda şirketin paketinde API Erişimi modülü yok."},"409":{"description":"IDEMPOTENCY_CONFLICT (olay düzeyinde)."},"413":{"description":"Gövde 256 KB'ı aşıyor."},"422":{"description":"CUSTOMER_MISMATCH (olay düzeyinde)."},"429":{"description":"İstek limiti aşıldı."},"503":{"description":"Rıza kanıt altyapısı hazır değil."}},"summary":"Toplu: en çok 100 olay, sonuçlar olay bazlı","tags":["External Consent"]}},"/integrations/external-consent/{clientKey}/consents/query":{"post":{"description":"Gövdedeki `phone` veya `email` ile şirket kapsamında kişi bulunur (PII URL'de dolaşmaz); telefon/e-posta yanıtta DÖNMEZ. İmza diğer POST uçlarıyla aynıdır (ham gövde). Birden çok kişi eşleşirse 422 AMBIGUOUS_CONTACT.","operationId":"ExternalConsentIngestController_query","parameters":[{"name":"X-Rizaal-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Timestamp","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Api-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"clientKey","required":true,"in":"path","schema":{"example":"ai-connect"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentStatusQueryDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentStatusResponseDto"}}}},"400":{"description":"phone/email eksik veya geçersiz."},"401":{"description":"Kimlik doğrulama başarısız."},"402":{"description":"MODULE_NOT_IN_PLAN: doğrudan (`direct`) bağlantıda şirketin paketinde API Erişimi modülü yok."},"422":{"description":"AMBIGUOUS_CONTACT."},"429":{"description":"İstek limiti aşıldı (`Retry-After` başlığıyla)."},"503":{"description":"Rıza kanıt altyapısı hazır değil."}},"summary":"Kişinin dış kanal rıza kararlarını sorgula","tags":["External Consent"]}},"/integrations/external-consent/{clientKey}/consents/status":{"post":{"description":"Tek istekte en çok 500 kişi (`phone` veya `email`; isteğe bağlı `externalContactId`). Durum, kaynağı ne olursa olsun (dış sistem, İYS/izin.li, web onay/geri çekme sayfası) kişinin RIZAAL'daki GEÇERLİ ETK kanal değeridir; RET kazanır. Yalnız `ALLOWED` ileti/arama için yeterlidir; bekleyen yeniden onay `DENIED` + `reapprovalRequired:true` döner. Bulunan kişiler bağlantı için takibe alınır: sonraki değişiklikleri `consent.changed` webhook'uyla (sorguda verilen `externalContactId` ile) bildirilir. Her kişi bağlantının dakikalık bütçesinden 1 birim harcar. Belirsiz/geçersiz girdi yalnız kendi satırında `error` döner. Telefon/e-posta yanıtta DÖNMEZ. İmza diğer POST uçlarıyla aynıdır.","operationId":"ExternalConsentIngestController_currentStatus","parameters":[{"name":"X-Rizaal-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Timestamp","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Rizaal-Api-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"clientKey","required":true,"in":"path","schema":{"example":"ai-connect"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentCurrentStatusQueryDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalConsentCurrentStatusResponseDto"}}}},"400":{"description":"Geçersiz gövde / 500'den fazla kişi / phone ve email eksik."},"401":{"description":"Kimlik doğrulama başarısız."},"402":{"description":"MODULE_NOT_IN_PLAN: doğrudan (`direct`) bağlantıda şirketin paketinde API Erişimi modülü yok."},"413":{"description":"Gövde 256 KB'ı aşıyor."},"429":{"description":"İstek limiti aşıldı (`Retry-After` başlığıyla)."}},"summary":"Toplu güncel izin durumu: kişilerin ARAMA/MESAJ/EPOSTA kanallarındaki geçerli ETK durumu","tags":["External Consent"]}}},"info":{"title":"RIZAAL API Erişimi","description":"RIZAAL API Erişimi — kendi sisteminizde (CRM, çağrı merkezi, e-ticaret) aldığınız KVKK / ETK izin kararlarını RIZAAL'a iletin; kararlar kayda geçer ve değiştirilemez rıza kanıt zincirine yazılır. ETK izinleri, şirketinizin İYS bağlantısı varsa İYS'ye iletilir.\n\n**Başlarken:** Panelde *API Erişimi* ekranından bağlantınızı oluşturun. Size bir kez gösterilen `apiKey` ve `webhookSecret` değerlerini güvenli biçimde saklayın. Yol parametresi `clientKey` doğrudan entegrasyonda `direct`'tir; isteklerde `customer.externalCustomerId` olarak panelde gösterilen değeri gönderin.\n\n**Kimlik doğrulama:** `Authorization: Bearer <apiKey>` + `X-Rizaal-Timestamp` (unix saniye) + `X-Rizaal-Signature: v1=<hex(HMAC-SHA256(webhookSecret, `${timestamp}.${hamGövde}`))>`. İmzalanan bayt dizisi gönderilen gövdeyle birebir aynı olmalıdır.\n\n**Tekrar güvenliği:** Her olay `externalEventId` ile tekil işlenir; `Idempotency-Key` başlığı verilebilir. Aynı anahtar farklı içerikle gelirse 409 `IDEMPOTENCY_CONFLICT`.\n\n**Test modu:** Bağlantı test modundayken kararlar kaydedilir ama ETK kararları İYS'ye gönderilmez.\n\n**Sınırlar:** Bağlantı başına dakikalık istek bütçesi vardır; aşılırsa 429 ve `Retry-After` başlığı döner. Paketinizde API Erişimi modülü yoksa 402 `MODULE_NOT_IN_PLAN`.\n\n## Giden webhook\n\nRIZAAL -> dış sistem (outbound) webhook imza doğrulaması.\n\nHer istek POST + JSON gövdedir. Başlıklar: `X-Rizaal-Event`, `X-Rizaal-Delivery` (olay kimliği; yeniden denemede SABİT — idempotency anahtarınız), `X-Rizaal-Timestamp` (unix saniye; her denemede yenilenir), `X-Rizaal-Signature`.\nİmza: `v1=` + hex(HMAC-SHA256(secret, `${timestamp}.${hamGövde}`)). Secret rotasyonu geçiş döneminde başlık boşlukla ayrılmış İKİ imza taşır (`v1=<yeni> v1=<eski>`); herhangi biri eşleşirse geçerlidir.\nZaman damgası 5 dakikadan eskiyse isteği reddedin (replay koruması). Yalnız 2xx yanıt başarı sayılır; aksi halde 1 dk, 5 dk, 30 dk, 2 sa aralıklarla yeniden denenir.\n\nÖrnek (Node.js):\n```js\nconst crypto = require(\"crypto\");\nfunction verify(secret, rawBody, headers) {\n  const ts = headers[\"x-rizaal-timestamp\"];\n  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;\n  const mac = \"v1=\" + crypto.createHmac(\"sha256\", secret)\n    .update(ts + \".\" ).update(rawBody).digest(\"hex\");\n  return headers[\"x-rizaal-signature\"].split(\" \").some((s) =>\n    s.length === mac.length &&\n    crypto.timingSafeEqual(Buffer.from(s), Buffer.from(mac)));\n}\n```\n\nGövde şemaları: `ExternalConsentChangedPayloadDto`, `ExternalReapprovalRequiredPayloadDto`, `ExternalPingPayloadDto` (components.schemas).","version":"1.0","contact":{}},"tags":[],"servers":[],"components":{"schemas":{"ExternalConsentChangedPayloadDto":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","description":"Olay kimliği (= X-Rizaal-Delivery); retry'da sabit."},"eventType":{"type":"string","enum":["consent.changed","consent.reapproval_required","ping"]},"occurredAt":{"type":"string","format":"date-time"},"externalCustomerId":{"type":"string","example":"cust-1042"},"externalContactId":{"type":"string","nullable":true,"example":"contact-77"},"kind":{"type":"string","enum":["ETK","KVKK"]},"channel":{"type":"string","enum":["MESAJ","ARAMA","EPOSTA"],"nullable":true},"decision":{"type":"string","enum":["ONAY","RET"]},"method":{"type":"string","nullable":true,"example":"SMS_LINK"},"decidedAt":{"type":"string","format":"date-time"},"source":{"type":"string","enum":["IYS","IZINLI","ADMIN_PANEL","WEB","EXTERNAL"]}},"required":["eventId","eventType","occurredAt","externalCustomerId","externalContactId","kind","channel","decision","method","decidedAt","source"]},"ExternalReapprovalRequiredPayloadDto":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","description":"Olay kimliği (= X-Rizaal-Delivery); retry'da sabit."},"eventType":{"type":"string","enum":["consent.changed","consent.reapproval_required","ping"]},"occurredAt":{"type":"string","format":"date-time"},"externalCustomerId":{"type":"string","example":"cust-1042"},"externalContactId":{"type":"string","nullable":true,"example":"contact-77"},"kind":{"type":"string","enum":["ETK","KVKK"]},"channel":{"type":"string","enum":["MESAJ","ARAMA","EPOSTA"],"nullable":true},"decision":{"type":"string","enum":["ONAY","RET"]},"method":{"type":"string","nullable":true,"example":"SMS_LINK"},"decidedAt":{"type":"string","format":"date-time"},"source":{"type":"string","enum":["IYS","IZINLI","ADMIN_PANEL","WEB","EXTERNAL"]},"reason":{"type":"string","example":"CONSENT_TOO_OLD_REAPPROVAL_REQUIRED","description":"Yeniden onay gerekme nedeni (kısa kod)."}},"required":["eventId","eventType","occurredAt","externalCustomerId","externalContactId","kind","channel","decision","method","decidedAt","source","reason"]},"ExternalPingPayloadDto":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","description":"Olay kimliği (= X-Rizaal-Delivery); retry'da sabit."},"eventType":{"type":"string","enum":["consent.changed","consent.reapproval_required","ping"]},"occurredAt":{"type":"string","format":"date-time"}},"required":["eventId","eventType","occurredAt"]},"ExternalConsentCustomerDto":{"type":"object","properties":{"externalCustomerId":{"type":"string","example":"cust-1042","description":"Dış sistemdeki müşteri kimliği (ai.connect: accountcode). Anahtarın bağlı olduğu müşteriyle AYNI olmalı; aksi halde 422 CUSTOMER_MISMATCH."}},"required":["externalCustomerId"]},"ExternalConsentContactDto":{"type":"object","properties":{"externalContactId":{"type":"string","example":"lead-77","description":"Dış sistemdeki kişi kimliği (opak; makbuza yazılır)."},"externalContactType":{"type":"string","example":"LEAD","description":"Dış sistemdeki kişi türü (opak; makbuza yazılır)."},"phone":{"type":"string","example":"+905321234567","description":"Telefon. `phone` veya `email`'den en az biri zorunlu. Türkiye numaraları +90 / 0 / çıplak biçimlerde kabul edilir."},"email":{"type":"string","example":"ayse@example.com"},"fullName":{"type":"string","example":"Ayşe Yılmaz","description":"Yalnız kişi RIZAAL'da yoksa yeni kayıt için kullanılır."}}},"ExternalConsentEvidenceDto":{"type":"object","properties":{"method":{"type":"string","enum":["VOICE_CALL","SMS_REPLY","WHATSAPP","WEB_FORM","AGENT_MANUAL"],"example":"VOICE_CALL","description":"Onayın alındığı yöntem (zorunlu; kanıt zincirinde `EXT:VOICE|SMS|WA|WEB|AGENT` olarak hash'e girer)."},"ip":{"type":"string","example":"203.0.113.10"},"userAgent":{"type":"string","example":"Mozilla/5.0"},"sourceUrl":{"type":"string","example":"https://form.example.com/consent"},"cdrId":{"type":"string","example":"cdr-8841","description":"Çağrı kaydı kimliği (OPSİYONEL; çağrı kaydı zorunlu değil)."},"recordingRef":{"type":"string","example":"rec/2026/10/13/abc.wav"},"agentId":{"type":"string","example":"agent-17"},"recordingSha256":{"type":"string","example":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","description":"Çağrı ses kaydı dosyasının SHA-256 özeti (64 hex). Kayıt RIZAAL'a gönderilmez; özeti mühürlenir, kaydın sonradan değiştirilmediği bu özetle ispatlanır."},"transcriptSha256":{"type":"string","example":"60303ae22b998861bce3b28f33eec1be758a213c86c93c076dbe9f558c11c752","description":"Görüşme dökümünün (transcript) SHA-256 özeti (64 hex)."},"scriptRef":{"type":"string","example":"kvkk-etk-onay-senaryosu/v12","description":"Kişiye okunan/gösterilen onay senaryosunun kimliği ve sürümü."},"scriptSha256":{"type":"string","example":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","description":"Okunan/gösterilen senaryo metninin SHA-256 özeti (64 hex)."},"aiDisclosure":{"type":"boolean","example":true,"description":"Kişiye yapay zekâ ile konuştuğu bildirildi mi (AB Yapay Zekâ Yasası Md. 50)."},"recordingNotice":{"type":"boolean","example":true,"description":"Görüşmenin kaydedildiği kişiye bildirildi mi (kayıt anonsu)."}},"required":["method"]},"ExternalConsentDecisionDto":{"type":"object","properties":{"kind":{"type":"string","enum":["ETK","KVKK"],"example":"ETK"},"channel":{"type":"string","enum":["MESAJ","ARAMA","EPOSTA"],"example":"MESAJ","description":"ETK için ZORUNLU (MESAJ=SMS, ARAMA, EPOSTA); KVKK'da yok sayılır."},"consentTypeSlug":{"type":"string","example":"KVKK","description":"KVKK kararında RIZAAL consent type kodu (varsayılan: KVKK). Bilinmeyen kod REJECTED/UNKNOWN_CONSENT_TYPE."},"decision":{"type":"string","enum":["ONAY","RET"],"example":"ONAY"},"decidedAt":{"type":"string","example":"2026-10-13T14:05:30+03:00","description":"Kararın alındığı an (ISO-8601). Saat dilimi offset'i ZORUNLU (`Z` veya `+03:00`); offset ayrıca saklanır."},"evidence":{"$ref":"#/components/schemas/ExternalConsentEvidenceDto"}},"required":["kind","decision","decidedAt","evidence"]},"ExternalConsentEventDto":{"type":"object","properties":{"externalEventId":{"type":"string","example":"evt-2026-10-13-0001","description":"Dış sistemin olay kimliği (≤191). Aynı kimlik + aynı gövde güvenle yeniden gönderilebilir."},"customer":{"$ref":"#/components/schemas/ExternalConsentCustomerDto"},"contact":{"$ref":"#/components/schemas/ExternalConsentContactDto"},"decisions":{"description":"1..50 karar.","type":"array","items":{"$ref":"#/components/schemas/ExternalConsentDecisionDto"}}},"required":["externalEventId","customer","contact","decisions"]},"ExternalConsentDecisionResultDto":{"type":"object","properties":{"index":{"type":"number","example":0,"description":"Olaydaki karar sırası (0 tabanlı)."},"status":{"type":"string","enum":["APPLIED","DUPLICATE","REJECTED"],"example":"APPLIED"},"code":{"type":"string","enum":["AMBIGUOUS_CONTACT","INVALID_CONTACT","INVALID_DECIDED_AT","DECIDED_AT_IN_FUTURE","DECISION_TOO_OLD","CONSENT_TOO_OLD_REAPPROVAL_REQUIRED","CHANNEL_NOT_AVAILABLE","UNKNOWN_CONSENT_TYPE","STALE_DECISION"],"description":"REJECTED nedeni."},"reapprovalRequired":{"type":"boolean","example":true,"description":"true: ETK ONAY kararı 3 iş gününden eski olduğu için (İYS H467) geçerli onay olarak işlenmedi; son kullanıcıdan YENİDEN ONAY alınmalı. `code=CONSENT_TOO_OLD_REAPPROVAL_REQUIRED` ile birlikte gelir; bağlantıya `consent.reapproval_required` webhook'u da gönderilir."},"kind":{"type":"string","example":"ETK"},"channel":{"type":"string","example":"MESAJ"}},"required":["index","status"]},"ExternalConsentIngestResponseDto":{"type":"object","properties":{"externalEventId":{"type":"string","example":"evt-2026-10-13-0001"},"duplicate":{"type":"boolean","example":false,"description":"true: olay daha önce işlenmişti; `results` ilk işlemin saklı (PII'siz) sonucudur."},"results":{"type":"array","items":{"$ref":"#/components/schemas/ExternalConsentDecisionResultDto"}}},"required":["externalEventId","duplicate","results"]},"ExternalConsentBatchDto":{"type":"object","properties":{"events":{"description":"1..100 olay; her olay kendi idempotency kimliğiyle ayrı işlenir.","type":"array","items":{"$ref":"#/components/schemas/ExternalConsentEventDto"}}},"required":["events"]},"ExternalConsentBatchEventErrorDto":{"type":"object","properties":{"code":{"type":"string","example":"CUSTOMER_MISMATCH","enum":["CUSTOMER_MISMATCH","IDEMPOTENCY_CONFLICT"]},"message":{"type":"string","example":"Müşteri kimliği bağlantıyla eşleşmiyor."}},"required":["code","message"]},"ExternalConsentBatchEventResultDto":{"type":"object","properties":{"externalEventId":{"type":"string","example":"evt-2026-10-13-0001"},"duplicate":{"type":"boolean","example":false,"description":"true: olay daha önce işlenmişti; `results` ilk işlemin saklı (PII'siz) sonucudur."},"results":{"type":"array","items":{"$ref":"#/components/schemas/ExternalConsentDecisionResultDto"}},"index":{"type":"number","example":0,"description":"İstekteki olay sırası (0 tabanlı)."},"error":{"description":"Olay düzeyinde hata (olay hiç işlenmedi; `results` boş). Diğer olaylar etkilenmez.","allOf":[{"$ref":"#/components/schemas/ExternalConsentBatchEventErrorDto"}]}},"required":["externalEventId","duplicate","results","index"]},"ExternalConsentBatchResponseDto":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/ExternalConsentBatchEventResultDto"}}},"required":["events"]},"ExternalConsentStatusQueryDto":{"type":"object","properties":{"phone":{"type":"string","example":"+905321234567"},"email":{"type":"string","example":"ayse@example.com"}}},"ExternalConsentStatusItemDto":{"type":"object","properties":{"kind":{"type":"string","example":"ETK"},"channel":{"type":"object","example":"MESAJ","nullable":true},"consentTypeCode":{"type":"object","example":"KVKK","nullable":true},"decision":{"type":"string","example":"ONAY"},"method":{"type":"string","example":"VOICE_CALL"},"decidedAt":{"type":"string","example":"2026-10-13T11:05:30.000Z"},"decidedAtOffset":{"type":"string","example":"+03:00"},"receivedAt":{"type":"string","example":"2026-10-13T11:06:00.000Z"},"receiptId":{"type":"string","example":"12","description":"Makbuz kimliği (kaynak)."},"externalEventId":{"type":"string","example":"evt-2026-10-13-0001"}},"required":["kind","channel","consentTypeCode","decision","method","decidedAt","decidedAtOffset","receivedAt","receiptId","externalEventId"]},"ExternalConsentStatusResponseDto":{"type":"object","properties":{"found":{"type":"boolean","example":true},"decisions":{"description":"Yeniden eskiye sıralı dış kanal kararları (en çok 200). Telefon/e-posta DÖNMEZ.","type":"array","items":{"$ref":"#/components/schemas/ExternalConsentStatusItemDto"}}},"required":["found","decisions"]},"ExternalConsentStatusContactQueryDto":{"type":"object","properties":{"phone":{"type":"string","example":"+905321234567","description":"Telefon (+905…, 905…, 05…, 5…; boşluk/tire toleranslı). `phone` veya `email` zorunlu; ikisi birlikte verilirse önce telefon aranır."},"email":{"type":"string","example":"ayse@example.com"},"externalContactId":{"type":"string","example":"lead-88231","description":"Dış sistemdeki kişi kimliği (opak, PII olmamalı). Yanıtta aynen döner ve kişinin sonraki `consent.changed` webhook'larında `externalContactId` olarak gelir."}}},"ExternalConsentCurrentStatusQueryDto":{"type":"object","properties":{"contacts":{"description":"1..500 kişi. Her kişi bağlantının dakikalık bütçesinden 1 birim harcar.","type":"array","items":{"$ref":"#/components/schemas/ExternalConsentStatusContactQueryDto"}}},"required":["contacts"]},"ExternalConsentIysCallStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["ONAY","RET","NONE","UNKNOWN"],"example":"ONAY","description":"Numaranın İYS'teki ARAMA izni (şirketin izin.li hesabı üzerinden; Rızaal kaydı/kanıtı DEĞİLDİR). ONAY: İYS'te geçerli ARAMA onayı var. RET: ret/geri çekme. NONE: İYS'te ARAMA kaydı yok. UNKNOWN: değer şu an verilemiyor (`reason`)."},"checkedAt":{"type":"object","example":"2026-11-03T09:12:00.000Z","nullable":true,"description":"Değerin izin.li'den alındığı an (UTC). Değer en fazla `IYS_CALL_STATUS_TTL_HOURS` (varsayılan 24 saat) eskidir; daha eskiyse UNKNOWN/PENDING döner ve yenilenir. UNKNOWN'da null."},"reason":{"type":"string","enum":["PENDING","LOOKUP_FAILED","SKIPPED","NO_PHONE","NOT_CONFIGURED","MODULE_LOCKED"],"description":"Yalnız UNKNOWN'da. PENDING: arka planda sorgulanıyor, sonraki sorguda gelir. LOOKUP_FAILED: izin.li sorgusu tekrar tekrar başarısız oldu (yeniden kuyruğa alındı). SKIPPED: Rızaal'da bu numara için ARAMA kararı var (ALLOWED/DENIED), İYS sorgusu yapılmadı. NO_PHONE: geçerli bir TR cep numarası yok. NOT_CONFIGURED: şirketin İYS'i izin.li üzerinden bağlı değil. MODULE_LOCKED: şirketin paketinde İYS modülü yok."}},"required":["status","checkedAt"]},"ExternalConsentAramaChannelStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["ALLOWED","DENIED","NONE"],"example":"ALLOWED","description":"ALLOWED: geçerli onay var. DENIED: izin yok — ret, geri çekme, izin talebinde verilmemiş kanal ya da bekleyen yeniden onay. NONE: bu kanal için hiç karar yok (sorulmamış ya da yanıt bekleyen yeni bir izin talebi var). Yalnız ALLOWED ileti/arama için yeterlidir."},"decidedAt":{"type":"object","example":"2026-10-13T11:05:30.000Z","nullable":true,"description":"Bu kanaldaki geçerli kararın RIZAAL'a işlendiği an (UTC)."},"source":{"type":"string","enum":["EXTERNAL","WEB","IYS","ADMIN_PANEL","IMPORT","OTHER"],"example":"EXTERNAL","nullable":true,"description":"Geçerli kararın kaynağı: EXTERNAL (dış sistem), WEB (onay/geri çekme sayfası), IYS (İYS/izin.li), ADMIN_PANEL, IMPORT, OTHER."},"method":{"type":"string","enum":["VOICE_CALL","SMS_REPLY","WHATSAPP","WEB_FORM","AGENT_MANUAL"],"example":"VOICE_CALL","nullable":true,"description":"Yalnız `source=EXTERNAL` iken: dış sistemin bildirdiği onay yöntemi."},"reapprovalRequired":{"type":"boolean","example":false,"description":"true: bu kanalda bekleyen yeniden onay var (ETK ONAY 3 iş gününden eski geldi); durum DENIED döner."},"iys":{"description":"RIZ-576: İYS'teki ARAMA durumu, Rızaal `status`'undan AYRI ve bağımsızdır. Arama kararı için nasıl kullanılacağı istemciye/hukuk görüşüne aittir.","allOf":[{"$ref":"#/components/schemas/ExternalConsentIysCallStatusDto"}]}},"required":["status","decidedAt","source","method","reapprovalRequired","iys"]},"ExternalConsentChannelStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["ALLOWED","DENIED","NONE"],"example":"ALLOWED","description":"ALLOWED: geçerli onay var. DENIED: izin yok — ret, geri çekme, izin talebinde verilmemiş kanal ya da bekleyen yeniden onay. NONE: bu kanal için hiç karar yok (sorulmamış ya da yanıt bekleyen yeni bir izin talebi var). Yalnız ALLOWED ileti/arama için yeterlidir."},"decidedAt":{"type":"object","example":"2026-10-13T11:05:30.000Z","nullable":true,"description":"Bu kanaldaki geçerli kararın RIZAAL'a işlendiği an (UTC)."},"source":{"type":"string","enum":["EXTERNAL","WEB","IYS","ADMIN_PANEL","IMPORT","OTHER"],"example":"EXTERNAL","nullable":true,"description":"Geçerli kararın kaynağı: EXTERNAL (dış sistem), WEB (onay/geri çekme sayfası), IYS (İYS/izin.li), ADMIN_PANEL, IMPORT, OTHER."},"method":{"type":"string","enum":["VOICE_CALL","SMS_REPLY","WHATSAPP","WEB_FORM","AGENT_MANUAL"],"example":"VOICE_CALL","nullable":true,"description":"Yalnız `source=EXTERNAL` iken: dış sistemin bildirdiği onay yöntemi."},"reapprovalRequired":{"type":"boolean","example":false,"description":"true: bu kanalda bekleyen yeniden onay var (ETK ONAY 3 iş gününden eski geldi); durum DENIED döner."}},"required":["status","decidedAt","source","method","reapprovalRequired"]},"ExternalConsentChannelStatusesDto":{"type":"object","properties":{"ARAMA":{"$ref":"#/components/schemas/ExternalConsentAramaChannelStatusDto"},"MESAJ":{"$ref":"#/components/schemas/ExternalConsentChannelStatusDto"},"EPOSTA":{"$ref":"#/components/schemas/ExternalConsentChannelStatusDto"}},"required":["ARAMA","MESAJ","EPOSTA"]},"ExternalConsentContactStatusDto":{"type":"object","properties":{"index":{"type":"number","example":0,"description":"İstekteki kişi sırası (0 tabanlı)."},"externalContactId":{"type":"object","example":"lead-88231","nullable":true},"found":{"type":"boolean","example":true},"error":{"type":"string","enum":["AMBIGUOUS_CONTACT","INVALID_CONTACT"],"description":"AMBIGUOUS_CONTACT: birden çok kişi eşleşti. INVALID_CONTACT: telefon geçersiz ve e-posta yok. Diğer kişiler etkilenmez."},"channels":{"description":"Kişi bulunamazsa tüm kanallar NONE.","allOf":[{"$ref":"#/components/schemas/ExternalConsentChannelStatusesDto"}]}},"required":["index","externalContactId","found","channels"]},"ExternalConsentCurrentStatusResponseDto":{"type":"object","properties":{"checkedAt":{"type":"string","example":"2026-11-03T08:00:00.000Z","description":"Yanıtın üretildiği an; önbellek tazeliği için."},"contacts":{"description":"İstek sırasıyla; telefon/e-posta DÖNMEZ.","type":"array","items":{"$ref":"#/components/schemas/ExternalConsentContactStatusDto"}}},"required":["checkedAt","contacts"]}}}}