> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# قوائم كلمات إلغاء الاشتراك المخصصة

> قم بتكوين كلمات STOP و HELP و START المخصصة للعلامة التجارية في Orbit مع نص الرد الآلي، ثم اربط القائمة بخدمة رسائل.

# قوائم كلمات إلغاء الاشتراك المخصصة

يحصل كل مستأجر Orbit افتراضيًا على معالجة STOP / HELP / START التي تفرضها شركات الجوال. تتجاوز قائمة إلغاء الاشتراك ذلك عندما ترسل تحت أكثر من علامة تجارية أو بأكثر من لغة: عرّف أسماء كلمات إضافية ونص رد آلي مخصص، ثم اربط تلك القائمة بـ[خدمة الرسائل](/api-reference/messaging-credentials) التي يجب أن تستخدمها. خدمة الرسائل التي لا توجد قائمة مرتبطة بها تبقى على الإعدادات الافتراضية للمنصة.

قائمة نقطة النهايات الكاملة أدناه؛ تغطي هذه الصفحة المفاهيم وكيفية استخدام الحقول.

> النسخة الإنجليزية الأصلية: [Custom Opt-Out Keyword Lists](/guides/opt-out-lists).

## متى تحتاج إلى واحدة

استخدم قائمة إلغاء اشتراك مخصصة عندما:

* ترسل **تحت عدة علامات تجارية** من حساب Orbit واحد وتريد أن يكون رد STOP لكل علامة تجارية مثل تلك العلامة («لقد ألغيت اشتراكك في تنبيهات Acme Travel.» مقابل «لقد ألغيت اشتراكك في تذكيرات Acme Pharmacy.»).
* يكتب جمهورك **بلغة أو لكنة** لا تغطي كلمات إلغاء الاشتراك لها في الإعدادات الافتراضية — يمكنك إضافة أسماء محلية دون فقدان الكلمات الإلزامية.
* تريد **نص HELP مخصصًا للعلامة التجارية** («رد HELP للدعم، أو اتصل بـ 1-800-…») بدلاً من الافتراضي العام.

## ما يمكنك تغييره وما لا يمكنك

مصفوفات الكلمات لكل قائمة **إضافية فقط**. يدمج مُطابق Orbit كلمات قائمتك مع المجموعة الافتراضية الإلزامية من شركات الجوال — يمكنك توسيع سطح التفعيل (إضافة `"CANCEL"` أو كلمة محلية بجانب `STOP`) لكنك لا تستطيع إزالة `STOP` نفسه. تتطلب TCPA و CTIA ذلك، و Orbit تفرضه على مستوى المنصة بغض النظر عن ما يكوّنه المستأجر.

## إنشاء قائمة

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messaging/opt-out-lists \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Acme Travel — ES",
    "stop_keywords": ["BAJA", "CANCELAR"],
    "help_keywords": ["AYUDA"],
    "stop_response": "Has cancelado las alertas de Acme Travel. Responde AYUDA para soporte.",
    "help_response": "Acme Travel: responde BAJA para cancelar, o llama al 1-800-555-0100.",
    "default_lang": "es",
    "brand": "Acme Travel"
  }'
