متطلبات الامتثال حسب الدولة
تُحدَّد قواعد الرسائل والصوت دولةً بدولة. قبل الإرسال إلى سوق جديد، عليك معرفة أربعة أمور: أي أنواع المرسلين تقبلها تلك الدولة (رمز طويل؟ هوية مرسل أبجدية-رقمية؟ رمز قصير؟)، وما إذا كان التسجيل مطلوبًا، وأي مستندات يجب تقديمها، وأي محتوى مقيَّد. إن خطأ هذا هو السبب الأشهر لفشل الإرسال الأول إلى دولة جديدة في التسليم بصمت. تُحافظ Orbit على مرجع تنظيمي منظمّ لكل دولة كي لا تضطر إلى تجميعه بنفسك. تشرح هذه الصفحة كيف تقرؤه.هذا المرجع إرشاد لتخطيطك، وليس ضمان تسليم ولا نصيحة قانونية. موافقة
هوية المرسل أو التسجيل النهائية تمنحها الهيئة التنظيمية أو مشغّل الاتصال
في كل دولة، لا Orbit. تُفعَّل التغطية لكل مستأجر — ظهور دولة هنا لا
يعني أنها مفعّلة على حسابك.
ابحث عن قواعد دولة
GET /compliance/country-rules هو المرجع التنظيمي للقراءة فقط وراء بوّابات الإرسال في Orbit. أي مستخدم موثَّق يمكنه طلبه. رشِّح حسب channel (الافتراضي sms) واختياريًا حسب region:
channel القيم sms وwhatsapp وrcs وvoice وemail وviber. الدولة نفسها لها صفوف منفصلة لكل قناة لأن القنوات المختلفة تخضع لمنظمين مختلفين — مثلاً قواعد WABA لـ Meta تحكم WhatsApp في البرازيل بينما تحكم قواعد Anatel الـ SMS.
قراءة كل حقل
أنواع المرسلين
مستويات التسجيل registration
حقل registration هو أهم قيمة تقرأها قبل الإطلاق. يقود بوّابة الإرسال في Orbit:
none — أرسل بحرية
none — أرسل بحرية
لا تسجيل هوية مرسل مطلوب. يمكنك بدء الإرسال بمجرد تفعيل القناة
والدولة على حسابك.
recommended — أرسل الآن، وسجّل من أجل الاعتمادية
recommended — أرسل الآن، وسجّل من أجل الاعتمادية
يُسمَح بالإرسال بلا تسجيل، لكن الحركة غير المسجَّلة أكثر احتمالًا
لأن تُرشَّح أو تُعاد تسميتها. سجّل هوية المرسل للحفاظ على تسليم مستقر.
required — سجّل قبل أن ترسل
required — سجّل قبل أن ترسل
تُحظَر الحركة حتى تحصل على تسجيل هوية مرسل معتمد لتلك الدولة. A2P
SMS إلى دولة
required بلا إدخال معتمد يحتجزه بوّابة الإرسال. سجّل
واحصل على الموافقة قبل الإطلاق — راجع
تسجيل هوية المرسل.المستندات التي تتوقعها كل دولة
حيثما تتطلب الدولة (أو توصي بـ) تسجيلاً، تقدّم مستندات داعمة مرة واحدة ثم تشير إليها بمعرّفاتها ذاتdoc_… عند تسجيل هوية مرسل. يتغير الطقم الدقيق بحسب السوق، لكن معظم المنظمين يطلبون بعض مزيج من:
- إثبات تسجيل تجاري — شهادة تأسيس أو رخصة تجارية أو ما يعادلها.
- وصف حالة الاستخدام — ما الذي ترسله (معاملاتي، OTP، تسويقي) وإلى من.
- ملكية العلامة / التفويض — إثبات أنك مخوّل بهوية المرسل / اسم العلامة الذي تسجّله.
- هوية ضريبية محلية أو هوية المنظم — للأسواق التي تربط التسجيل بمعرّف وطني.
sender_rules وcontent_restrictions في الدولة المستهدفة من استجابة country-rules للتفاصيل، ثم ألحق المستندات المطابقة عند تقديم التسجيل.
بعض الأسواق تدير نظام تسجيل مخصصًا خاصًا بدلاً من سير تسجيل هوية المرسل العام:
- الهند — هويات المرسل (“Headers”)، وقوالب المحتوى، وقوالب الموافقة تُسجَّل عبر بوابة TRAI DLT. راجع تأهيل DLT-India.
- الولايات المتحدة — مرسلو A2P SMS يسجّلون علامة وحملة عبر 10DLC. راجع دليل تسجيل 10DLC.
قائمة تحقق لإطلاق دولة جديدة
1
ابحث عن القواعد
اطلب
GET /compliance/country-rules?channel=<channel> للوجهة واقرأ
sender_types وregistration وcontent_restrictions.2
اختر نوع مرسل مقبولاً
اختر هوية مرسل من
sender_types تلك الدولة — هوية مرسل أبجدية-رقمية،
أو رمزاً طويلاً، أو رمزاً قصيراً، أو مرسلاً أصيلاً للقناة (WABA / وكيل
RCS).3
سجّل إذا كانت مطلوبة
إذا كانت
registration قيمتها required (أو recommended)، ارفع
مستنداتك وقدّم هوية المرسل للموافقة. خطّط لوقت مسبق — بعض الأسواق
تأخذ أيامًا إلى أسابيع.4
تحقق من قيود المحتوى
تأكد أن حالة استخدامك مسموحة قبالة
content_restrictions والصناعات
المقيَّدة والمحظورة، وأضف كلمة
إلغاء الاشتراك المطلوبة إذا طلبها stop_requirement.5
أطلِق
بمجرد أن تُفعَّل الدولة ويُقبَل نوع المرسل ويُعتَمَد أي تسجيل مطلوب،
ابدأ الإرسال.
صيانة مصدر القواعد (مشغّلو المنصة)
هذا القسم لـ مشغّلي المنصة والتنفيذات المستضافة ذاتيًا. عملاء SaaS
على
api.orbit.devotel.io يمكنهم التوقف هنا — Devotel تُبقي قواعد
الدول محدثة لك، والمقابض أدناه محصولة على إداريي المنصة.403، لأن جدول القواعد عام عبر كل المستأجرين، لا بيانات لكل مستأجر.
مصادر الخلاصة
كل صف يسجلsync_source أي خلاصة أحدثته أخيرًا. ستة مزوّدين يتصلون بمقبض المزامنة:
خلاصتان متجاورتان تغذّيان جدولين خاصين بهما:
- تغطية Telnyx لمصفوفة هويات المرسل القديمة — مقابض القراءة وراء
مصفوفة امتثال هويات المرسل ترسم من جدول قديم منفصل. احدِثه بـ
POST /api/v1/compliance/admin/sync(إداري فقط؛ نفس المجدول الأسبوعي يحدثه أوتوماتيكيًا أيضًا). - قاعدة بيانات الأرقام المعاد تعيينها (RND) — بوابة الرقم الأمريكي
المفصل المذكورة تحت
فحص إلغاء التفعيل. المستأجرون تُفعّلونه
لكل مستأجر عبر
PUT /api/v1/compliance/rnd/settingsمع{ "enabled": true }؛ لا يقبل المفتاح التشغيل حتى يكون مشغّل قد حمّل لقطة RND في التنفيذة، كي لا يستطيع المستأجرون الاشتراك في بوابة فارغة.
شغل مزامنة رسمية
POST /api/v1/compliance/country-rules/sync يحدّث من مزود واحد. اختر الخلاصة بـ ?provider= (الافتراضي telnyx) وربما حدّد نطاقك بـ ?channel= واحدة.
upstreamCount وupdated وcreatedNew ومصفوفة errors. إن مزامنة لا تكتب فوق النص الذي حرّره المشغّل أبدًا — فقط الحقول الهيكلية (اسم الدولة، ورمز النداء، والمنطقة، وأنواع المرسلين، ومستوى التسجيل) تُحدَّث؛ الحقول النصية الحرة (sender_rules وcontent_restrictions وnotes) تحفظ ما كتبه مشغّل آخر مرة.
كادِنس الخلاصة
مسأران يُبقيان الجدول محدثًا:- المجدول الأسبوعي — تكت مزامنة الامتثال في عامل webhook يشغّل خلاصات Telnyx وMEF وGSMA أوتوماتيكيًا. ويشغّل أيضًا مرة عند بدء العامل، فتزرع التنفيذة الجديدة نفسها أول إقلاع.
- عند الطلب — فعل إدارة “Refresh from upstream” يطلب مقبض المزامنة أعلاه لجذب فوري (مفيد بعد أن توّفر بيانات اعتمادية لخلاصة جديدة).
last_synced_at الذي يعيده مقبض القراءة جانب الصفوف. التحريرات اليدوية تختيم بدلاً من ذلك last_reviewed_at، فيظهر لوحة التحكم منبع (“مُزامَن من MEF منذ 3 أيام؛ مُراجَع من الإداريين أمس”) بدلاً من ختم زمني واحد مبهم.
معالجة الفشل
كل موصل اختياري ومحوِّل للأعطال (fail-open): عندما يكون متغير بيئته غير مضبوط تسجل المزامنة رسالة تجاوز وتعيد إدخالاً فيerrors، والصفوف الموجودة تبقى في مكانها. الشيء نفسه ينطبق على عطل أعلى المنبع — تحمل الاستجابة نص الخطأ بينما تبقى البيانات المزامَنة سابقًا قابلة للقراءة. هذه خلاصات ميتاداتا للقراءة فقط على مسار بحث؛ يواصل الرسائل الصادرة التوجه عبر مرسلك العادي بينما تكون خلاصة عاطلة.
تحرير دولة واحدة
PUT /api/v1/compliance/country-rules/:channel/:country_code يحلّ صف دولة واحدة × قناة واحدة. استخدمه لإمداد تفاصيل لا تحملها أي خلاصة — مثلاً صياغة كلمة STOP أو حدود الإنتاجية الملتقط من نص المنظم. بيانات اعتماد إداري المنصة مطلوبة؛ إداريو المستأجر يستلمون 403.
sender_types وregistration (none / recommended / required) وsender_rules وcontent_restrictions وstop_requirement وtwo_way وdlr_support وdefault_tps وnotes وsources (قائمة [{ label, url }] من روابط التناسب). الإحلال يختيم last_reviewed_at ويختم الصف sync_source: manual، فتحدّث مزامنة آلية قادمة فقط الحقول الهيكلية وتحفظ نصك.
قائمة تحقق الإحصاء قبل أن تنقلب دولة حيّة
قبل أن تُشغل دولة للإرسال، تأكد:1
ختم مزامنة طازج
last_synced_at (أو last_verified_at للمصفوفة القديمة) حديث —
وإلا شغّل المزامنة عند الطلب للأن provider المعني قبل التفعيل.2
مستوى التسجيل الصحيح
registration مضبوط (none / recommended / required). دولة
required تحظر الحركة غير المسجلة عند الإرسال، فمُراجعة تسجيل
مفقودة تعني إرسالات فاشلة، لا مؤجلة.3
حقول النص مُراجَعة
stop_requirement وcontent_restrictions تقولان ما يجب — الخلاصات فقط
تُحسّن الهيكل، فيجب أن يضبط المشغّل النص.4
نوع المرسل مقبول
على الأقل واحد من
sender_types للدولة يطابق ما تخطط الإرسال منه.5
البوّابات المعنية محمَّلة
إذا كانت الوجهة لها بوابة RND أو جيدير DLT (US RND، وDTI للهند),
تأكد أن تلك الخلاصة محمّلة أيضًا — راجع
فحص إلغاء التفعيل وتأهيل DLT-India.
مراجع ذات صلة
- الصناعات المقيَّدة والمحظورة — أي الصناعات والمحتوى مقيَّد أو محظور.
- تسجيل هوية المرسل — قدّم وتتبّع تسجيلات هوية المرسل لكل دولة.
- تأهيل DLT-India — نظام TRAI DLT للهند.
- تسجيل 10DLC — إثبات العلامة والحملة الأمريكية A2P (يتضمن تهيئة خلاصة قواعد الدول للمشغّلين).
- Send Gates — البوّابات التي تنفّذ هذه القواعد عند الإرسال.
- إشارات الشبكة قبل أن ترسل — رشّ المستلمين بإشارات تبديل الشريحة والتجوال والمخاطر المؤكدة من المشغّل قبل أول إرسال إلى وجهة جديدة.
- مرجع API → الامتثال — مخططات الطلب/الاستجابة الكاملة.