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

# استحقاق تيليجرام

> إضافة العملاء المشترين إلى دردشة أو قناة تيليجرام خاصة تلقائيًا عند الاشتراك أو الشراء.

<Info>
  يوفر استحقاق تيليجرام للعملاء المشترين الوصول إلى دردشة أو قناة خاصة. يقوم بوت Dodo Payments تيليجرام بإنشاء رابط دعوة لمرة واحدة لكل عميل ويقوم بإزالتهم في حالة الإلغاء.
</Info>

## ما يتم تسليمه

* يتم إنشاء المنحة في `pending` بينما يقوم البوت بتجهيز الدعوة، ثم تنتقل إلى `delivered` بمجرد أن يكون الرابط جاهزًا.
* يتلقى العميل رابط دعوة تيليجرام لمرة واحدة في بريد التسليم الإلكتروني ومحور العميل.
* يقومون بالنقر على الرابط ويضيفهم البوت إلى الدردشة المكونة.
* في حالة الإلغاء أو الاسترداد أو الإلغاء اليدوي، يقوم البوت بإزالتهم من الدردشة.

تشمل الاستخدامات الشائعة القنوات الخاصة الفا، مجموعات الإشارات المدفوعة، وامتيازات المستوى المجتمعي.

## ربط تيليجرام

<Steps>
  <Step title="Open Entitlements">
    في لوحة تحكم Dodo Payments الخاصة بك، اذهب إلى **استحقاقات** وانقر على **+**، ثم اختر **وصول تيليجرام** كالتكامل. تطلب لوحة التحكم معرف المستخدم تيليجرام الخاص بك حتى يتمكن البوت من التحقق من ملكية الدردشات التي يديرها.

    <Frame caption="New Entitlement → Telegram Access. The dashboard needs your Telegram user ID before it lists chats.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/telegram/connect-prompt.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=dbb8be6964b2cbfb9bbe9902944f3d5f" alt="نموذج وصول جديد للاستحقاق في تيليجرام يطالب بمعرف المستخدم في تيليجرام وزر ربط تيليجرام" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1131" data-path="images/entitlements/telegram/connect-prompt.png" />
    </Frame>

    <Tip>
      الخطوتان التاليتان هما مهام إعداد على تيليجرام ويمكن إتمامهما بأي ترتيب — احصل على معرف المستخدم الخاص بك وأضف البوت إلى الدردشة الخاصة بك كمسؤول. بمجرد الانتهاء من كلاهما، ارجع إلى لوحة التحكم للخطوة النهائية.
    </Tip>
  </Step>

  <Step title="Get your Telegram user ID">
    على تيليجرام، أرسل رسالة إلى **`/start`** إلى:

    * **`@dodo_payments_bot`** إذا كنت تستخدم **وضع الحياة**
    * **`@DodoPaymentsTestBot`** إذا كنت تستخدم **وضع الاختبار**

    يرد البوت بمعرف تيليجرام الرقمي الخاص بك. انسخه — ستلصقه في لوحة التحكم في الخطوة الأخيرة.
  </Step>

  <Step title="Add the bot to your chat as an admin">
    في المجموعة أو القناة في تيليجرام التي تريد جعلها مقيدة، افتح قائمة الأعضاء و**أضف نفس البوت كمسؤول** (`@dodo_payments_bot` في الوضع المباشر، `@DodoPaymentsTestBot` للاختبار) مع تمكين هذين الإذنين:

    * **حظر المستخدمين** — مطلوب لإزالة الأعضاء عند الإلغاء
    * **إضافة المستخدمين** — مطلوب لدعوة العملاء المشتركين

    اترك كل إذن مسؤول آخر مغلقًا.

    <Frame caption="Telegram → Promote to admin. Only Ban Users and Add Users need to be enabled.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/telegram/promote-bot-admin.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=bf927f2ee98616b671257d246de06cd3" alt="شاشة ترقيه تيليجرام إلى مسؤول تظهر تفعيل حظر المستخدمين وإضافة المستخدمين لروبوت Dodo Payments" style={{ maxHeight: '500px', width: 'auto' }} width="734" height="1626" data-path="images/entitlements/telegram/promote-bot-admin.png" />
    </Frame>
  </Step>

  <Step title="Connect Telegram and pick the chat">
    عد إلى لوحة التحكم، الصق معرف المستخدم من الخطوة 2 في **معرف مستخدم تيليجرام** وانقر على **ربط تيليجرام**. الآن يعرض مختار الدردشة كل مجموعة وقناة حيث البوت هو مسؤول — اختر ما تريد قفله، أعط الاستحقاق اسمًا، وانقر على **إنشاء استحقاق**.
  </Step>
