> ## 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

> فعِّل فحص أصل المستلم الذي يحظر إرسالات SMS/MMS إلى أرقام ضمن قائمة المنصة للمتقاضين المحترفين بموجب TCPA، مع مسار تدقيق لتجاوز الموافقة ووضع فشل مفتوح.

# بوابة المتقاضي المعروف في TCPA

تُبقي شركات الاتصال الأمريكية والخدمات الصناعية (Numeracle، وBlacklist
Alliance، وDNC.com) قوائم **المتقاضين المحترفين** — المستلمين الذين
يقدمون شكاوى TCPA ضد المرسلين كأعمالهم. رسالة A2P SMS واحدة بدون
موافقة لأحدهم تكلف 500–1,500 دولار لكل رسالة بموجب
47 U.S.C. § 227(b)(3). بوابة المتقاضي المعروف في Orbit تحظر تلك
الإرسالات قبل إرسالها.

البوابة محدودة النطاق تصميمياً إلى **حركة SMS وMMS الأمريكية (+1،
NANP)** — فقانون TCPA تشريع أمريكي، وSMS/MMS هما القناتان
المُشغِّلتان له. حركة الصوت تحمل حارس نافذة الاتصال الخاص بها بموجب
TCPA؛ انظر [بوابات الإرسال](/compliance/send-gates).

<Warning>
  هذا تحكم في المخاطر يمتاز بإتاحته التفضيلية، لا فحص منصة. تعمل
  البوابة على مسار الإرسال فقط عندما تشغِّلها منظمتك، وتُخفض (لا
  تُلغي) تعرضك للمقدمين المتسلسلين لـTCPA. ليست مشورة قانونية —
  أكِّد التزاماتك بموجب TCPA مع مستشارك القانوني.
</Warning>

***

## كيف يُحل الفحص

كل إرسال على منظمة مُفعَّلة يحُل المستلم مقابل سلسلة طبقية، الأرخص
أولاً:

1. **علم جهة الاتصال المسبق** — إذا استيقى استيراد جماعي علم جهة
   الاتصال `is_tcpa_litigator`، تتجاوز البحث تماماً ويُحل الإرسال
   كموسوم دون لمس الشبكة أو الذاكرة المؤقتة. حساب واحد لكل استيراد،
   لا لكل إرسال.
2. **ذاكرة Redis المؤقتة** — حكم مخزّن من بحث سابق.
3. **بحث Numeracle الحي** — يُستعمل عندما هيأ المشغل مفتاح
   Numeracle (SaaS المضيف في Orbit يضطره).
4. **اللقطة الاستاتيكية** — قائمة المتقاضين المجموعة في المنصة،
   تُستعمل كمصدر آخر عندما يتعذر البحث الحي.

كل حكم يُبلغ `source` من خلال مسار التدقيق وسطح البحث الإداري،
لذا يمكنك التمييز بين ضربة مخزنة وضربة حية.

