Lista de assinantes do Telegram: como não perder a sua base

Todo criador que vende acesso no Telegram acredita ter uma coisa que na verdade ele não tem: uma lista de assinantes do Telegram que possa ser aberta, conferida e levada embora. O grupo está lá, o número de membros está visível, o dinheiro entrou. Parece uma lista. Não é. O que existe é uma contagem do lado da plataforma e um registro do lado do seu bot, e só o segundo é seu.

A diferença aparece no pior momento possível: quando o banco de dados do bot se perde, quando você troca de ferramenta, ou quando a conta cai. Este artigo mostra o que a documentação oficial do Telegram realmente entrega, como o seu bot fica sabendo quem entrou e quem saiu, por que esse registro tem um buraco silencioso na configuração padrão, e o que dá para fazer hoje para a base não depender de um único lugar.

A lista de assinantes do Telegram não sai pela API

Resposta primeiro: não existe, na API de bots, nenhum método que devolva todos os membros de um grupo ou canal.

Vale ler o que a documentação da Bot API oferece de fato sobre membros, porque são só três coisas:

• A contagem. O método de contagem de membros serve para "get the number of members in a chat" e devolve um inteiro ("Returns Integer on success"). Um número, não uma relação de pessoas.
• Os administradores. O método de administradores devolve "a list of administrators in a chat", e por padrão os outros bots ficam de fora, a não ser que você peça o contrário no parâmetro opcional que a documentação oferece para isso. Ou seja, a única lista completa que existe é a da sua equipe, não a dos seus clientes.
• Um membro por vez. A consulta de membro devolve o status de uma pessoa específica, e para chamá-la você precisa já saber o identificador dela. Serve para verificar, não para descobrir.

Do lado da interface de cliente do Telegram, que é outra API e não a de bots, existe um método de participantes de supergrupo e canal. Ele não é a via que um bot de vendas usa, e a própria página lista entre os erros possíveis o CHAT_ADMIN_REQUIRED, com a descrição "You must be an admin in this chat to do this". Para a sua operação, o resumo prático é direto: a plataforma responde quantos, nunca quem.

Isso muda a natureza do ativo. Se o seu registro sumir, o grupo continua cheio de gente pagante, e você fica sem saber qual delas pagou até quando. Não existe botão de recuperar.

O que o seu bot realmente sabe, e como ele fica sabendo

Resposta primeiro: o bot só conhece quem passou por ele, e só registra entradas e saídas se você pedir explicitamente esse tipo de evento.

Esse é o detalhe que derruba operação madura. A Bot API tem uma atualização de mudança de status de membro no chat, e a documentação é literal sobre a condição para recebê-la: "The bot must be an administrator in the chat and must explicitly specify chat_member in the list of allowed_updates to receive these updates". Existe uma segunda atualização, sobre o status do próprio bot, que em conversas privadas só chega "when the bot is blocked or unblocked by the user".

Traduzindo para a operação: se o seu bot não estiver administrador do grupo, ou se a lista de atualizações permitidas não pedir esse evento, as pessoas entram e saem do seu grupo em silêncio. O bot continua vendendo, continua cobrando, continua liberando acesso, e o registro de quem está lá dentro vai ficando desatualizado sem nenhum erro aparecer.

O buraco cresce com a rotatividade, e é aí que ele fica caro. Numa base com 10% de troca por mês, o registro que não captura evento nenhum conhece 90% da base depois do primeiro mês, 81% depois do segundo e pouco mais da metade depois do sexto:

Caso de borda que vale registrar: mesmo com tudo configurado, quem entra por link de convite compartilhado por terceiro e quem foi adicionado manualmente por um administrador aparecem no evento sem nenhuma compra ligada a eles. O registro sabe que a pessoa entrou. Ele não sabe se ela deveria estar lá. Essa é uma das causas do descompasso entre pagamento e acesso que aparece em pagou e não entrou no grupo.

O identificador que amarra tudo é o número, não o arroba

Resposta primeiro: guarde o identificador numérico da conta, porque ele é o único campo estável dessa relação.

Três candidatos aparecem quando alguém monta o registro pela primeira vez, e dois deles são armadilha:

• O nome de usuário (o arroba). É trocável e removível pelo próprio assinante, a qualquer momento, sem avisar ninguém. Um registro construído em cima disso apaga sozinho.
• O nome exibido. Muda ainda mais, pode ser igual ao de outra pessoa e não serve nem para desempate.
• O identificador numérico da conta. É o que a API usa para consultar status, liberar e remover. É o campo pelo qual você consegue perguntar ao Telegram "essa pessoa ainda está no grupo".

Na prática, o registro mínimo de cada assinante tem quatro campos: identificador numérico, data de entrada, produto comprado e data de vencimento. Com esses quatro, qualquer operação de acesso pode ser refeita. Sem o primeiro, nenhum dos outros três serve para nada, porque você não consegue apontar para a pessoa certa.

Onde cada dado vive e o que o derruba

Resposta primeiro: os dados da sua operação estão em quatro lugares diferentes, e cada lugar cai por um motivo diferente.

Dado	Onde ele vive	O que o apaga
Quem está no grupo agora	Servidor do Telegram	Perda do grupo
Quem entrou e quando	Registro do seu bot	Perda do banco
Quem pagou e quando	Conta do gateway	Encerramento da conta
Contato fora da plataforma	Lista própria sua	Nada, se houver cópia

