> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# TCPA Bilinen-Davacı Kapısı

> TCPA profesyonel davacılarını içeren platform bilinen-davacı listesindeki numaralara SMS/MMS gönderimlerini engelleyen alıcı-kaynak kontrolünü opt-in ile etkinleştirin; onaylı-atlatma denetim izi ve açık-başarısızlık (fail-open) hata modu ile.

# TCPA Bilinen-Davacı Kapısı

ABD operatörleri ve sektör servisleri (Numeracle, Blacklist Alliance,
DNC.com) **profesyonel davacı** listeleri tutar — TCPA şikayetlerini
gönderenlere karşı bir iş olarak dosyalayan alıcılar. Bunlardan birine
onaysız tek bir A2P SMS, 47 U.S.C. § 227(b)(3) kapsamında mesaj başına
$500–$1.500'e mal olur. Orbit'in bilinen-davacı kapısı bu gönderimleri
sevk edilmeden önce engeller.

Kapı, tasarım gereği **ABD (+1, NANP) SMS ve MMS trafiği** ile
sınırlıdır — TCPA bir ABD yasasıdır ve tetiklenen kanallar SMS/MMS'tir.
Ses trafiği kendi TCPA arama-penceresi korumasını taşır; bkz.
[Gönderim Kapıları](/compliance/send-gates).

<Warning>
  Bu, opt-in yaptığınız bir tenant risk kontrolüdür, platform taraması
  değildir. Kapı ancak organizasyonunuz onu açtığında gönderim yoluna
  girer ve seri TCPA davası açanlara maruz kalma riskinizi azaltır
  (ortadan kaldırmaz). Hukuki tavsiye değildir — TCPA
  yükümlülüklerinizi hukuk danışmanınızla doğrulayın.
</Warning>

***

## Kontrol nasıl çözümlenir

Etkin bir organizasyondaki her gönderim, alıcıyı katmanlı bir zincire
karşı çözümler, en ucuzdan başlayarak:

1. **Kontakt ön-işareti** — bir toplu içe aktarım kontaktın
   `is_tcpa_litigator` işaretini daha önce damgaladıysa, sorgu tamamen
   atlanır ve gönderim ağa veya önbelleğe dokunmadan işaretli olarak
   çözümlenir. Gönderim başına değil, içe aktarım başına bir hesaplama.
2. **Redis önbelleği** — önceki bir sorgudan gelen önbelleğe alınmış
   karar.
3. **Numeracle canlı sorgu** — operatör Numeracle anahtarını
   yapılandırdığında kullanılır (Orbit'in barındırılan SaaS'ı bunu
   sizin için ayarlar).
4. **Statik tohum (seed)** — platformla paketlenen davacı listesi; canlı
   sorgu mevcut olmadığında son çare kaynağı olarak kullanılır.

Her karar, `source` değerini denetim izi ve admin sorgu yüzeyine rapor
eder; böylece önbelleğe alınmış bir eşleşmeyi canlı olandan ayırt
edebilirsiniz.