```

| الحقل                                                | ملاحظات                                                                             |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `label`                                              | اسم قائمتك، يظهر في لوحة التحكم.                                                    |
| `stop_keywords` / `help_keywords` / `start_keywords` | لف إلى 32 إدخال لكل منها، إضافية على الإعدادات الافتراضية للمنصة.                   |
| `stop_response` / `help_response` / `start_response` | نص الرد الآلي المرسل عند تفعيل الكلمة المطابقة، حتى 1,600 حرف (حوالي 10 أجزاء SMS). |
| `default_lang`                                       | أحد `en`, `tr`, `de`, `es`, `fr`, `pt`, `it`, `ar`, `nl`.                           |
| `brand`                                              | نص العلامة التجارية الحر لمراجعتك وتقاريرك.                                         |

## رموز اللغات المدعومة

يقبل حقل `default_lang` رمز ISO 639-1 واحدًا ويحدد لغة قالب الرد الآلي، إضافة إلى اللغة المستخدمة عندما تكون لغة جهة الاتصال الواردة غير معروفة. تدعم المنصة تسعًا:

| الرمز | اللغة      |
| ----- | ---------- |
| `en`  | الإنجليزية |
| `tr`  | التركية    |
| `de`  | الألمانية  |
| `es`  | الإسبانية  |
| `fr`  | الفرنسية   |
| `pt`  | البرتغالية |
| `it`  | الإيطالية  |
| `ar`  | العربية    |
| `nl`  | الهولندية  |

عند عدم ارتباط قائمة وعدم معرفة اللغة، يتم المطابقة عبر كل مجموعة كلمات في التسلسل — المطابقة الزائدة لرد إلغاء اشتراك وارد مقصودة (أسوأ الحالات: رسالة «DUR» شرعية تعتبر إلغاء اشتراك؛ هذا آمن قانونًا).

## أسماء شائعة (حسب اللغة)

أضف هذه الإدخالات الإضافية تحت مصفوفة `stop_keywords` (أو `help_keywords` / `start_keywords`) في قائمتك عندما يستخدمها جمهورك. هذه أمثلة على إضافات جانب المستأجر؛ الإعدادات الافتراضية المذكورة أعلاه تنطبق دائمًا.

| اللغة      | أسماء جانب المستأجر للنظر فيها                       |
| ---------- | ---------------------------------------------------- |
| التركية    | `CIKIS` (متغير ASCII), `IPTAL`, `IPTAL ET`, `DURDUR` |
| الألمانية  | `ABMELDEN`, `STOPP`, `ABBESTELLEN`, `ENDE`           |
| الفرنسية   | `STOP`, `ARRET`, `ARRÊT`, `ANNULER`                  |
| العربية    | `إلغاء`, `أوقف`, `توقف`, أو الإنجليزية `STOP`        |
| الهولندية  | `STOPPEN`, `UITSCHRIJVEN`, `OPZEGGEN`                |
| الإسبانية  | `BAJA`, `CANCELAR`, `SALIR`                          |
| البرتغالية | `PARAR`, `CANCELAR`, `SAIR`                          |
| الإيطالية  | `FERMA`, `CANCELLA`, `FINE`                          |

المطابقة غير حساسة لحالة الأحرف وتتحمل التطبيع NFC — تنطوي العلامات والحروف نفس الهدف للكلمة، وتُدمج الفراغات الداخلية قبل المقارنة.

## ربط قائمة بخدمة رسائل

القائمة لا تُفعَّل إلا بعد ربطها بـ[خدمة رسائل](/api-reference/messaging-credentials) — هوية الإرسال التي يتم من خلالها إرسال حملة أو تدفق فعليًا:

```bash theme={null}
curl -X PATCH https://api.orbit.devotel.io/api/v1/messaging/services/msvc_abc123 \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "opt_out_list_id": "ool_abc123" }'
```

كل خدمة رسائل يجب أن تستخدم نفس كلمات ونص العلامة التجارية، توجه `opt_out_list_id` لنفس القائمة. افصلها بتعيين `opt_out_list_id` إلى `null`، مما يعيد للخدمة الإعدادات الافتراضية للمنصة.

## قوائم إلغاء الاشتراك مقابل قوائم الحظر مقابل إلغاءات جهات الاتصال

هذه ثلاث طبقات مختلفة يسهل الخلط بينها:

* **قوائم إلغاء الاشتراك (هذه الصفحة)** تكوّن *كيف يتم التعرف على رد STOP/HELP/START والرد عليه* — طبقة مطابقة الكلمات والرد الآلي.
* **[إلغاء الاشتراك وقوائم الحظر](/compliance/opt-out-suppression)** تغطي قائمة الحظر المدمجة من جانب الامتثال — استيراد جزائياً العناوين التي يجب عدم مراسلتها مرة أخرى، مثلاً عند الترحيل من منصة أخرى.
* **[API إلغاء الاشتراك](/api-reference/optouts)** هو سجل من ألغى اشتراكه فعليًا لكل جهة اتصال وكل قناة — الذي يُفحص قبل كل إرسال.

مجموعة كلمات STOP أوسع (هذه الصفحة) تزيد عدد الردود الواردة التي يُـ*تعرَّف* عليها كإلغاء اشتراك؛ الحظر الفعلي يتم عبر سجل إلغاء اشتراك الجهة الذي يكتبه.

## نقاط النهاية

| الطريقة  | المسار                                 | الغرض                              |
| -------- | -------------------------------------- | ---------------------------------- |
| `GET`    | `/api/v1/messaging/opt-out-lists`      | سرد قوائم إلغاء الاشتراك الخاصة بك |
| `POST`   | `/api/v1/messaging/opt-out-lists`      | إنشاء قائمة                        |
| `GET`    | `/api/v1/messaging/opt-out-lists/{id}` | الحصول على قائمة                   |
| `PATCH`  | `/api/v1/messaging/opt-out-lists/{id}` | تحديث قائمة                        |
| `DELETE` | `/api/v1/messaging/opt-out-lists/{id}` | حذف قائمة                          |

## انظر أيضًا

* [إلغاء الاشتراك وقوائم الحظر](/compliance/opt-out-suppression) — استيراد قائمة الحظر المدمج للعناوين التي يجب عدم مراسلتها مرة أخرى
* [فحص DNC](/compliance/dnc-scrub) — فحص جهات الاتصال مقابل سجلات "لا تتصل" الوطنية قبل إرسال الحملة
* [مرجع API إلغاء الاشتراك](/api-reference/optouts) — سجلات إلغاء الاشتراك لكل جهة اتصال
* [بيانات اعتماد وخدمات الرسائل](/api-reference/messaging-credentials) — ربط قائمة عبر `opt_out_list_id`
* [خدمات إرسال SMS](/guides/sms-services) — الخدمة التي تُربط بها القائمة، من البداية إلى النهاية