**التجاوزات اليدوية** المضبوطة إدارياً تعيش في نفس طبقة الذاكرة
المؤقتة، لذا يستمر التعيين القسري أو التنظيف القسري عبر البحوث. انظر
[التجاوزات اليدوية الإدارية](#admin-manual-overrides) أدناه.

***

## تشغيل البوابة

البوابة **معطلة افتراضياً**. تُشحن معطلة لمشغلي غير الأمريكية: فحص
TCPA أمريكي على حركة لا تلمس +1 مستلم أبداً يضيف زمن بحث وضوضاء
تدقيق بدون فائدة. شغِّلها لكل منظمة بضبط `tcpa_check_enabled` في
إعداداتك العامة:

```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 } }'
```

حتى يصبح العلم `true`، يتجاوز كل إرسال السلسلة تماماً. ضبط `false`
(أو عدم ضبط المفتاح أبداً) يعني معطل. تُظهر إعدادات الامتثال في لوحة
التحكم نفس المفتاح.

<Note>
  المكالمات الصوتية ليست محكومة بهذا الفحص. النطاق هو `sms` و`mms`
  للوجهات `+1`. لتمديد فحص المتقاضين إلى الصوت الصادر، استخدم سطح
  التجاوز اليدوي الإداري أدناه أو افحص المستلمين قبل حملة ببحث الإدارة.
</Note>

***

## ما يبدو عليه الإرسال المحظور

الإرسال المحظور يُطلق `403 TCPA_KNOWN_LITIGATOR_BLOCKED` (الرمز
الذي يسمى الصنف بمجرد إطلاقه — اسم القائمة القديم
`MESSAGING_TCPA_KNOWN_LITIGATOR` استُبدل). جسم الاستجابة:

```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
    }
  }
}
```

الحظر يُحل **قبل** الفوترة، لذا إرسال محظور لا يُحصى أبداً. `details.source`
يخبرك أي طبقة وسِمت المستلم (`contact_flag` أو `cache` أو `numeracle`
أو `seed` أو `manual_override`).

عندما البوابة لديها درجة ثقة من Numeracle، تمرر في `details.score`
(0–100، أعلى يعني أعلى خطر).

### الوجهات غير الأمريكية

المستلمون غير `+1` الذين يطابقون القائمة يحصلون على **تحذير
مرن** بدلاً من حظر صارم: الإرسال يستمر، علم Sentry وإدخال تدقيق
`messages.tcpa_litigator_soft_warn` يسجلان العلم، ويمكنك مراجعته
لاحقاً. نطاق الحظر الصارم لـTCPA هو NANP فقط.

***

## التجاوز المتفق عليه

إذا المستلم لديه سجل موافقة `opted_in` لنفس القناة، البوابة **تسمح
بالإرسال** — لكن تكتب إدخال تدقيق
(`messages.tcpa_litigator_consented_bypass`) بالإضافة إلى علم Sentry
حتى يمكن لفريق الامتثال لديك مراجععة القرار لاحقاً. إدخال التدقيق
يحمل المستلم (بإخفاء)، والقناة، ومصدر العلم، والدرجة.

الإرسالات المحظورة تكتب إدخالات `messages.tcpa_litigator_blocked`
بدلاً من ذلك. استعلم أي صنف من وحدة الإدارة أو منحدر SIEM الخاص بك.

***

## وضع الفشل: فشل مفتوح

عطل في ذاكرة Redis المؤقتة، أو مسبار قاعدة البيانات، أو Numeracle API
لا **يحظر** إرسالاتك. السلسلة تُلتقط العطل، وتُسجل تحذيراً، وتلتقطه في
Sentry، وتُعامل المستلم كغير موسوم — الإرسال يمر. هذا مقصود: عطل في
تنقيح TCPA يجب ألّا يُبتلع كل الرسائل الصادرة.

إذا كنت تفضل الفشل المغلق (مثل أثناء شكوى حية)، أطفئ المفتاح واعتمد
على سطح التجاوز اليدوي الإداري — عيِّنوا الأرقام المعنية قسراً حتى
تحظر بدون الاعتماد على توفُر البحث الأعلى.

***

## التجاوزات اليدوية الإدارية

فريق المنصة يُدير القائمة ذاتها من سطح الإدارة فوق المستأجر
(`سطح التجاوزات اليدوية` (`/dashboard/tcpa-litigators`):

* `GET /admin/compliance/tcpa-litigators/seed` — مغلف اللقطة
  الاستاتيكية (المصدر، عدد الإدخالات، وقت التحديث الأخير).
* `GET /admin/compliance/tcpa-litigators/lookup?phone=…` — شغِّل
  السلسلة الحية مقابل هاتف واح لتكشف مشكلة.
* `POST /admin/compliance/tcpa-litigators/override` — عيِّنو
  قسراً أو نظِّف قسراً رقماً (يستمر عبر البحوث حتى يُحذف).
* `DELETE /admin/compliance/tcpa-litigators/override/:phone` —
  احذف تجاوزاً.
* `GET /admin/compliance/tcpa-litigators/overrides` — اعرض التجاوزات
  الفعالة مع أصلهن (من ضبطها، ومتى، ولماذا).
* `POST /admin/compliance/tcpa-litigators/diff` + `/merge` —
  استيراد جماعي لـCSV من الحجز.
* `GET /admin/compliance/tcpa-litigators/match-stats` — أعداد
  الحظر / التجاوز المتفق عليه / التحذير المرن ساعية للمؤشر الصغير.

كل هذه متاحة للإدارة فوق المستأجر فقط ومسجلة للتدقيق.

***

## مرتبط

* [بوابات الإرسال](/compliance/send-gates) — ساعات الهدوء، وDNC،
  وRND، وRMD، والإيقاف الطارئ تعمل بجوار هذه البوابة وقت الإرسال.
* [فحص DNC](/compliance/dnc-scrub) — التنقيح المسبق لـعدم الاتصال
  مقابل قوائمك والسجلات الوطنية.
* [إدارة الموافقة](/compliance/consent-management) — سجلات الموافقة
  التي يقرأها التجاوز.
* [رموز الخطأ](/reference/error-codes) — صف
  `TCPA_KNOWN_LITIGATOR_BLOCKED` مع شكل الحمولة الكامل.