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.

​

O que é entregue

• A concessão é criada em pending enquanto o bot prepara o convite, depois transita para delivered quando o link está pronto.
• O cliente recebe um link de convite único do Telegram em seu e-mail de entrega e portal do cliente.
• Eles tocam no link e o bot os adiciona ao chat configurado.
• No cancelamento, reembolso ou revogação manual, o bot os remove do chat.

​

Conectar Telegram

1

Open Entitlements

No painel do Dodo Payments, vá para Entitlements e clique em +, em seguida escolha Telegram Access como a integração. O painel solicita seu ID de usuário do Telegram para que o bot possa verificar a propriedade dos chats que gerencia.

As duas próximas etapas são tarefas de configuração no Telegram e podem ser concluídas em qualquer ordem — obtenha seu ID de usuário e adicione o bot ao seu chat como administrador. Uma vez que ambos estejam feitos, volte ao painel para a etapa final.

2

Get your Telegram user ID

No Telegram, envie uma mensagem para /start para:

• @dodo_payments_bot se você estiver usando Modo Live
• @DodoPaymentsTestBot se você estiver usando Modo Teste

O bot responde com seu ID de usuário numérico do Telegram. Copie-o — você o colará no painel na última etapa.

3

Add the bot to your chat as an admin

No grupo ou canal do Telegram que você deseja proteger, abra a lista de membros e adicione o mesmo bot como administrador (@dodo_payments_bot para live, @DodoPaymentsTestBot para teste) com estas duas permissões ativadas:

• Banir Usuários — necessário para remover membros na revogação
• Adicionar Usuários — necessário para convidar clientes pagantes

Deixe todas as outras permissões de administrador desligadas.

4

Connect Telegram and pick the chat

De volta ao painel, cole o ID de usuário da etapa 2 em Telegram User ID e clique em Connect Telegram. O seletor de chat agora lista todos os grupos e canais onde o bot é administrador — escolha o que você quer proteger, dê um nome ao privilégio e clique em Create Entitlement.

​

Fluxo do cliente

1. O cliente conclui o checkout.
2. O Dodo Payments cria uma concessão pending e pede ao bot para gerar um link de convite único para o chat configurado.
3. Quando o link está pronto, a concessão passa para delivered e o link é incluído no e-mail de entrega e no portal do cliente.
4. O cliente toca no link e é adicionado ao chat.
5. Na revogação, o bot remove o cliente do chat.

​

Configuração necessária

​

Criar via API

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

​

Webhooks

​

Solução de problemas