Telegram Entitlement

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.

​

What gets delivered

• The grant is created in pending while the bot prepares the invite, then transitions to delivered once the link is ready.
• The customer receives a one-time Telegram invite link in their delivery email and customer portal.
• They tap the link and the bot adds them to the configured chat.
• On cancellation, refund, or manual revoke, the bot removes them from the chat.

​

Connect Telegram

1

Open Entitlements

In your Dodo Payments dashboard, go to Entitlements and click +, then choose Telegram Access as the integration. The dashboard asks for your Telegram user ID so the bot can verify ownership of the chats it manages.

The next two steps are set-up tasks on Telegram and can be completed in either order — get your user ID and add the bot to your chat as admin. Once both are done, return to the dashboard for the final step.

2

Get your Telegram user ID

On Telegram, message /start to:

• @dodo_payments_bot if you’re using Live Mode
• @DodoPaymentsTestBot if you’re using Test Mode

The bot replies with your numeric Telegram user ID. Copy it — you’ll paste it into the dashboard in the last step.

3

Add the bot to your chat as an admin

In the Telegram group or channel you want to gate, open the members list and add the same bot as admin (@dodo_payments_bot for live, @DodoPaymentsTestBot for test) with these two permissions enabled:

• Ban Users — required to remove members on revocation
• Add Users — required to invite paying customers

Leave every other admin permission off.

4

Connect Telegram and pick the chat

Back in the dashboard, paste the user ID from step 2 into Telegram User ID and click Connect Telegram. The chat picker now lists every group and channel where the bot is an admin — pick the one you want to gate, give the entitlement a name, and click Create Entitlement.

​

Customer flow

1. The customer completes checkout.
2. Dodo Payments creates a pending grant and asks the bot to generate a one-time invite link to the configured chat.
3. Once the link is ready, the grant moves to delivered and the link is included in the delivery email and customer portal.
4. The customer taps the link and is added to the chat.
5. On revocation, the bot removes the customer from the chat.

​

Required configuration

​

Create via API

const entitlement = await client.entitlements.create({
  name: 'Premium Signals Group',
  integration_type: 'telegram',
  integration_config: {
    chat_id: '-1001234567890',
  },
});

​

Webhooks

​

Troubleshooting