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

# الانضمام إلى DLT-India

> سجّل الكيان الأساسي ومُعرِّفات المرسل (Headers) وقوالب المحتوى وقوالب الموافقة لنظام TRAI DLT في الهند حتى تُسلَّم رسائل SMS من A2P.

# الانضمام إلى DLT-India

يتطلب نظام **TRAI DLT** (تقنية السجل الموزع) في الهند من كل
عمل يرسل رسائل SMS من نوع A2P في الهند أن يُسجّل على بوابة
DLT يشغّلها مشغّل اتصالات قبل إيصال أي حركة. الرسائل غير
المسجلة أو غير المطابقة تحظرها المشغّلون أنفسهم — وليس Orbit.

تُعكس Orbit الكائنات الأربعة لـ DLT حتى تدير تسجيلاتك الهندية
إلى جانب بقية وضعك التنظيمي للامتثال. تبقى تُتمم التسجيل
الأساسي على بوابة DLT لمسجّل؛ وتُسجّل Orbit المعرفات الناتجة
وتتتبع حالتها.

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

<Warning>
  **كتابات تسجيل DLT محصنة ومعطلة افتراضياً.** نقاط النهاية
  الأربعة `POST` أدناه (`principal-entities`، `headers`،
  `content-templates`، `consent-templates`) تُرجع
  `503 FEATURE_DISABLED` حتى يُفعَّل تسجيل DLT لنشرك
  (`DEVOTEL_DLT_REGISTRATION_ENABLED=true`). نقاط النهاية
  `GET` للسرد ونقاط `/nudge` تبقى مفتوحة بغض النظر، لذا يمكنك
  قراءة أي صفوف موجودة ورؤية إشعارات التوصيل. إذا احتجت لتسجيل
  كائنات DLT والكتابات محصنة، اتصل بالدعم لتفعيل الميزة.
</Warning>

<Note>
  هذه النقاط تُسجّل التسجيلات التي تحصل عليها على بوابة مسجّل
  DLT. Orbit لا يوافق عليها — المسجّل والمشغّلون يوافقون. مرة
  يُفعَّل تسجيل DLT، يبدأ كل كائن في `pending` ويُحدَّث حين
  يُزال.
</Note>

***

## ترتيب الانضمام

كائنات DLT تعتمد بعضها على بعض، لذا سجّلها بهذا الترتيب:

<Steps>
  <Step title="الكيان الأساسي (PE)">
    سجّل عملك ككيان أساسي لدى مسجّل وسجّل **PE ID** المعيَّن.
  </Step>

  <Step title="مُعرِّفات المرسل (Headers / Sender IDs)">
    سجّل مُعرِّفات المرسل (Headers / Sender IDs) من 3–11
    أحرف التي سترسل تحتها، كل منها مرتبط بـ PE وفئة.
  </Step>

  <Step title="قوالب المحتوى">
    سجّل كل قالب رسالة، مع عناصر نائبة متغيرة، تحت مُعرِّف
    مرسل وفئة.
  </Step>

  <Step title="قوالب الموافقة">
    سجّل نص الموافقة الذي يدعم مشاركاتك (opt-ins)، حتى يمكن
    ربط الإرسالات الترويجية بكائن موافقة موثق.
  </Step>
</Steps>

***

## 1. الكيان الأساسي

`POST /dlt-india/principal-entities` (مسؤول/مالك) يسجّل
الـ PE الخاص بك.

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/dlt-india/principal-entities \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "registrar": "vilpower",
    "pe_id": "1101234567890123",
    "legal_name": "Acme Retail Pvt Ltd",
    "pan_or_gstn": "AAACA1234A",
    "entity_type": "private_limited"
  }'
```

| الحقل         | النوع  | الملاحظات                                                      |
| ------------- | ------ | -------------------------------------------------------------- |
| `registrar`   | enum   | `vilpower`، `trueconnect`، `tanla`، `jio`، `videocon`، `bsnl`. |
| `pe_id`       | string | معرف الكيان الأساسي لـ TRAI (8–20 حرفاً).                      |
| `legal_name`  | string | الاسم القانوني المسجل (1–200).                                 |
| `pan_or_gstn` | string | PAN أو GSTN اختياري (≤ 50).                                    |
| `entity_type` | string | اختياري (≤ 50).                                                |

`GET /dlt-india/principal-entities` يسرد كياناتك الأساسية
مع `status` و`rejection_reason` وطوابع الإيداع/الموافقة
الزمنية.

***

## 2. مُعرِّفات المرسل (Headers / Sender IDs)

`POST /dlt-india/headers` (مسؤول/مالك) يسجّل مُعرِّف مرسل
تحت كيان أساسي.

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/dlt-india/headers \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "principal_id": "pe_internal_id",
    "header": "ACMERT",
    "category": "transactional"
  }'
```

