​

فرز DNC: المصادر وحداثة البيانات ونقطة نهاية الفحص

​

متى يهمّ فرز DNC

• سجل DNC الفدرالي الأمريكي (FTC National Registry). مكالمات التسويق الهاتفي والرسائل النصية التسويقية إلى رقم مسجَّل على المستوى الفدرالي مقيّدة؛ والفرز مقابل السجل الفدرالي هو خط الدفاع الأساسي قبل أي حملة صادرة.
• سجلات الولايات الأمريكية. تُشغِّل عدة ولايات قوائم DNC خاصة بها فوق القائمة الفدرالية. قد يكون الرقم غائبًا فدراليًا لكنه مسجَّل في بنسلفانيا مثلاً — فالفرز الفدرالي وحده غير كامل لحركة النقل الأمريكية.
• TCR Universal Opt-Out. تلتقط قائمة الإلغاء العالمي لـ The Campaign Registry الأرقام التي ألغت اشتراكها في الرسائل A2P على مستوى السجل. إقرارها جزء من نظافة الرسائل 10DLC الأمريكية بغض النظر عن قائمة الكبح الخاصة بك.
• السجلات الوطنية الدولية. خارج الولايات المتحدة تسري قوائم وطنية مكافئة — UK TPS وCTPS، وسجل Do Not Call الأسترالي، وNDNC الهندي. هذه لكل ولاية قضائية: تفرز حملة بريطانية مقابل السجلات البريطانية، ولهذا تقبل نقطة نهاية الفحص مرشّح country (أدناه).

​

تفعيل مفتاح المستأجر

{
  "error": {
    "code": "DNC_SYNC_NOT_ENABLED",
    "message": "DNC check endpoint requires the per-org opt-in flag ...",
    "status": 403
  }
}

​

من أين تأتي القائمة (توصيل الخلاصات)

• DEVOTEL_DNC_FEED_FILE — وحدة تخزين مركَّبة تحوي لقطة فدرالية/ولائية/TCR مشتراة. تقرأها المزامنة اليومية، وتُحلّل كل رقم ألغى اشتراكه، وتُدرِجه في قائمة DNC للمنصّة موسومًا بمصدره (federal_dnc أو state_dnc:XX أو tcr).
• DEVOTEL_DNC_FEED_URL — تنزيل موثَّق للقطة نفسها، بديلاً عن الملف المركَّب. يتقدّم الملف حين يكون كلاهما مضبوطًا.

​

قراءة نقطة نهاية الفحص

curl "https://api.orbit.devotel.io/api/v1/compliance/dnc/check?phone=%2B14155550101" \
  -H "Authorization: Bearer $ORBIT_API_KEY"

{
  "on_dnc": true,
  "source": "federal_dnc",
  "last_synced_at": "2026-08-26T03:00:12.441Z",
  "jurisdictions": ["US Federal DNC"],
  "federal_feeds_synced": true,
  "intl_feeds_synced": false
}

• source — أي مصدر أنتج أول إصابة، واحدة من federal_dnc أو state_dnc (سجل ولاية أمريكية) أو tcr (Universal Opt-Out لـ TCR) أو intl_dnc (سجل وطني دولي) أو suppression (طبقة الكبح الخاصة بك) أو none (ليس على أي قائمة). تسرد jurisdictions كل منشأ مطابق، فيظهر الرقم الموجود على السجل الفدرالي وعلى سجل ولاية معًا كلَيهما.
• last_synced_at — الطابع الزمني لحداثة المصدر المطابق: متى مُزامِنَت لقطة فدرالية/ولائية/TCR (أو الصف الذي أصابها) آخر مرة. تختم المزامنة اليومية صف نبضة (heartbeat) كل تشغيل، فيحمل هذا الحقل دائمًا إشارة «آخر مزامنة» للمصادر المدعومة بالخلاصات بدل الصمت حين لا يطابق صف. مصادر الكبح/الموافقة الخاصة بك لا مزامنة لها، فعند إصابة كبح وحدها يعكس الحقل حدث الإلغاء نفسه.
• federal_feeds_synced / intl_feeds_synced — ما إذا كان الـ API قد استوعب فعلاً لقطة فدرالية/ولائية/TCR أمريكية ولقطة سجل وطني دولي، على التوالي. اقرأهما في كل استجابة: فهما يفرّقان بين «الرقم صافٍ» وبين «الرقم صافٍ و فرز فدرالي ساند تلك الإجابة».

