Telegram Entitlement

​

O que é entregue

• A concessão é criada em Pending. Ela permanece Pending depois que o cliente vincula a conta do Telegram e o bot emite o link de solicitação de entrada.
• No Customer Portal, o cliente clica em Conectar, envia /start para o bot do Dodo Payments para obter o ID de usuário do Telegram, insere esse ID e clica em Vincular conta.
• O bot envia ao cliente um link de solicitação de entrada no Telegram. Quando o cliente solicita a entrada, o bot aprova a solicitação apenas para a conta vinculada.
• Em caso de cancelamento, reembolso ou revogação manual, o bot remove o cliente do chat e o bane. Se ele comprar novamente, o bot remove o banimento antes de enviar um novo link.

​

Conectar Telegram

1

Open Entitlements

No dashboard do Dodo Payments, acesse Entitlements e clique em +. Em seguida, escolha Acesso ao Telegram como integração. O dashboard solicita seu ID de usuário do Telegram, que vincula os chats aos quais você adiciona o bot à sua empresa.

As duas etapas seguintes acontecem no Telegram e podem ser realizadas em qualquer ordem: obtenha seu ID de usuário e adicione o bot ao seu chat como administrador. Quando ambas estiverem concluídas, volte ao dashboard para realizar a etapa final.

2

Get Your Telegram User ID

No Telegram, envie /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 dashboard na última etapa.

3

Add the Bot to Your Chat as an Admin

Na mesma conta do Telegram, abra o grupo ou canal que deseja controlar e adicione o mesmo bot como administrador (@dodo_payments_bot para o modo live, @DodoPaymentsTestBot para o modo de teste). Ative estas duas permissões:

• Banir usuários: necessário para remover membros após a 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 dashboard, cole o ID de usuário da etapa 2 em ID de usuário do Telegram e clique em Conectar Telegram. O seletor Chat lista os grupos e canais aos quais você adicionou o bot usando essa conta. Escolha o chat que deseja controlar, insira um Nome para o entitlement e clique em Criar entitlement.

​

Fluxo do cliente

1. O cliente conclui o checkout.
2. O Dodo Payments cria um grant Pending. Ainda não existe nenhum link de convite.
3. O e-mail de confirmação do pagamento lista o entitlement como Ação necessária e contém um link para o Customer Portal. No portal, o cliente clica em Conectar, envia /start ao bot, insere seu ID de usuário do Telegram e clica em Vincular conta.
4. O bot envia ao cliente um link de solicitação de entrada no Telegram. O cliente abre o link e solicita a entrada, e o bot aprova a solicitação.
5. Após a revogação, o bot remove o cliente do chat.

​

Configuração obrigatória

​

Criar via API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

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

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
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