Assinaturas

Assinatura nativa do Telegram: os 3 limites do link pago

A assinatura nativa do Telegram cobra sozinha, mas o link pago trava canal, ciclo de 30 dias e preço. Veja o que fica decidido antes da sua primeira venda.

Ilustração de um celular com um cartão arredondado e um cadeado, cercado por setas curvas que formam um ciclo, em tons de índigo, violeta e rosa

Quem vende acesso recorrente no Telegram cedo ou tarde descobre que a plataforma tem um mecanismo próprio de cobrança periódica, e a primeira reação costuma ser a mesma: se o Telegram já faz isso, por que usar bot e PIX? A assinatura nativa do Telegram de fato existe, cobra sozinha e não depende de você lembrar de nada. O que quase ninguém lê antes de migrar é a lista de decisões de negócio que ela toma no seu lugar.

Resposta primeiro: são três, e todas estão escritas na documentação oficial. O link de assinatura só funciona em canal, o ciclo é obrigatoriamente de 30 dias, e o preço não pode ser editado depois que o link existe. Nenhuma das três é opinião de blog, e nenhuma delas aparece na tela do aplicativo na hora de criar.

Este artigo lê o método na fonte, mostra o efeito prático de cada trava, calcula quanto a terceira custa na receita de uma base que reajusta preço duas vezes, e fecha dizendo para quem cada caminho faz sentido.

Resposta primeiro: ele cobra na entrada e recobra a cada período, sem lembrete, sem link novo e sem conversa.

A documentação da Bot API descreve o método assim: "Use this method to create a subscription invite link for a channel chat. The bot must have the can_invite_users administrator rights. The link can be edited using the method editChatSubscriptionInviteLink or revoked using the method revokeChatInviteLink."

O campo que define o valor é o subscription_price, descrito como "The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-10000". Repare na construção: paga na entrada e a cada período seguinte para continuar membro. É cobrança recorrente de verdade, com a saída amarrada ao pagamento.

Do lado do bot, cada pagamento chega como um objeto SuccessfulPayment com três campos que só existem nesse cenário: subscription_expiration_date ("Expiration date of the subscription, in Unix time; for recurring payments only"), is_recurring e is_first_recurring. Ou seja, dá para distinguir a primeira cobrança das renovações e saber quando cada acesso vence, que é o insumo de qualquer régua de retenção.

A permissão exigida é uma só, can_invite_users, e ela já está na lista mínima descrita em permissões do bot no Telegram. Nesse ponto o caminho nativo não pede nada além do que um bot de vendas comum já teria.

Limite 1: só canal, e isso reescreve o seu produto

Resposta primeiro: a documentação diz "for a channel chat", e essa expressão exclui grupo e supergrupo. Não existe link de assinatura para grupo.

A diferença não é de nomenclatura. Canal é transmissão: você publica, os assinantes leem, e a conversa entre eles não acontece ali. Grupo é convivência. A escolha entre os dois já foi destrinchada em grupo VIP ou canal VIP no Telegram, e o ponto aqui é outro: com a assinatura nativa a escolha deixa de ser sua.

Exemplo concreto do impacto. Se o seu VIP vende senso de comunidade, com assinantes que se reconhecem e conversam, o formato canal derruba justamente o motivo pelo qual as pessoas ficam. Você pode contornar mantendo um grupo satélite ao lado, mas aí a entrada e a saída desse grupo voltam a ser problema seu, e o benefício de "o Telegram cuida de tudo" evapora pela metade.

Contra-argumento honesto, porque existe um caso em que essa trava não incomoda: acervo. Se o produto é publicação periódica sem interação, canal é o formato correto de qualquer jeito, e a limitação não tira nada de você.

Limite 2: o ciclo é de 30 dias, ponto

Resposta primeiro: o parâmetro subscription_period é obrigatório e a documentação é literal sobre o valor aceito: "The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days)."

