Telegram Entitlement

​

O que é entregue

• A concessão é criada em Pending enquanto o bot prepara o convite e, em seguida, passa para Delivered quando o link está pronto.
• O cliente recebe um link de convite único do Telegram no email de entrega e no Customer Portal.
• Ele toca no link, e o bot o adiciona ao chat configurado.
• Em caso de cancelamento, reembolso ou revogação manual, o bot o 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. Dodo Payments cria uma concessão Pending e solicita ao bot que gere 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 email de entrega e no Customer Portal.
4. O cliente toca no link e é adicionado ao chat.
5. Em caso de 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',
  },
});

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

​

Solução de problemas