Admin tarafından ayarlanan **manuel geçersiz kılmalar** aynı önbellek
katmanında durur, böylece bir zorla-işaretle veya zorla-temizle
sorgular arasında kalıcı olur. Aşağıdaki
[Admin manuel geçersiz kılmalar](#admin-manuel-gecersiz-kilmalar)
bölümüne bakın.

***

## Kapıyı etkinleştirme

Kapı **varsayılan olarak kapalıdır**. ABD dışı operatörler için kapalı
gelir: +1 alıcılara hiç dokunmayan trafik üzerinde bir ABD TCPA
kontrolü, hiçbir fayda olmadan sorgu gecikmesi ve denetim gürültüsü
ekler. Genel ayarlarınızda `tcpa_check_enabled` ayarlayarak
organizasyon başına açın:

```bash theme={null}
curl -X PUT "https://api.orbit.devotel.io/api/v1/settings/general" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "settings": { "tcpa_check_enabled": true } }'
```

İşaret `true` olana kadar her gönderim zinciri tamamen atlar. `false`
ayarlamak (veya anahtarı hiç ayarlamamak) kapalı demektir. Panel
uyumluluk ayarları aynı anahtarı sunar.

<Note>
  Ses aramaları bu kontrolle gate edilmez. Kapsam, `+1` hedeflerine
  `sms` ve `mms` gönderimleridir. Litigator taramasını giden sese
  genişletmek için aşağıdaki admin manuel-geçersiz-kılma yüzeyini
  kullanın veya alıcıları bir kampanyadan önce admin sorgusuyla
  tarayın.
</Note>

***

## Engellenen bir gönderim neye benzer

Engellenen bir gönderim `403 TCPA_KNOWN_LITIGATOR_BLOCKED` fırlatır
(sınıfın yerleştiği anda adlandırıldığı kod — eski liste adı
`MESSAGING_TCPA_KNOWN_LITIGATOR` değiştirildi). Yanıt gövdesi:

```json theme={null}
{
  "error": {
    "code": "TCPA_KNOWN_LITIGATOR_BLOCKED",
    "message": "Recipient is on the TCPA known-litigator list and has not given verifiable consent. Confirm consent in writing before sending, OR remove the recipient from the campaign.",
    "status": 403,
    "details": {
      "to": "+1415****",
      "channel": "sms",
      "source": "numeracle",
      "score": 92
    }
  }
}
```

Engelleme **faturalamadan önce** çözümlenir, böylece engellenen bir
gönderim hiçbir zaman ücret yazmaz. `details.source`, alıcıyı hangi
katmanın işaretlediğini söyler (`contact_flag`, `cache`, `numeracle`,
`seed` veya `manual_override`).

Kapının Numeracle'dan bir güven skoru olduğunda, bu `details.score`
içinden geçer (0–100, yüksek daha riskli).

### ABD dışı hedefler

Listeyle eşleşen `+1` olmayan alıcılar kesin bir blok yerine bir
**yumuşak uyarı** alır: gönderim devam eder, bir Sentry breadcrumb'ı ve
`messages.tcpa_litigator_soft_warn` denetim girişi işareti kaydeder ve
sonradan inceleyebilirsiniz. TCPA'nın kesin-blok kapsamı yalnızca
NANP'tir.

***

## Onaylı atlatma

Alıcının aynı kanal için bir `opted_in` onay kaydı varsa, kapı
**gönderime izin verir** — ancak bir denetim girişi
(`messages.tcpa_litigator_consented_bypass`) ve bir Sentry breadcrumb'ı
yazar, böylece uyumluluk ekibiniz kararı sonradan inceleyebilir.
Denetim girişi alıcıyı (maskeli), kanalı, işaret kaynağını ve skoru
taşır.

Engellenen gönderimler bunun yerine `messages.tcpa_litigator_blocked`
girişleri yazar. Her iki sınıfı da Admin konsolundan veya SIEM
havuzunuzdan sorgulayın.

***

## Hata modu: açık başarısızlık (fail-open)

Redis önbelleğinde, veritabanı sorgusunda veya Numeracle API'sinde bir
kesinti gönderimlerinizi **engellemez**. Zincir hatayı yakalar, bir
uyarı loglar, Sentry'de yakalar ve alıcıyı işaretsiz olarak ele alır
— gönderim geçer. Bu kasıtlıdır: bir TCPA ön-kontrol kesintisi asla
tüm giden mesajlaşmayı kara deliğe çevirmemelidir.

Kapalı olarak başarısız olmayı tercih ederseniz (örneğin canlı bir şikayet
sırasında), anahtarı kapatın ve admin manuel-geçersiz-kılma yüzeyine
dayanın — etkilenen numaraları zorla-işaretleyin, böylece yukarı akış
sorgu kullanılabilirliğine bağlı olmadan engellenirler.

***

## Admin manuel geçersiz kılmalar

Platform personeli, listenin kendisini süper-admin yüzeyi
(`/dashboard/tcpa-litigators`) üzerinden yönetir:

* `GET /admin/compliance/tcpa-litigators/seed` — statik tohum zarfı
  (kaynak, giriş sayısı, son güncelleme).
* `GET /admin/compliance/tcpa-litigators/lookup?phone=…` — bir şikayeti
  ayıklamak için canlı zinciri bir telefon üzerinde çalıştırın.
* `POST /admin/compliance/tcpa-litigators/override` — bir numarayı
  zorla-işaretle veya zorla-temizle (kaldırılana kadar sorgular arasında
  kalıcıdır).
* `DELETE /admin/compliance/tcpa-litigators/override/:phone` — bir
  geçersiz kılmayı bırak.
* `GET /admin/compliance/tcpa-litigators/overrides` — etkin geçersiz
  kılmaları kaynak bilgisiyle listele (kim ayarladı, ne zaman, neden).
* `POST /admin/compliance/tcpa-litigators/diff` + `/merge` — işaretleri
  toplu olarak CSV'den içe aktar.
* `GET /admin/compliance/tcpa-litigators/match-stats` — sparkline için
  saatlik engellenen / onaylı-atlatma / yumuşak-uyarı sayıları.

Tüm bunlar yalnızca süper-admin'dir ve denetim loglanır.

***

## İlgili

* [Gönderim Kapıları](/compliance/send-gates) — sessiz saatler, DNC,
  RND, RMD ve acil durdurma bu kapıyla gönderim anında birlikte çalışır.
* [DNC Taraması](/compliance/dnc-scrub) — kendi listelerinize ve
  ulusal kayıtlara karşı Do-Not-Call ön-kontrolü.
* [Onay Yönetimi](/compliance/consent-management) — atlatmanın okuduğu
  onay kayıtları.
* [Hata Kodları](/reference/error-codes) — tam yük şekliyle
  `TCPA_KNOWN_LITIGATOR_BLOCKED` satırı.