Não é um padrão sugerido, é o único valor válido. E não é uma trava só do link de canal: o mesmo parâmetro aparece em createInvoiceLink, o método que gera cobrança de qualquer outro produto digital em Stars, com a mesma restrição escrita de forma quase idêntica, "Currently, it must always be 2592000 (30 days) if specified". Lá o campo é opcional, aqui é obrigatório, mas o prazo aceito é o mesmo.

Isso apaga uma alavanca inteira de negócio. A decisão entre mensal, trimestral e anual, com o trade-off entre desconto e caixa antecipado que está em qual prazo cobrar no Telegram, simplesmente não existe no caminho nativo. Você não pode oferecer um anual com dois meses de desconto para melhorar o caixa, nem um trimestral para reduzir a frequência de decisão de renovar.

Caso de borda que merece atenção: quem já vende anual e pensa em migrar a base para o link nativo estaria, na prática, trocando um recebimento adiantado de doze meses por doze recebimentos mensais. O efeito no fluxo de caixa do mês da migração é imediato e negativo, mesmo que a receita total do ano não mude.

Limite 3: o preço não é editável, e é aqui que dói

Resposta primeiro: o método editChatSubscriptionInviteLink existe, e aceita exatamente três parâmetros: chat_id, invite_link e name. Não há campo de preço nem de período.

Uma ressalva de método, para não vender inferência como citação: a documentação não escreve a frase "o preço é congelado". Ela escreve duas coisas verificáveis, que são o método de edição aceitando só o nome, e o subscription_price valendo "initially and after each subsequent subscription period". A leitura deste artigo, e é leitura, é que quem entrou por um link continua pagando o valor daquele link enquanto a assinatura durar, e que praticar outro preço exige criar outro link.

O efeito disso aparece devagar e não some. Cada reajuste cria uma safra permanente de assinantes no preço antigo, e a receita média por assinante fica abaixo do preço de tabela para sempre. Veja a conta com números redondos.

Quanto cada safra paga por mês depois de dois reajustes de preço Gráfico de barras horizontais com quatro faixas. A safra que entrou no primeiro link paga 300 Stars por mês e tem 100 assinantes. A safra do segundo link paga 350 Stars e tem 60 assinantes. A safra do terceiro link paga 400 Stars e tem 40 assinantes. A média efetiva da base inteira é de 335 Stars por assinante, abaixo do preço de tabela de 400 Stars praticado no link mais recente. Barra maior significa mais Stars recebidos por assinante. Stars por assinante, por safra, depois de dois reajustes Barra maior significa mais Stars por assinante no mês Safra 1 (100 assin.) 300 Safra 2 (60 assin.) 350 Safra 3 (40 assin.) 400 Media efetiva 335 A linha tracejada é o preço de tabela do link mais novo: 400 Stars. A base inteira rende 67.000 Stars por mês, e não os 80.000 da tabela. Diferença: 13.000 Stars por mês, ou 16,25% abaixo do preço anunciado. Cálculo deste artigo: base de 200 assinantes distribuída em três safras.
Cenário hipotético construído para este artigo: 100 assinantes entram a 300 Stars, 60 entram a 350 depois do primeiro reajuste e 40 entram a 400 depois do segundo. Nenhum número aqui é dado de cliente.

Repare no que a conta mostra. Depois de dois reajustes, o preço anunciado é 400 e a base rende 335 por cabeça. Não é perda por churn nem por desconto: é o desenho do mecanismo. Em um bot próprio, o reajuste de preço da base existente é uma decisão de comunicação e de timing, com o framework descrito em como reajustar o preço da assinatura VIP. No link nativo, é uma decisão que você não pode tomar.

Contra-argumento honesto: preço legado nem sempre é ruim. Manter os antigos no valor de entrada é uma tática legítima de retenção, e há quem faça isso de propósito. A diferença é a mesma de sempre entre escolher e ser escolhido. Se um dia o seu custo subir, ou o produto engordar, você vai querer poder mover a base, e aí não vai ter para onde.