A leitura importante dessa tabela é que as três primeiras linhas dependem de terceiros e a quarta não. É o mesmo raciocínio de continuidade que aparece em conta banida no Telegram, aplicado ao dado em vez do canal: não adianta ter plano para recuperar o grupo se, ao recuperar, você não souber quem convidar de volta.

Repare também numa assimetria útil: o registro de pagamento costuma ser o mais resistente dos três, porque fica numa conta de instituição financeira, com histórico exportável e obrigação de guarda. Quando o resto some, é dele que a reconstrução começa.

O que fazer quando o registro e o grupo divergem

Resposta primeiro: compare a contagem que o Telegram devolve com o número de acessos ativos no seu registro, porque a diferença entre os dois tem só três causas possíveis.

É a única conferência que a API permite fazer de verdade, e ela leva um minuto. Se o grupo tem 512 membros e o seu registro conta 480 acessos válidos, sobram 32 pessoas, e cada explicação exige uma ação diferente:

• Gente que entrou sem passar pelo bot. Convite manual, link compartilhado ou administrador antigo. Aqui você está entregando conteúdo de graça, e a correção é fechar a porta de entrada, não caçar as pessoas.
• Gente com acesso vencido que não foi removida. A remoção automática falhou ou nunca foi ligada. É o caso mais comum e o mais caro, porque o assinante aprende que não precisa renovar.
• A sua própria equipe e os bots. Administradores, moderador contratado e o bot contam como membros e não deveriam entrar na comparação.

O sentido da diferença também informa: registro maior que a contagem significa gente que saiu ou foi removida sem o seu sistema perceber, ou seja, o buraco de eventos da seção anterior aparecendo em números. Vale rodar essa conferência junto com o fechamento mensal descrito em controle financeiro das vendas, no mesmo dia, para as duas listas serem lidas na mesma data.

Cinco passos para a base não depender de um lugar só

Resposta primeiro: o objetivo não é copiar tudo, é garantir que exista pelo menos uma cópia do que liga pagamento a pessoa.

1. Confirme que o bot é administrador e que o evento de mudança de status está pedido. Sem os dois, o registro de entradas e saídas não acontece. É uma configuração, não um recurso pago, e é a primeira coisa a checar num roteiro de verificação como o de testar o bot de vendas.
2. Grave o identificador numérico junto com cada pagamento. Não é o arroba, não é o nome. O vínculo entre a compra e a conta é o que permite provar acesso legítimo depois.
3. Exporte o histórico do gateway periodicamente. Uma cópia mensal do extrato de cobranças, guardada fora do painel, é o backup mais barato que existe e o único que sobrevive ao encerramento de uma conta.
4. Mantenha um endereço alternativo divulgado desde o começo. Um canal secundário que a base já conhece é o que transforma "perdi tudo" em "avisei todo mundo".
5. Guarde o mínimo, e só o que você usa. Cada campo a mais é um dado pessoal a mais sob a sua responsabilidade, e não melhora a operação em nada.

Isso é dado pessoal, e a responsabilidade é sua

Resposta primeiro: identificador de conta, histórico de compra e qualquer contato voluntário são dados pessoais, e quem decide o que fazer com eles responde por essa decisão.

Não é um detalhe burocrático. O mesmo registro que salva a sua operação é uma base de dados de pessoas que compraram conteúdo, o que já é informação sensível pelo contexto, independentemente do que estava sendo vendido. As duas regras práticas são guardar só o necessário para operar a venda e não usar o dado para finalidade diferente da que foi comunicada. O detalhamento do que isso exige está em LGPD para quem vende conteúdo digital.

Erros comuns

• Confiar que o grupo é o registro. O grupo prova quantos, nunca quem, e some junto com a conta.
• Deixar o evento de mudança de status desligado. É a configuração que decide se você terá um registro ou uma estimativa, e ela não avisa quando está errada.
• Indexar a base pelo arroba. Funciona por meses e quebra no dia em que o assinante troca o nome de usuário, justamente quando você precisa achar a pessoa.
• Ter o banco do bot como única cópia. Se ele é o único lugar onde pagamento e pessoa se encontram, ele é um ponto único de falha da operação inteira.
• Guardar dado que você não usa. Telefone, endereço e documento não entram em nada do fluxo de acesso e só aumentam o seu risco.

Conclusão

A frase que resume o assunto é curta: a lista de assinantes do Telegram não é um arquivo que você baixa, é um registro que você constrói. A plataforma entrega contagem, administradores e consulta individual, e nada além disso. Quem entrou e quem saiu chega por evento, e só se você tiver pedido esse evento explicitamente, com o bot como administrador do grupo.

O próximo passo é de dez minutos e vale mais que qualquer plano longo: confira se o seu bot é administrador do grupo, se o registro de entradas e saídas está ativo, e se existe pelo menos uma cópia fora do painel que ligue cada pagamento a um identificador de conta. Se as três respostas forem sim, a sua base sobrevive à perda de qualquer uma das partes. Na Afroditte o vínculo entre pagamento confirmado e acesso liberado é registrado a cada transação, com custo de R$ 0,69 fixos e o dinheiro caindo direto na sua conta. Crie sua conta e comece com o registro certo desde a primeira venda.