> ## 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 डैशबोर्ड में, **Entitlements** पर जाएं और **+** पर क्लिक करें, फिर एकीकरण के रूप में **Telegram Access** चुनें। डैशबोर्ड आपके टेलीग्राम यूज़र आईडी की मांग करता है ताकि बॉट इसकी प्रबंधित चैट्स की स्वामित्व की पुष्टि कर सके।

    <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="New Entitlement Telegram Access form prompting for Telegram user ID and Connect Telegram button" 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`) इन दो अनुमतियों के साथ सक्षम करें:

    * **Ban Users** — रद्द पर सदस्यों को हटाने की आवश्यकता होती है
    * **Add Users** — भुगतान करने वाले ग्राहकों को आमंत्रित करने की आवश्यकता होती है

    हर दूसरी एडमिन अनुमति को बंद छोड़ दें।

    <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="Telegram Promote to admin screen showing Ban Users and Add Users enabled for the Dodo Payments bot" 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 से यूज़र आईडी **Telegram User ID** में पेस्ट करें और **Connect Telegram** पर क्लिक करें। अब चैट पिकर में हर समूह और चैनल सूचीबद्ध होते हैं जहां बॉट एडमिन है — जिसको आप सुरक्षित करना चाहते हैं, उसे चुनें, अधिकार क्षेत्र को एक नाम दें, और **Create Entitlement** पर क्लिक करें।
  </Step>
</Steps>

## ग्राहक प्रवाह

1. ग्राहक चेकआउट पूरा करता है।
2. Dodo Payments एक `pending` ग्रांट बनाता है और बॉट से कॉन्फ़िगर किए गए चैट के लिए एक बार का निमंत्रण लिंक उत्पन्न करने का अनुरोध करता है।
3. जब लिंक तैयार हो जाता है, ग्रांट `delivered` में चला जाता है और लिंक डिलीवरी ईमेल और ग्राहक पोर्टल में शामिल होता है।
4. ग्राहक लिंक को टैप करता है और चैट में जोड़ दिया जाता है।
5. रद्दीकरण पर, बॉट ग्राहक को चैट से हटा देता है।

<Tip>
  निमंत्रण लिंक एकल उपयोग का है और ग्राहक के शामिल होने के बाद समाप्त हो जाता है। यदि वे शामिल होने से पहले लिंक खो देते हैं, तो डिलीवरी ईमेल को फिर से भेजकर या डैशबोर्ड से ग्रांट को रद्दीकरण और फिर से बनाकर इसे पुनः उत्पन्न करें।
</Tip>

## आवश्यक कॉन्फिगरेशन

| फ़ील्ड    | आवश्यक | विवरण                                                                                                      |
| --------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| `chat_id` | हाँ    | टेलीग्राम चैट आईडी (संख्यात्मक, समूहों/चैनलों के लिए अक्सर नकारात्मक)। डैशबोर्ड पिकर इसे आपके लिए भरता है। |

## एपीआई के माध्यम से बनाएँ

<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 बॉट को **एडमिन के रूप में** चैट में जोड़ा जाना चाहिए जिसमें **Add Users** सक्षम हो। पिकर लाइव स्थिति पढ़ता है, इसलिए जैसे ही बॉट एडमिन होता है, चैट दिखाई देती है।
  </Accordion>

  <Accordion title="Customer says the invite link doesn't work">
    टेलीग्राम एक बार के लिंक पहले उपयोग के बाद समाप्त हो जाते हैं। यदि ग्राहक ने इसे लॉग आउट डिवाइस पर टैप किया या लिंक खो दिया, तो ग्रांट को रद्द करें और फिर से जारी करें।
  </Accordion>

  <Accordion title="Customer cancelled but is still in the chat">
    बॉट को सदस्यों को हटाने के लिए **Ban Users** एडमिन अनुमति की आवश्यकता होती है। चैट सेटिंग्स खोलें और सुनिश्चित करें कि Dodo Payments बॉट पर **Ban Users** और **Add Users** दोनों चेक किए गए हैं।
  </Accordion>
</AccordionGroup>