​

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

​

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

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

​

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

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

​

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

{
  "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
    }
  }
}

​

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

​

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

​

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

​

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

• 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 — أعداد الحظر / التجاوز المتفق عليه / التحذير المرن ساعية للمؤشر الصغير.

​

مرتبط

• بوابات الإرسال — ساعات الهدوء، وDNC، وRND، وRMD، والإيقاف الطارئ تعمل بجوار هذه البوابة وقت الإرسال.
• فحص DNC — التنقيح المسبق لـعدم الاتصال مقابل قوائمك والسجلات الوطنية.
• إدارة الموافقة — سجلات الموافقة التي يقرأها التجاوز.
• رموز الخطأ — صف TCPA_KNOWN_LITIGATOR_BLOCKED مع شكل الحمولة الكامل.