curl "https://api.orbit.devotel.io/api/v1/compliance/dnc/check?phone=%2B442071838750&country=GB" \
  -H "Authorization: Bearer $ORBIT_API_KEY"

​

كيف يستهلكها مسار الإرسال

• الرسائل (SMS / MMS / WhatsApp / …). قبل الإرسال، يجيب مسار الإرسال عن «هل ألغى هذا المستلم اشتراكه؟» مقابل مصادر DNC نفسها — علم DNC لجهة اتصالك، وقائمة DNC الخاصة بك، وقائمة الكبح (إشارة STOP العابرة للقنوات)، وقائمة DNC على مستوى المنصّة (حيث تهبط الخلاصة الفدرالية/الولائية/TCR اليومية)، وإلغاءات الموافقة المسجَّلة. الإصابة تُسقِط الإرسال.
• الصوت / المتصل (dialer). يشغّل المتصل سلسلة الامتثال نفسها قبل إنشاء مكالمة — STOP العابر للقنوات، وDNC لجهة الاتصال، وDNC المنصّة، والموافقة — فلا يُتَّصل صوتيًا برقم ألغى اشتراكه عبر SMS. ويفشل مسار الإرسال مغلقًا: إن تعذّر إكمال فحص الامتثال نفسه، تُؤجَّل المكالمة بدل الاتصال.

​

تحفّظ الفشل المفتوح (fail-open)

ما دامت لا خلاصة فدرالية مزامَنة، فالرقم الموجود على سجل FTC الفدرالي وحدَه يقرأ صافيًا (on_dnc: false).

1. لا تَعُدّ النتيجة الصافية ملاذًا آمنًا فدراليًا ما لم تكن federal_feeds_synced: true. حكم الصفاء مع federal_feeds_synced: false يعني فقط أن قوائمك الخاصة والكبح والموافقة وقائمة المنصّة لم تُعلِّم الرقم.
2. البوّابة الصارمة هي مسار الإرسال. مسار القراءة فاشل مفتوحًا (fail-open) تصميمًا؛ ومسار الإرسال ليس كذلك. لا يتحوّل سلبي كاذب من استعلام مسبق أبدًا إلى إرسال — فسلسلة وقت الإرسال تعيد فحص المصادر نفسها وتحظر ما تجده.

​

التحقق قبل الحملة

curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/dnc/scrub" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phones": ["+14155550101", "+442071838750", "+14155550101"],
    "country": "GB"
  }'

{
  "results": [
    { "phone": "+14155550101", "on_dnc": true, "source": "federal_dnc", "jurisdictions": ["US Federal DNC"] },
    { "phone": "+442071838750", "on_dnc": false, "source": "none", "jurisdictions": [] }
  ],
  "summary": { "total": 2, "on_dnc": 1, "clear": 1, "duplicates_removed": 1 },
  "federal_feeds_synced": true,
  "intl_feeds_synced": false
}

• Send Gates — بوّابات ساعات الهدوء / DNC / RND / RMD في وقت الإرسال والإيقاف الطارئ.
• بوّابة TCPA المعروف بالتقاضي — فحص منشأ المستلم الذي يُكمِل فرز DNC لمخاطر TCPA الأمريكية.
• الفرز المسبق الجَمعي لـ DNC — سير عمل الحملة حول الفرز الجَمعي: التبويب والتقطيع وتوجيه الأرقام المعلَّمة.
• قوائم إلغاء الاشتراك والكبح — كيف تهبط STOP المستلم على طبقة الكبح التي تقرأها سلسلة DNC.
• وضعية امتثال مستأجرك — خريطة المفاتيح، بما فيها صف dnc_sync_enabled لهذه الصفحة.