Pular para o conteúdo

NotíciaPublicado em 7 min de leitura

Telegram libera widgets em HTML dentro da mensagem do bot

Em 9 de novembro de 2026, o Telegram lançou a Bot API 10.4: bots agora podem mandar widgets, pequenas telas interativas em HTML desenhadas dentro da própria mensagem. Por enquanto, só na conversa privada com o bot. Dias depois, segundo relatos, os widgets pararam de funcionar para todos, e até 18 de novembro o Telegram não disse quando voltam.

Atualização de 18 de novembro: widgets fora do ar

Dias depois do lançamento, os widgets pararam de funcionar para todos, segundo o canal de notícias tginfo (abre em nova aba), que acompanha o Telegram e atribuiu a parada a falhas de segurança. O Telegram não explicou o motivo. Pavel Durov respondeu no canal dele (abre em nova aba) que a falha apontada não existe do jeito descrito, que era preciso abrir antes um serviço de terceiros e que isso já foi corrigido no servidor. Até 18 de novembro, nenhuma fonte oficial disse que os widgets voltaram. Antes de planejar algo com eles, teste na sua conversa com o bot.

O que mudou na Bot API 10.4

Em 9 de novembro de 2026, o Telegram publicou a Bot API 10.4. A novidade principal é o widget: um bloco interativo, feito em HTML, que o bot desenha dentro da própria mensagem. No dia seguinte, 10 de novembro, Pavel Durov, fundador do Telegram, resumiu assim no canal dele: "qualquer mensagem do Telegram agora pode virar um app".

Na prática, o widget é uma tela pequena que fica na bolha da mensagem, no meio da conversa. A pessoa toca nele e vê a tela mudar sem sair do chat. O Telegram dá como exemplo uma enquete com barras que se mexem a cada voto, uma cotação que se atualiza, um jogo de tabuleiro e um código promocional que copia com um toque.

Três pontos explicam como ele funciona:

  • O desenho é fixo. O bot manda o código do widget uma vez, e ninguém troca depois. Para mudar o layout, o bot manda um widget novo.
  • Os dados mudam. O que aparece dentro dele, como um placar, um preço ou a opção marcada, o bot atualiza na mesma mensagem.
  • O toque pode falar com o bot. Se o bot liberar os pedidos ao mandar o widget, ele manda um pedido curto ao bot, como um botão comum faz, e o bot responde. O bot sabe quem tocou. Um toque também pode mudar só a tela, sem pedido nenhum, como abrir uma resposta ou copiar um código.

O widget roda no aparelho da pessoa, isolado e sem acesso à internet: tudo o que ele mostra vem dentro da mensagem ou do bot. Ele também não é um Mini App. O Mini App é uma página aberta numa janela; o widget faz parte da mensagem e continua à vista enquanto a conversa rola.

Existe ainda o widget compartilhado: o bot manda o mesmo widget em várias conversas e, quando muda os dados dele, a mudança aparece em todas de uma vez. Serve para um placar, uma enquete ou um preço que vale para todo mundo.

Onde o widget funciona hoje

O Telegram diz que libera os widgets em etapas. No Telegram que todo mundo usa, a 10.4 chega com três travas:

  • Só na conversa privada com o bot. Widget em grupo, no modo inline e no encaminhamento funciona por enquanto só no servidor de teste do Telegram, que é onde quem programa testa. Em canal, o bot não posta widget.
  • Conteúdo protegido. Todo widget enviado sai protegido automaticamente: a pessoa não consegue encaminhar a mensagem.
  • Sem cópia. Nem o próprio bot copia a mensagem do widget para outra conversa: a Bot API recusa.

Sempre com legenda

Quem usa um app do Telegram sem suporte a widget vê a mensagem como mídia não suportada, só com a legenda. Por isso o Telegram pede legenda em todo widget: é ela que aparece na lista de conversas, nas notificações e na busca.

O que muda para quem vende pelo Telegram

Até aqui, o bot conversava com texto, mídia e botões embaixo da mensagem. O widget abre outro caminho: uma tela que responde ao toque dentro da conversa. Pelos exemplos do próprio Telegram, dá para pensar em usos assim, todos dependendo de alguém programar o widget:

  • Perguntas frequentes que abrem no toque. O próprio guia do Telegram usa como exemplo a lista de perguntas com respostas que expandem.
  • Cupom que copia com um toque. O app mostra um aviso com o texto copiado, então a pessoa vê o que levou.
  • Resumo do pedido. Um cartão com o que a pessoa escolheu e o total, que o bot atualiza na mesma mensagem.
  • Enquete com o público. Um widget compartilhado enviado a vários compradores, com um resultado só para todos.

Como o widget só vai na conversa privada e não pode ser encaminhado, ele não espalha sozinho: quem recebe é quem já está falando com o bot. O widget também pode ter botões comuns embaixo dele, como qualquer mensagem do bot.

A carteira TON na Bot API 10.4

