Skip to main content

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 500500–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ı.
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.

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 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:
İşaret true olana kadar her gönderim zinciri tamamen atlar. false ayarlamak (veya anahtarı hiç ayarlamamak) kapalı demektir. Panel uyumluluk ayarları aynı anahtarı sunar.
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.

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:
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ı — sessiz saatler, DNC, RND, RMD ve acil durdurma bu kapıyla gönderim anında birlikte çalışır.
  • DNC Taraması — kendi listelerinize ve ulusal kayıtlara karşı Do-Not-Call ön-kontrolü.
  • Onay Yönetimi — atlatmanın okuduğu onay kayıtları.
  • Hata Kodları — tam yük şekliyle TCPA_KNOWN_LITIGATOR_BLOCKED satırı.