O que continua na sua mão depois da venda

Resposta primeiro: três controles, e eles são mais estreitos do que parecem.

O primeiro é interromper a renovação de alguém. O método editUserStarSubscription é descrito como "Allows the bot to cancel or re-enable extension of a subscription paid in Telegram Stars", e o parâmetro de cancelamento diz "Pass True to cancel extension of the user subscription; the subscription must be active up to the end of the current subscription period". Ou seja: você desliga a próxima cobrança, e o acesso segue até o fim do período já pago. É o comportamento correto, e é bom que seja explícito.

O segundo é devolver. O refundStarPayment "Refunds a successful payment in Telegram Stars". A devolução volta em Stars para o saldo de quem pagou, não em reais para a conta bancária dele.

O terceiro é revogar o link, com revokeChatInviteLink. Isso fecha a porta para novas entradas naquele preço, e é exatamente o movimento que você faria ao criar um link mais caro.

Falta um quarto controle que muita gente presume existir: mover um assinante de um link para outro. Não há método para isso. Quem quiser mudar de safra precisa sair e entrar de novo, o que significa perder e refazer o vínculo de cobrança.

Decisão Link nativo Bot próprio com PIX
Formato do produto só canal canal ou grupo
Ciclo de cobrança 30 dias fixos você define
Reajuste da base não editável decisão sua
Moeda que entra Stars real
Onde o valor fica saldo na plataforma conta do criador
Devolução em Stars em real
Teto por período 10.000 Stars sem teto técnico

Onde o dinheiro para, e por que isso pesa no fundo da decisão

Resposta primeiro: no caminho nativo o pagamento vira saldo em Stars, e saldo em plataforma tem regras que dinheiro em conta não tem.

Os termos oficiais dos Telegram Stars trazem uma cláusula que vale ler devagar: "If your Telegram account is terminated, your remaining Star balance will be considered permanently forfeit and we will not compensate you for this loss." Encerrou a conta, o saldo restante se perde, sem compensação.

Para um mercado que já convive com risco de queda de canal, isso soma um risco novo em cima de um risco conhecido. O plano de continuidade descrito em conta banida no Telegram trata de recuperar audiência. Aqui o que está em jogo é o caixa que ainda não foi resgatado no dia em que a porta fecha.

A economia da conversão de Stars em real, com o caminho de resgate e os dois valores diferentes do mesmo saldo, já está detalhada em Telegram Stars ou PIX e não vale repetir aqui. O ponto deste artigo é anterior: mesmo que a conversão fosse perfeita, as três travas de produto continuariam de pé.

Para quem cada caminho faz sentido

Resposta primeiro: a assinatura nativa é forte para produto simples, público internacional e operação que não quer manter nada. Ela é fraca para quem precisa mexer em preço, prazo e formato.

Faz sentido usar o link nativo quando o produto é um canal de publicação, o preço é estável, o público está espalhado por vários países e o criador prefere não lidar com cobrança. É um caminho de baixíssimo atrito para começar.

Faz sentido usar bot próprio com PIX quando o público é brasileiro, o dinheiro precisa cair em real na conta do criador, e o produto ainda está mudando de preço, de formato ou de prazo. A mecânica de cobrança recorrente por esse caminho está no pilar do cluster, assinatura recorrente no Telegram.

Um detalhe honesto sobre a documentação: a assinatura de canal está descrita na Bot API, mas o FAQ oficial do Telegram não traz verbete sobre assinatura paga de canal. As menções a assinatura ali são a do Telegram Premium e a de mini apps, no trecho "Mini apps can sell digital goods and subscriptions for Telegram Stars". Isso não invalida nada, é uma observação de que o recurso vive hoje na camada de desenvolvedor, e não na camada de ajuda ao usuário.

