Telegram 权限

Telegram 权限为付费用户提供私人聊天或频道的访问权限。Dodo Payments 的 Telegram 机器人为每位客户生成一次性邀请链接，并在取消时将其移除。

交付内容

在机器人准备邀请链接期间，grant 会创建为 Pending；链接准备就绪后，grant 会转换为 Delivered。
客户会在交付邮件和 Customer Portal 中收到一次性 Telegram 邀请链接。
客户点击链接后，机器人会将其添加到已配置的聊天中。
取消、退款或手动撤销时，机器人会将其从聊天中移除。

常见用途包括私人 Alpha 频道、付费信号群和社区层级特权。

连接 Telegram

Open Entitlements

在 Dodo Payments 仪表板中，转到 Entitlements 并单击 +，然后选择 Telegram Access 作为集成。仪表板要求输入您的 Telegram 用户 ID，以便机器人验证其管理的聊天的所有权。

新权限 Telegram 访问表单提示输入 Telegram 用户 ID 和连接 Telegram 按钮 — New Entitlement → Telegram Access. The dashboard needs your Telegram user ID before it lists chats.

接下来的两个步骤是在 Telegram 上的设置任务，可以以任意顺序完成 — 获取您的用户 ID 并将机器人添加为聊天管理员。完成这两步后，返回仪表板进行最后一步。

Get your Telegram user ID

在 Telegram 上，消息发送给 /start：

@dodo_payments_bot 如果您在使用 Live 模式
@DodoPaymentsTestBot 如果您在使用 Test 模式

机器人会回复您的数字 Telegram 用户 ID。复制它 — 在最后一步中粘贴到仪表板中。

Add the bot to your chat as an admin

在您想要限制的 Telegram 群组或频道中，打开成员列表并将同一机器人作为管理员（@dodo_payments_bot 用于实际，@DodoPaymentsTestBot 用于测试），启用以下权限：

禁止用户 — 在撤销时必需删除成员
添加用户 — 邀请付费客户所需

关闭所有其他管理员权限。

Telegram 提升到管理员屏幕显示为 Dodo Payments 机器人启用了禁止用户和添加用户 — Telegram → Promote to admin. Only Ban Users and Add Users need to be enabled.

Connect Telegram and pick the chat

返回仪表板，将步骤 2 中的用户 ID 粘贴到 Telegram 用户 ID，然后单击 Connect Telegram。聊天选择器现在列出了机器人作为管理员的每个群组和频道 — 选择您要限制的那个，给权限命名，然后单击 Create Entitlement。

客户流程

客户完成结账。
Dodo Payments 创建一个 Pending grant，并请求机器人生成一个指向已配置聊天的一次性邀请链接。
链接准备就绪后，grant 会变为 Delivered，链接也会包含在交付邮件和 Customer Portal 中。
客户点击链接后，系统会将其添加到聊天中。
撤销时，机器人会将客户从聊天中移除。

邀请链接是一次性的，在客户加入后过期。如果他们在加入之前丢失了链接，可以通过重新发送交付邮件或从仪表板撤销并重新创建授权来重新生成。

配置要求

字段	必填	描述
`chat_id`	是	Telegram 聊天 ID（数字，群组/频道通常为负数）。仪表板选择器为您填充此内容。

通过 API 创建

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

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

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"),
    },
  ),
})

Webhooks

请参阅 entitlement_grant.* webhook events。Telegram grant 初始为 Pending，机器人发出邀请链接后会转换为 Delivered。

故障排除

Chat doesn't appear in the picker

Dodo Payments 机器人必须作为管理员添加到聊天中，并启用添加用户。选择器读取实时状态，因此一旦机器人成为管理员，聊天就会出现。

Customer says the invite link doesn't work

Telegram 一次性链接在首次使用后过期。如果客户在未登录设备上点击或丢失了链接，请撤销授权并重新发放。

Customer cancelled but is still in the chat

机器人需要 禁止用户 管理权限来删除成员。打开聊天设置并确认在 Dodo Payments 机器人上勾选了 禁止用户 和 添加用户。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

交付内容

连接 Telegram

客户流程

配置要求

通过 API 创建

Webhooks

故障排除

​交付内容

​连接 Telegram

​客户流程

​配置要求

​通过 API 创建

​Webhooks

​故障排除

交付内容

连接 Telegram

客户流程

配置要求

通过 API 创建

Webhooks

故障排除