</Steps>

## تدفق العملاء

1. يكمل العميل عملية الدفع.
2. يقوم Dodo Payments بإنشاء `pending` ومن ثم يطلب من البوت توليد رابط دعوة لمرة واحدة إلى الدردشة المكونة.
3. بمجرد أن يكون الرابط جاهزًا، تنتقل المنحة إلى `delivered` ويتم تضمين الرابط في بريد التسليم الإلكتروني ومحور العميل.
4. ينقر العميل على الرابط ويتم إضافته إلى الدردشة.
5. عند الإلغاء، يقوم البوت بإزالة العميل من الدردشة.

<Tip>
  رابط الدعوة للاستخدام لمرة واحدة وينتهي بعد انضمام العميل. إذا فقدوا الرابط قبل الانضمام، أعد إنشائه بإعادة إرسال بريد التسليم الإلكتروني أو بإلغاء واستعادة المنحة من لوحة التحكم.
</Tip>

## التكوين المطلوب

| الحقل     | مطلوب | الوصف                                                                                                   |
| --------- | ----- | ------------------------------------------------------------------------------------------------------- |
| `chat_id` | نعم   | معرف دردشة تيليجرام (رقمي، وغالبًا ما يكون سالب للمجموعات/القنوات). يملأ مختار اللوحة هذا بالنيابة عنك. |

## الإنشاء عبر API

<CodeGroup>
  ```typescript TypeScript theme={null} theme={null}
  const entitlement = await client.entitlements.create({
    name: 'Premium Signals Group',
    integration_type: 'telegram',
    integration_config: {
      chat_id: '-1001234567890',
    },
  });
  ```

  ```python Python theme={null} theme={null}
  client.entitlements.create(
      name="Premium Signals Group",
      integration_type="telegram",
      integration_config={"chat_id": "-1001234567890"},
  )
  ```

  ```go Go theme={null} theme={null}
  client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
    Name:            dodopayments.F("Premium Signals Group"),
    IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeTelegram),
    IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
      dodopayments.IntegrationConfigTelegramConfigParam{
        ChatID: dodopayments.F("-1001234567890"),
      },
    ),
  })
  ```
</CodeGroup>

## الويب هوكس

راجع [أحداث الويب هوكس `entitlement_grant.*`](/developer-resources/webhooks/intents/entitlement-grant). تصل منح تيليجرام `pending` وتنتقل إلى `delivered` بمجرد أن يصدر البوت رابط الدعوة.

## استكشاف الأخطاء وإصلاحها

<AccordionGroup>
  <Accordion title="Chat doesn't appear in the picker">
    يجب إضافة بوت Dodo Payments إلى الدردشة **كمسؤول** مع تمكين **إضافة المستخدمين**. يقرأ المختار الحالة الحية، لذا تظهر الدردشة بمجرد أن يكون البوت مسؤولاً.
  </Accordion>

  <Accordion title="Customer says the invite link doesn't work">
    تنتهي صلاحية روابط تيليجرام لمرة واحدة بعد أول استخدام. إذا نقر العميل عليها على جهاز بدون تسجيل دخول أو فقد الرابط، قم بإلغاء المنحة وإعادة إصدارها.
  </Accordion>

  <Accordion title="Customer cancelled but is still in the chat">
    يحتاج البوت إلى إذن مسؤول **حظر المستخدمين** لإزالة الأعضاء. افتح إعدادات الدردشة وتأكد من تمكين **حظر المستخدمين** و**إضافة المستخدمين** على بوت Dodo Payments.
  </Accordion>
</AccordionGroup>