| الحقل          | النوع  | الملاحظات                                                               |
| -------------- | ------ | ----------------------------------------------------------------------- |
| `principal_id` | string | معرف Orbit للكيان الأساسي الأصل.                                        |
| `header`       | string | مُعرِّف المرسل / Header (3–11 حرفاً).                                   |
| `category`     | enum   | `promotional`، `transactional`، `service_implicit`، `service_explicit`. |

`GET /dlt-india/headers` يسرد مُعرِّفات المرسل المسجلة
وحالتها.

***

## 3. قوالب المحتوى

`POST /dlt-india/content-templates` (مسؤول/مالك) يسجّل قالب
رسالة. يتطلب DLT أن يطابق كل جسم رسالة قالباً مُوافَقاً عليه،
مع الأجزاء المتغيرة موسومة كعناصر نائبة.

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/dlt-india/content-templates \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "principal_id": "pe_internal_id",
    "header_id": "hdr_internal_id",
    "template_id": "1107654321098765432",
    "template_name": "Order shipped",
    "category": "transactional",
    "template_type": "text",
    "content": "Hi {#var#}, your order {#var#} has shipped.",
    "variables": ["name", "order_id"]
  }'
```

| الحقل           | النوع     | الملاحظات                                 |
| --------------- | --------- | ----------------------------------------- |
| `principal_id`  | string    | الكيان الأساسي الأصل.                     |
| `header_id`     | string    | مُعرِّف المرسل الأصل، اختياري.            |
| `template_id`   | string    | معرف قالب المسجّل، اختياري (≤ 64).        |
| `template_name` | string    | 1–200.                                    |
| `category`      | enum      | نفس مجموعة مُعرِّفات المرسل.              |
| `template_type` | enum      | `text`، `unicode`، `unicode_text`، `otp`. |
| `content`       | string    | الجسم مع عناصر نائبة `{#var#}` (1–2000).  |
| `variables`     | string\[] | أسماء المتغيرات، اختيارية (≤ 20).         |

يمكنك حذف `template_id` حتى يصدره المسجّل — سجّل القالب
الآن وأضف المعرف مرة يُزال. القالب يُخزَّن في كلتا الحالتين.

`GET /dlt-india/content-templates` يسرد القوالب وحالتها.

***

## 4. قوالب الموافقة

`POST /dlt-india/consent-templates` (مسؤول/مالك) يسجّل
نص الموافقة الداعم لمشاركاتك، مطلوباً لربط الإرسالات
الترويجية بكائن موافقة موثق.

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/dlt-india/consent-templates \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "principal_id": "pe_internal_id",
    "consent_template_id": "1109876543210987654",
    "consent_name": "Marketing opt-in",
    "consent_text": "I agree to receive promotional messages from Acme Retail."
  }'
```

| الحقل                 | النوع  | الملاحظات                         |
| --------------------- | ------ | --------------------------------- |
| `principal_id`        | string | الكيان الأساسي الأصل.             |
| `consent_template_id` | string | معرف الموافقة لدى المسجّل (≤ 64). |
| `consent_name`        | string | 1–200.                            |
| `consent_text`        | string | صياغة الموافقة (1–2000).          |

`GET /dlt-india/consent-templates` يسرد قوالب الموافقة
والحالة.

***

## الحالة والإشعارات

كل كائن يحمل `status` (يبدأ في `pending`)، و`rejection_reason`
اختياري، وطوابع الإيداع/الموافقة الزمنية. إذا كشفت Orbit
رفض توصيل متعلق بـ DLT على حركتك الهندية، يعرض
`GET /dlt-india/nudge` إشعاراً رصدياً (`failure_count`،
`last_seen_at`)؛ و`POST /dlt-india/nudge/dismiss` يعترف به.

<Warning>
  الهند سوق محصن بالتسجيل: كيانك الأساسي، ومُعرِّف المرسل،
  وقالب المحتوى يجب أن تكون كلها في مكانها ومتسقة لتوصيل SMS.
  جسم لا يطابق قالباً مسجلاً يرفضه المشغّل. اربط هذا بـ
  [إدارة الموافقة](/compliance/consent-management) لإيصالات
  موافقة DPDP.
</Warning>

***

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

* [دليل الانضمام إلى DLT-India](/guides/dlt-india-onboarding) —
  الجولة الكاملة من طرف إلى طرف لنقاط هذه الصفحة.
* [إدارة الموافقة والإيصالات](/compliance/consent-management) —
  إيصالات موافقة DPDP الهندية ومديرون الموافقة.
* [تسجيل مُعرِّف المرسل](/compliance/sender-id-registration) —
  تسجيل مُعرِّف المرسل للأسواق خارج الهند.
* [بوابات الإرسال](/compliance/send-gates) — قواعد الدول
  والبوابات التي تطبقها.
* [مرجع API → الامتثال](/api-reference/endpoints/compliance) —
  مخططات الطلب/الاستجابة الكاملة (مُعاد توليدها من API الحي).