A 10.4 aproxima o bot da carteira de criptomoeda que já vem no app do Telegram, a carteira TON. Pelo widget, a pessoa paga e assina; fora dele, o bot lê o cartão da carteira e o aviso de transferência:

  • Pagar pelo widget. O widget pede ao bot uma transação, a pessoa confirma numa janela da carteira, que mostra o bot, os valores e o destino, e o bot confere na blockchain se o pagamento saiu.
  • Assinar com a carteira. O widget pode pedir que a pessoa assine um dado com a carteira dela, e o bot recebe a assinatura.
  • Cartão da carteira. O cartão que a pessoa mostra no perfil, com endereço e saldo, chega ao bot pelos dados do perfil e também junto do toque no widget.
  • Aviso de transferência. A conversa ganha um aviso de transferência feita com carteira TON, e o bot recebe esse aviso.

O botão de pagar não aparece para todo mundo. Em app antigo ou em país onde a carteira não está disponível, ela não existe para aquela pessoa, e o Telegram orienta mostrar o botão só quando a carteira está lá. Antes de cobrar por qualquer meio dentro de um bot, leia os termos do Telegram para bots (abre em nova aba).

Os limites que pesam na venda

  • Sem nada de fora. O widget não carrega foto, fonte nem página da internet. Imagem, só embutida no próprio código.
  • Pequeno. O código inteiro, com o que estiver embutido, tem até 32 KB e, depois que o Telegram comprime, no máximo 4 KB. Imagem embutida quase não comprime.
  • Sem teclado. O widget aceita toque, toque longo e arrasto para o lado (para cima e para baixo, quem rola é a conversa), mas não tem campo de texto. Para pedir e-mail ou nome, continua sendo a conversa.
  • Até 600 pixels de altura. Nada rola dentro dele e não existe tela cheia: o que passar da altura fica cortado.
  • Sem recursos de acessibilidade nesta versão. O Telegram pede que o que importa vá também na legenda.
  • Nada de segredo. O Telegram manda tratar o código e os dados compartilhados do widget como públicos.

Outras novidades da 10.4 que tocam a venda

  • Resposta que só quem tocou vê. O toque num botão pode gerar uma resposta visível só para quem tocou, em qualquer conversa, menos no chat de mensagens diretas de canal. Em grupo, isso evita encher a conversa de respostas para uma pessoa só.
  • Número de cartão marcado no texto. O Telegram passa a marcar número de cartão bancário nas mensagens, como já marca telefone e e-mail, e o bot recebe essa marca.

Na LibertyBot hoje

Os bots da LibertyBot não mandam widgets. Nos fluxos Básico e Avançado, os planos aparecem como botões embaixo da mensagem: um plano por linha e, no fim, o VOLTAR. Cada plano pode ter a sua Cor do botão (Padrão, Azul, Verde ou Vermelho), que pinta o botão inteiro no Telegram (em app do Telegram muito antigo, o botão aparece sem cor). Plano ligado sem valor não aparece para o lead.

Para ter o bot que mostra esses botões, comece por como criar um bot no Telegram. Para ver o caminho da conversa até a entrega, veja como a LibertyBot funciona.

Perguntas frequentes

O que é widget no Telegram?

É um bloco interativo em HTML que o bot desenha dentro da mensagem. A pessoa toca nele sem sair da conversa, e o bot pode atualizar o que ele mostra.

Widget funciona em grupo ou canal?

No Telegram que todo mundo usa, ainda não. Na Bot API 10.4, o widget vai só na conversa privada com o bot. Em grupo, ele existe por enquanto só no servidor de teste, e o bot não posta widget em canal.

Dá para encaminhar ou copiar um widget?

Encaminhar, hoje não: no Telegram que todo mundo usa, o widget enviado sai protegido e não pode ser encaminhado. Copiar, não: a Bot API não copia a mensagem de widget.

Widget é a mesma coisa que Mini App?

Não. O Mini App é uma página aberta numa janela, com internet. O widget mora dentro da mensagem, não tem internet e só fala com o bot.

Fontes (conferidas em )

Leia também

  • Guia9 min de leitura

    Como criar um bot no Telegram pelo celular e pegar o token

    Crie o bot no BotFather em poucos minutos, guarde o token como uma senha e ponha o bot como administrador do grupo ou canal, com as permissões certas.

  • Guia13 min de leitura

    Como criar um grupo VIP pago no Telegram

    O caminho completo para montar um grupo VIP pago no Telegram: do grupo privado ao convite de quem pagou e à saída de quem venceu.

  • Função6 min de leitura

    Como liberar acesso automático ao grupo VIP do Telegram depois do pagamento

    Para liberar o acesso ao grupo VIP do Telegram sozinho depois do pagamento, um bot administrador do grupo cria um link de convite para cada compra e o manda na conversa assim que o pagamento é confirmado. Na LibertyBot, isso é a entrega Grupo/Canal VIP do plano: o link vale 24 horas e aceita uma pessoa por vez, e no vencimento o bot tira quem não renovou.

Venda pelo Telegram sem fazer tudo na mão

O bot mostra os planos, gera o PIX, confere o pagamento no gateway e manda o convite do grupo.

Criar conta grátis

Conta grátis. R$ 0,50 por venda no PIX, 5% no cartão.