Telegram Bot API

Ferramenta de escape de MarkdownV2 e HTML do Telegram

Cole qualquer texto e receba-o escapado para o MarkdownV2 ou o modo HTML do Telegram, para que o sendMessage pare de falhar com Bad Request: can't parse entities.

O MarkdownV2 exige escapar _ * [ ] ( ) ~ ` > # + - = | { } . ! com uma barra invertida; dentro de code e pre, apenas ` e \; dentro dos (…) de um link, apenas ) e \. O HTML exige < > &.

Teste: enviar para um chat

O token fica no seu navegador (localStorage) e é enviado apenas para api.telegram.org.

Como escapar Markdown para um bot do Telegram

  1. Cole o texto literal — um nome de usuário, um preço, uma linha de log. Não cole os seus próprios marcadores de formatação: escape os dados e depois envolva-os você mesmo em *bold* ou <b>.
  2. Escolha o modo: MarkdownV2 texto comum, MarkdownV2 dentro de code/pre, MarkdownV2 dentro dos (…) de um link ou HTML. O resultado é atualizado enquanto você digita.
  3. Clique em Copiar, ou em Como string JSON para obter o valor entre aspas e com as barras invertidas duplicadas — pronto para um corpo JSON ou para o código-fonte.
  4. Opcional: abra Teste, informe o token do bot e um chat_id e envie o resultado com sendMessage e o parse_mode correspondente. No modo code o texto é envolvido em crases; no modo link ele vira a URL de [link](…).

Regras de escape do MarkdownV2 no Telegram

As regras vêm das opções de formatação do Bot API:

Exemplo: Price: 5.99 (incl. tax) - order #42! vira:

Price: 5\.99 \(incl\. tax\) \- order \#42\!

O ponto e o ponto de exclamação são as surpresas clássicas: esqueça um deles e a requisição inteira falha.

Modo HTML do Telegram

No modo HTML, todo <, > e & que não faz parte de uma tag ou entidade deve ser escrito como &lt;, &gt; e &amp;. A ferramenta substitui exatamente esses três caracteres. Como a regra é tão curta, o HTML costuma ser a opção mais segura para texto dinâmico. A lista de tags suportadas está em /pt/guides/telegram-bot-send-message.html.

Privacidade

O escape acontece inteiramente no seu navegador — nenhuma requisição é feita. Só o teste opcional envia uma requisição sendMessage, direto do navegador para api.telegram.org; o token fica no localStorage e nunca chega ao nosso servidor. Você também pode montar a requisição no /pt/telegram-bot-api-tester.html#sendMessage. Outros textos de erro são explicados em /pt/guides/telegram-bot-api-errors.html.

Perguntas frequentes

Quais caracteres precisam de escape no MarkdownV2 do Telegram?

No texto comum: _ * [ ] ( ) ~ ` > # + - = | { } . !, cada um precedido por uma barra invertida (a própria barra invertida também é escapada). Dentro de code e pre, apenas ` e \; dentro dos (…) de um link, apenas ) e \.

Por que o sendMessage falha com "can't parse entities"?

O texto contém um caractere reservado sem escape ou uma entidade que não foi fechada. A mensagem de erro do Telegram costuma indicar o caractere. Escape as partes dinâmicas do texto e deixe sem escape apenas os seus próprios marcadores de formatação.

Devo usar MarkdownV2 ou HTML?

Para texto vindo de usuários ou de bancos de dados, o HTML costuma ser mais fácil: só <, > e & precisam ser substituídos. O MarkdownV2 exige escapar 18 caracteres.

Preciso escapar o texto dentro de blocos de código?

No MarkdownV2, apenas ` e \ dentro de code e pre. Escolha o modo correspondente na ferramenta. No modo HTML, os mesmos três caracteres de sempre.

Outros utilitários

Localizador de chat IDValidador de initData do Mini AppVerificador de webhookBot API Tester