> ## 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.

# تسجيل مُعرِّف المُرسِل (Sender ID)

> سجِّل مُعرِّفات المُرسِل الأبجدية الرقمية (Sender ID) لكل دولة على Orbit، وتتبَّع حالة الموافقة، وافهم سبب حظر بعض الوجهات للمُرسِلين غير المسجَّلين.

# تسجيل مُعرِّف المُرسِل (Sender ID)

**مُعرِّف المُرسِل الأبجدي الرقمي (alphanumeric Sender ID)** هو اسم علامة تجارية قصير (على سبيل المثال
`MyBrand`) يظهر كمُرسِل في رسالة SMS بدلاً من رقم هاتف. تتطلب العديد من الدول
**تسجيل** مُعرِّف المُرسِل لدى الجهة التنظيمية المحلية أو شركات الاتصالات قبل
تسليم الرسائل التي تستخدمه — بل إن بعض الدول تحظر المُرسِلين الأبجديين غير
المسجَّلين كلياً.

تتيح لك Orbit تسجيل عمليات تسجيل مُعرِّفات المُرسِل لكل دولة، وإرفاق مستندات KYC
الداعمة، وتتبُّع حالة الموافقة لكل دولة. ثم تفرض بوابات وقت الإرسال مرور
الحركة فقط حيث يكون مُعرِّف المُرسِل معتمداً.

جميع نقاط النهاية أدناه متجذّرة في
`https://api.orbit.devotel.io/api/v1/compliance`.

<Note>
  تسجيل مُعرِّف المُرسِل في Orbit يُدخِله في سير عمل الامتثال لدينا؛
  **الموافقة النهائية تمنحها الجهة التنظيمية/شركة الاتصالات في كل دولة**،
  وليست فورية من المنصة. خطِّط لفترة زمنية مُسبَقة — بعض الأسواق تستغرق
  من أيام إلى أسابيع.
</Note>

***

## قواعد تنسيق مُعرِّف المُرسِل

| القاعدة            | القيمة                                            |
| ------------------ | ------------------------------------------------- |
| الطول              | 3–11 حرفاً                                        |
| الأحرف المسموح بها | أحرف، أرقام، مسافة، واصلة (`-`)، شرطة سفلية (`_`) |

الحد الأقصى البالغ 11 حرفاً هو الحد الصلب لترميز GSM 7-bit؛ وتقوم جهات
تنظيمية مثل ANATEL (البرازيل) وOFCOM (المملكة المتحدة) وAGCOM (إيطاليا)
وBTRC (بنغلاديش) برفض مُعرِّفات المُرسِل الأقصر من 3 أحرف.

***

## تسجيل مُعرِّف مُرسِل أو تحديثه

