قواعد الانسحاب والانضمام عبر SMS
صفحة Opt-out & opt-in rules هي حيث تدير كلمات SMS المفتاحية الواردة التي تلغي اشتراك شخص (opt-out) أو تعيد اشتراكه (opt-in)، ونص الرد التلقائي الذي ترسله كل كلمة. افتحها من مساحة عمل SMS عبر Messages → SMS → شريط الأدوات: Opt-out Rules، أو مباشرة على/messages/sms/opt-out-rules.
النسخة الإنجليزية الأصلية: SMS opt-out & opt-in rules.
من يستطيع فتح الصفحة
الصفحة مقتصرة على أدوار owner وadmin وdeveloper. تحصل أدوار billing وviewer وsupervisor بدل ذلك على شاشة “ليس لديك وصول”. إذا ظهر محرر الكلمات المفتاحية باهتًا لأحد زملائك، تحقق من دوره في إعدادات المنظمة.ما تضبطه كل قاعدة
كل قاعدة كلمة مفتاحية والرد التلقائي الذي ترسله، في إحدى مجموعتين:- كلمات الانسحاب — تلغي اشتراك الشخص (STOP وCANCEL وما شابه).
- كلمات الانضمام — تعيد اشتراك الشخص (START وYES وما شابه).
التحرير محلي حتى تنقر Save Rules. حذف صف يطلب تأكيدًا أولًا، ومغادرة الصفحة بتعديلات غير محفوظة تفتح مطالبة تجاهل — إعادة التحميل أو علامة التبويب المغلقة تستخدم بدل ذلك حارس المتصفح الخاص “مغادرة الموقع؟”.
تسميات اللغات إرشادية
كلمة مفتاحية معترفًا بها كمصطلح انسحاب مترجم (STOP وALTO وSTOPPER وSCHLUSS وPARAR وDUR وما شابه) تعرض لغتها والأسواق التي تشيع فيها — كتلميح، لا كمرشح. قاعدةALTO تتصرف تمامًا كقاعدة STOP وتنطبق على كل رقم قابل للرد.
مسار مخصص، لا طبقة فوقية
كان هذا المحرر يعيش داخل قائمة رسائل SMS — أولًا مكدسًا فوق جدول سجل الرسائل، ثم كلوحة منزلقة تُفتح من شريط أدوات القائمة. كان الشكلان يركّبان إدارة الامتثال داخل عرض عمليات الرسائل، ما جعل مساحة العمل صعبة القراءة. المحرر الآن مسار مستقل، يُبلغ بتنقل حقيقي من شريط أدوات SMS — لم تعد قائمة الرسائل تضمّنه إطلاقًا. حين تخطط لتغيير تخطيط كهذا في تكاملاتك، حافظ على الفصل نفسه: عمليات الرسائل في مسار، وإعدادات الامتثال في آخر.أين تنطبق القواعد
يذكر شريط أعلى الصفحة النطاق صراحة:- على مستوى الحساب. تنطبق القواعد على الردود الواردة على كل رقم قابل للرد (رمز طويل أو رمز قصير يقبل SMS واردًا) في حسابك. ليست مرتبطة بخدمة مراسلة، فلا تحتاج إلى إرفاق واحدة لتعمل.
- لكل خدمة مراسلة. تحتفظ كل خدمة بقائمة قمع انسحاب خاصة بها، تُدار على الخدمة — انظر Custom Opt-Out Keyword Lists.
- لكل رقم. يُتعرف على رد الكلمة المفتاحية فقط على رقم قابل للرد. هوية المرسل الأبجدية الرقمية لا تستقبل ردودًا، لذا لا تنطلق معالجة الكلمات المفتاحية أبدًا لأولئك المرسلين. تعرض الصفحة أي أرقامك مؤهلة وتحذر حين لا يؤهل أي منها.
الدمج مع مجموعة STOP/START المنصّية
قواعدك إضافية فقط فوق مجموعة الكلمات المفتاحية المفروضة من النواقل على مستوى المنصة. حذف كل قواعد STOP من الصفحة يترك STOP معالجًا في طبقة المنصة — تفرضه TCPA وCTIA، ويفرضه Orbit بصرف النظر عما يضبطه مستأجر. يمكن لقواعدك توسيع سطح الإطلاق (اسم مستعار مثلCANCELAR أو انضمام بعلامة تجارية مثل REJOIN) لكن لا تضييقه أبدًا.
الافتراضيات المزروعة
عند أول فتح، تزرع الصفحة مجموعة افتراضية متعددة اللغات — STOP / UNSUBSCRIBE / CANCEL / QUIT / END، وALTO بالإسبانية، وSTOPPER بالفرنسية، وSCHLUSS بالألمانية، وPARAR بالبرتغالية، وDUR / IPTAL / RED بالتركية، كل منها برد تلقائي مترجم، إضافة إلى أزواج انضمام (START وYES وSUBSCRIBE وSI / OUI / JA / SIM / EVET المترجمة). ولأن الافتراضيات حتمية، يظهر صفALTO مزروع في كل مساحة عمل حتى تحرره وتحفظه.
قلّم الصفوف التي لا تستخدمها جمهورك، أو أضف أسماء مستعار إقليمية كقواعد جديدة — لكن أبقِ مسار انسحاب واحدًا على الأقل لكل لغة ترسل بها. الكلمة الانسحابية التي يدققها منظم ليست إلا إضافة إلى مجموعة المنصة؛ حذف نسختك المزروعة منها لا يفعل شيئًا على أي حال.
الإرفاق والاختبار
تنطبق القواعد تلقائيًا على كل رقم قابل للرد؛ لا شيء ليُرفق. لإثبات أن قاعدة انطلقت:- أرسل الكلمة المفتاحية نصيًا إلى أحد أرقامك القابلة للرد من هاتف محمول.
- يعرض Inbox الدورة الواردة والرد التلقائي في المحادثة نفسها.
- يعرض ملف الشخص حالة الموافقة المقلوبة، مع تسجيل الكلمة المفتاحية في سجل الموافقة؛ وتدرج واجهة Opt-Outs السجل.
- يتتبع سجل التسليم ردك التلقائي عبر
queued → sent → delivered.
الجولة الكاملة: قمع → محاولة إرسال → إعادة انضمام
قواعد الكلمات المفتاحية أعلاه تغطي الجانب الوارد — يرسل شخص STOP وتنقلب الموافقة. يمكنك قيادة دورة الحياة نفسها كليًا عبر الـ API: اقمع شخصًا برمجيًا، وراقب بوابة وقت الإرسال ترفض رسالة إلى ذلك الشخص، ثم أعد اشتراك الشخص وأرسل من جديد. يجري هذا القسم الجولة الكاملة ضد رقم اختبار؛ وتغطي مرجعية Opt-Outs API معلمات كل نقطة نهاية وبوابات أدوارها.القمع والموافقة ضوابط ملك للمستأجر — حسابك يقرر ما يعد انسحابًا، بنطاق محصور في سجلاك. الاستثناء الوحيد على مستوى المنصة هو معالجة الكلمات المفتاحية STOP/START المفروضة من الناقل المشروحة أعلاه، والتي لا يستطيع أي ضبط مستأجر إزالتها.
1. قمع الشخص
أنشئ صف انسحاب لرقم الهاتف والقناة. حقلcontact هاتف E.164 (أو بريد إلكتروني)؛ تحلّه المنصة إلى صف شخص قائم أو تنشئ صف شخص فارغًا جديدًا بنطاق مستأجرك.
cURL
201 Created، وإعادة تطبيق الانسحاب نفسه تعيد 200 OK مع already_opted_out: true.
201 Created (أو 200 OK عند إعادة التطبيق)
request() في الـ SDK):
2. حاول إرسالًا — ترفضه البوابة
الآن أرسل SMS إلى الرقم المقموع. تتحقق بوابة الامتثال في مسار الإرسال من علم انسحاب القناة قبل وضع الرسالة في الطابور، فلا ينطلق الطلب أبدًا نحو الأسفل:cURL
error.code === "RECIPIENT_OPTED_OUT" في شيفرة مرسلك وعامله بوصفه موثوقًا — إعادة المحاولة بينما العلم مضبوط تعيد الـ422 نفسها. سجّل meta.request_id عند كل رفض؛ فهو كيف يربط الدعم رفضًا بالأثر في جهة الخادم. تعاد تلقائيًا أي حصة استهلكها إرسال مرفوض، وتتخطى إرسالات الحملات المستلم المقموع بدل رفضه (تبقى الدفعة تحرّك بقية المستلمين) مع تسجيل التخطي على صف الرسالة — انظر مرجع Message Status Lifecycle.
3. أزل القمع وأرسل من جديد
احذف صف الانسحاب لمعرف الشخص والقناة — هذا هو إعادة الانضمام:cURL
contact.opted_in مع القناة.
أعد POST جسم الرسالة نفسه تمامًا من الخطوة 2. تجتاز البوابة الآن ويوضع الإرسال في الطابور:
202 Accepted
queued → sent → delivered عبر id؛ حالات الانتقال مذكورة في صفحة Message Status Lifecycle.
يمسح
DELETE القمع داخل Orbit فقط — channel_preferences للشخص وقائمة القمع لديك. يمكن لناقل أميركي/كندي أن يحتفظ بحظر انسحاب خاص به مستقلًا عن سجلات Orbit؛ إذا ظل شخص معاد انضمامه غير قابل للبلوغ عبر SMS، فحلّ ذلك الحظر عبر قناة التحقق المجاني/دعم الناقل، لا عبر هذا الـ API.