​

إلغاء الاشتراك وقوائم الحظر

​

كيف يحدث الحظر

• ردّ جهة اتصال بكلمة STOP المفتاحية على SMS/WhatsApp.
• إلغاء اشتراك جهة اتصال عبر مركز التفضيلات.
• تسجيل إلغاء اشتراك عبر Consent API (opt_in: false).
• استيراد قائمة جماعياً (هذه الصفحة).

• الاستيراد الجماعي عبر CSV يستنتج النطاق من نوع العنوان في كل صف: عناوين الهاتف وWhatsApp تكون افتراضياً بنطاق all — إشارة STOP على رقم هاتف تحظر كل قناة يمكن الوصول إليها على ذلك الرقم — بينما عناوين البريد الإلكتروني تُنطِق بـ email. عمود channel يتجاوز هذا لكل صف (انظر استيراد CSV جماعي).
• Consent API ومركز التفضيلات يحظران دائماً النطاق all، بغض النظر عما إذا كان المعرف المسجَّل رقم هاتف أو عنوان بريد إلكتروني. إلغاء الاشتراك عبر أي من هاتين نقطتي الدخول يزيل جهة الاتصال من كل قناة.

​

استيراد CSV جماعي

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/suppression-list/import \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -F "file=@suppressions.csv" \
  -F "default_country=US" \
  -F "default_reason=migrated_from_legacy_platform" \
  -F "dry_run=false"

​

حقول النموذج

​

تنسيق CSV

phone,email,reason
+14155550101,,replied STOP
,jordan@example.com,unsubscribed via email
+442071838750,sam@example.co.uk,complaint

​

نتائج كل صف

{
  "data": {
    "run_id": "supimp_4d…",
    "total_rows": 1000,
    "accepted": 950,
    "duplicates": 30,
    "intra_file_duplicates": 15,
    "invalid": 5,
    "errors": [
      { "status": "invalid", "reason": "invalid_phone", "raw_line": 42 }
    ],
    "by_channel": { "all": 800, "email": 150 },
    "file_sha256": "9b2e…"
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

​

أسباب التحقق

​

الحدود

​

عند فشل الاستيراد

​

الاستيراد من لوحة التحكم

1. اختر ملف CSV — اختر .csv أقل من 25 ميغابايت. استخدِم Download sample CSV في الحوار للحصول على ملف بداية مُنسَّق مسبقاً.
2. عيِّن الافتراضيات (اختياري) — Default country (ISO alpha-2) لمعايرة الأرقام بالصيغة الوطنية، ونص حر Reason يُختَم على كل صف مقبول.
3. معاينة — يُشغِّل الاستيراد كتشغيل تجريبي من جهة الخادم: لا يُكتَب شيء، ويعرض الحوار تفصيل المقبول / المُدرَج مسبقاً / التكرارات داخل الملف / غير الصالح قبل أن تُثبِّت.
4. تأكيد الاستيراد — ينفِّذ الكتابة المُثبِّتة. إذا كانت أي صفوف غير صالحة، قم بتنزيل skipped.csv لتصحيحها وإعادة استيرادها.

​

تصدير قائمة الحظر

curl "https://api.orbit.devotel.io/api/v1/compliance/suppression-list/export?format=csv&status=active" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -o suppression-list.csv

​

التحقق من نفاذ الحظر

1. أرسِل رسالة اختبار إلى العنوان المحظور. الإرسال المباشر عبر API إلى مستلم محظور يَفشَل تزامنياً مع HTTP 422 ورمز الخطأ RECIPIENT_OPTED_OUT. في وضع sandbox لا تُلمَس أي شركة اتصالات ولا يُخصَم أي رصيد؛ وأي مستلم ينتهي بـ 8 يُحَال أيضاً إلى إيصال التسليم المحاكى blocked، وهي رؤية جانب شركة الاتصالات لنفس الحاجز.
   curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
     -H "X-API-Key: $ORBIT_SANDBOX_KEY" \
     -H "Content-Type: application/json" \
     -d '{"to": "+14155550101", "from": "+15005550101", "body": "gate check"}'
   
   {
     "error": {
       "code": "RECIPIENT_OPTED_OUT",
       "message": "Recipient has opted out of this channel"
     }
   }
   
   إرسال حملة إلى نفس العنوان يتصرّف بشكل مختلف تصميمياً: يُتخطَّى المستلم بصمت (status: "skipped"، reason: "opted_out") حتى تستمر الدفعة — افحص تقرير الحملة لكل مستلم بدلاً من توقُّع خطأ.
2. أكِّد أن الإدخال موجود على السجل. صدِّر بـ الاستعلام أعلاه (status=active هو الافتراضي) وتحقّق من ظهور العنوان بنطاق channel المتوقَّع. التصدير هو مصدر الحقيقة الذي تقرأ منه كل بوابة إرسال — إذا كان الصف active هناك، فالحاجز قائم.

​

إزالة الحظر (إعادة الاشتراك)

​

مراجع ذات صلة

• إدارة الموافقة — تسجيل الموافقة لكل قناة والبحث عنها.
• بوابات الإرسال — ساعات الهدوء وDNC وRND وRMD والإيقاف الطارئ ومركز التفضيلات.
• DSAR — كيف تصل طلبات delete / opt_out إلى الحظر.
• مرجع API ← إلغاء الاشتراك — مخططات نقاط نهاية إلغاء الاشتراك والحظر.