`POST /compliance/sender-id-registrations` (مسؤول/مالك) يُرسل مُعرِّف مُرسِل
لدولة واحدة أو أكثر. كل إدخال دولة يشير إلى مستندات امتثال مرفوعة سابقاً
بواسطة مُعرِّفات `doc_…` الخاصة بها — لا تقوم برفع ملفات هنا.

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/sender-id-registrations \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "document_refs": ["doc_abc123def456"],
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  }'
```

| الحقل                                  | النوع     | الملاحظات                                                              |
| -------------------------------------- | --------- | ---------------------------------------------------------------------- |
| `sender_id`                            | string    | من 3–11 حرفاً، راجع قواعد التنسيق أعلاه.                               |
| `countries`                            | array     | من 1–20 إدخالاً.                                                       |
| `countries[].country`                  | string    | ISO-3166-1 alpha-2 (أحرف كبيرة).                                       |
| `countries[].document_refs`            | string\[] | من 1–20 مُعرِّفاً من النمط `doc_…` يشير إلى مستندات KYC مرفوعة سابقاً. |
| `countries[].registration_provider_id` | string    | مرجع اختياري لمزوِّد لاحق (≤ 200).                                     |
| `countries[].notes`                    | string    | نص حر اختياري، مثل حالة الاستخدام (≤ 2000).                            |

يُعيد عرض التسجيل مع حالة `status` لكل دولة:

```json theme={null}
{
  "data": {
    "id": "sidreg_xyz",
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "status": "pending",
        "document_refs": ["doc_abc123def456"],
        "registered_at": null,
        "expires_at": null,
        "registration_provider_id": null,
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}
```

الإرسال هو **عملية upsert غير مؤتلفة (idempotent upsert)** مُفتَّحة على
`(organization, sender_id)`. إعادة الإرسال:

* تُضيف دولاً جديدة بحالة `status: pending`؛
* بالنسبة لدولة معتمدة `approved` سابقاً، **تحتفظ بالموافقة** أثناء تحديث
  مستنداتها ومرجع المزوِّد وملاحظاتها؛
* بالنسبة لدولة كانت `rejected` أو `expired`، **تُعيد ضبطها إلى `pending`**
  بحيث تُراجَع من جديد.

يتيح لك ذلك إضافة دول بأمان إلى مُعرِّف مُرسِل موجود دون فقدان الموافقات
التي تملكها بالفعل.

***

## سرد تسجيلاتك

`GET /compliance/sender-id-registrations` تُعيد كل مُعرِّف مُرسِل وحالته
لكل دولة. متاحة لأي مستخدم مُصادَق عليه.

```json theme={null}
{
  "data": {
    "entries": [
      {
        "id": "sidreg_xyz",
        "sender_id": "MyBrand",
        "countries": [
          {
            "country": "BR",
            "status": "approved",
            "document_refs": ["doc_abc123def456"],
            "registered_at": "2026-06-05T00:00:00.000Z",
            "expires_at": "2027-06-05T00:00:00.000Z"
          }
        ]
      }
    ],
    "total": 1
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}
```

***

## دورة حياة الحالة

| الحالة     | المعنى                                                        |
| ---------- | ------------------------------------------------------------- |
| `pending`  | مُرسلة، بانتظار المراجعة/الموافقة.                            |
| `approved` | مُعتمدة — الرسائل بهذا المُعرِّف مسموح بها للدولة.            |
| `rejected` | مرفوضة؛ صحّح المشكلة وأعد الإرسال لإعادة ضبطها إلى `pending`. |
| `expired`  | انتهت نافذة صلاحية التسجيل؛ أعد الإرسال للتجديد.              |

عندما يكون إدخال الدولة `approved` فإنه يحمل `registered_at` و`expires_at`.
جدِّد قبل `expires_at` لتجنُّب انقطاع.

<Warning>
  بوابات وقت الإرسال تُنفِّذ التسجيل: رسائل A2P SMS الموجَّهة إلى دولة
  تتطلب مُعرِّف مُرسِل مسجَّلاً تُحظَر **ما لم يكن إدخال تلك الدولة
  `approved`**. سجِّل واحصل على الموافقة قبل بدء الرسائل إلى سوق جديدة.
</Warning>

<Note>
  في المستأجرين (tenants) الذين أُنشئوا قبل ترحيل مُعرِّف المُرسِل، تُعيد
  نقطة النهاية الخاصة بالسرد مجموعة فارغة، ويُعيد `POST` الرمز
  `409 TENANT_NOT_MIGRATED` — اتصل بالدعم لتمكين الميزة.
</Note>

***

## الهند مختلفة

الهند **لا** تستخدم سير مُعرِّف المُرسِل العام هذا. تُسجَّل مُعرِّفات
المُرسِل لرسائل SMS الهندية ("Headers") عبر نظام DLT/TRAI —
راجع [إعداد DLT-الهند](/compliance/dlt-india).

***

## مراجع ذات صلة

* [مستندات KYC ودورة حياة ملف الامتثال](/compliance/documents-kyc) —
  كيفية رفع مُعرِّفات `doc_…` التي تشير إليها هنا، وإعادة استخدامها عبر
  ملفات التعريف، وتجديدها قبل انتهاء صلاحيتها.
* [متطلبات الامتثال حسب الدولة](/compliance/country-requirements) —
  أي أنواع المُرسِلين تقبلها كل دولة وما إذا كان التسجيل مطلوباً،
  بالإضافة إلى المستندات الواجب تقديمها.
* [استكشاف مشكلات رفض وضع مُعرِّف المُرسِل الصارم](/troubleshooting/strict-sender-id-invalid-destination) —
  بوابة تنسيق المُرسِل الاختيارية (opt-in) ورموز القواعد التي تُعيدها عند
  وجود مُرسِل مخالف.
* [إعداد DLT-الهند](/compliance/dlt-india) — تسجيل مُعرِّف المُرسِل
  ("Header") للهند.
* [بوابات الإرسال (Send Gates)](/compliance/send-gates) — قواعد الدولة
  والبوابات التي تُنفِّذ التسجيل في وقت الإرسال.
* [إدارة الموافقة (Consent Management)](/compliance/consent-management) —
  طبقة الموافقة التي تُقترن بالامتثال الخاص بمُعرِّف المُرسِل.
* [مرجع API → الامتثال (Compliance)](/api-reference/endpoints/compliance) — مخططات
  الطلب/الاستجابة الكاملة (مُعاد توليدها من API الحية).