Erros comuns

  • Presumir que dá para usar em grupo. A documentação diz canal. Descobrir isso depois de anunciar o VIP como comunidade custa uma retratação pública.
  • Anunciar plano anual e implementar no link nativo. O período é fixo em 30 dias, então a promessa não tem como ser cumprida por esse caminho.
  • Criar o link com preço de teste. Como o preço não é editável, o valor provisório vira valor permanente para todo mundo que entrou.
  • Confundir cancelar extensão com remover o assinante. Cancelar a extensão mantém o acesso até o fim do período pago, que é o comportamento correto e contratualmente mais seguro.
  • Tratar saldo em Stars como caixa. Enquanto não for resgatado, é saldo em plataforma, sujeito às regras da plataforma.
  • Ignorar as safras de preço na hora de projetar receita. Multiplicar o preço atual pelo número de assinantes superestima o faturamento de qualquer base que já reajustou.

Conclusão

A assinatura nativa do Telegram resolve bem um problema real: cobrar todo mês sem depender de ninguém. Em troca, ela decide três coisas por você. O produto vira canal, o ciclo vira 30 dias e o preço de cada safra vira definitivo. Some a isso o fato de o valor chegar como saldo em plataforma, e o desenho fica claro: é um caminho de baixo atrito e baixa liberdade.

O próximo passo prático é simples e leva dez minutos. Escreva as três decisões que você quer manter no seu controle nos próximos doze meses, formato, prazo e preço. Se as três importarem, o caminho nativo não é o seu. Se nenhuma importar, ele é o mais barato de operar.

Se a resposta foi manter o controle, a Afroditte cobra R$ 0,69 fixos por transação, sem mensalidade e sem percentual, com o valor caindo em real direto na sua conta. Você decide o formato, o ciclo e o preço, e muda quando quiser. Crie sua conta e configure o seu VIP do jeito que o produto pede.

Perguntas frequentes

O que é a assinatura nativa do Telegram?

É um tipo especial de link de convite, criado pelo método createChatSubscriptionInviteLink da Bot API, que cobra do assinante uma quantia em Telegram Stars na entrada e de novo a cada período, sem que ninguém precise lembrar de renovar.

Dá para usar a assinatura nativa em um grupo VIP?

Não. A documentação da Bot API descreve o método como criador de um link de assinatura para um chat de canal. Se o seu produto é um grupo com conversa entre assinantes, esse caminho não atende.

Posso cobrar trimestral ou anual pelo link nativo?

Não hoje. O parâmetro subscription_period é obrigatório e a documentação diz que ele deve ser sempre 2592000 segundos, o equivalente a 30 dias. Não existe campo para outro prazo.

Consigo mudar o preço de um link de assinatura já criado?

O método de edição do link aceita apenas o campo de nome. Para praticar outro preço você cria um link novo, e quem entrou pelo link antigo continua no valor antigo enquanto não sair.

Qual é o preço máximo da assinatura nativa?

O campo subscription_price aceita de 1 a 10000 Telegram Stars por período. É um teto em Stars, não em real, então o valor em reais varia com o preço de compra dos Stars na loja do aplicativo.

Consigo cancelar a cobrança de um assinante específico?

Sim. O método editUserStarSubscription permite ao bot cancelar ou reabilitar a extensão de uma assinatura paga em Stars. Ao cancelar, a assinatura segue ativa até o fim do período corrente.

E se eu quiser devolver o dinheiro de uma cobrança?

Existe o método refundStarPayment, que devolve um pagamento bem-sucedido em Telegram Stars. A devolução acontece em Stars, não em real, e volta para o saldo de quem pagou.

O que acontece com o meu saldo de Stars se a conta for encerrada?

Os termos oficiais dos Telegram Stars dizem que, se a sua conta for encerrada, o saldo restante é considerado permanentemente perdido e não haverá compensação. É a diferença central entre saldo em plataforma e dinheiro na sua conta bancária.

Pronto para vender no automático?

Monte seu funil no Telegram e receba com PIX na hora. R$ 0,69 por transação, sem mensalidade.

Criar conta

Continue lendo