# Erros do Telegram

> Por que uma mensagem do bot do Telegram não sai: contato que bloqueou o bot, mensagens demais, token trocado, arquivo grande e o que fazer em cada caso.

Endereço: https://help.nextags.com.br/tutoriais/erros/erros-do-telegram/
Tipo: Referência · Intermediário

Atualizado em: 25/10/2026

Quando o Telegram recusa uma mensagem do seu bot, a resposta dele traz um código e uma descrição do erro, em inglês. Na NexTags, procure a falha no aviso vermelho *A mensagem não foi enviada.*, embaixo da mensagem, no **Registro de Erros** da área **Fluxos** e no **Histórico** do contato. O Telegram avisa que os códigos podem mudar: leia também a descrição.

## Os códigos

| Código | O que quer dizer | O que fazer | Veja |
|---|---|---|---|
| 403 | O Telegram chama de violação de privacidade, como mandar mensagem para quem bloqueou você. Por exemplo, o contato bloqueou o bot. | Não insista: a mensagem não chega a quem bloqueou o bot. | [Mensagens que não chegam ao contato](https://help.nextags.com.br/tutoriais/erros/mensagens-nao-chegam/) |
| 429 | Mensagens demais em pouco tempo. A resposta diz quantos segundos esperar. | Espere e mande de novo mais tarde. Para muitos contatos, espalhe os envios ao longo de horas, como o Telegram recomenda. | [Agendar um Broadcast](https://help.nextags.com.br/tutoriais/disparos/agendar-disparo/) |
| 401 | Acesso não autorizado: o token do bot não vale mais, por exemplo porque foi trocado no @BotFather. | Pegue o token atual no @BotFather, com **/mybots**, desconecte o Telegram e conecte de novo com ele. | [Conectar um bot do Telegram](https://help.nextags.com.br/tutoriais/canais/conectar-telegram/) |
| 400 | O pedido tem um erro, como um dado que o Telegram não aceita. | Confira o conteúdo da mensagem: o texto, os botões e o arquivo. Se continuar, fale com o suporte. | [Como falar com o suporte](https://help.nextags.com.br/comecar/falar-com-o-suporte/) |
| 500 | Erro interno do Telegram. | Tente de novo mais tarde. | [Como falar com o suporte](https://help.nextags.com.br/comecar/falar-com-o-suporte/) |

## Os limites de envio

O Telegram não deixa um bot mandar mensagens sem parar. Passando destes limites, chega o erro 429:

| Onde | Limite |
|---|---|
| Na mesma conversa | Cerca de 1 mensagem por segundo. O Telegram aceita picos curtos. |
| Num grupo | Até 20 mensagens por minuto. |
| Para muitos contatos ao mesmo tempo | Cerca de 30 mensagens por segundo. |

Fonte: [perguntas frequentes do Telegram para bots](https://core.telegram.org/bots/faq#my-bot-is-hitting-limits-how-do-i-avoid-this), consultadas em 25/10/2026.

## Situações sem código

| Situação | O que quer dizer | O que fazer | Veja |
|---|---|---|---|
| A pessoa nunca escreveu para o bot | Bots não começam conversas: a pessoa precisa mandar a primeira mensagem ou pôr o bot num grupo. | Divulgue o link do bot, no formato t.me/nome_do_bot, para a pessoa começar a conversa. | [Conectar um bot do Telegram](https://help.nextags.com.br/tutoriais/canais/conectar-telegram/) |
| O bot parou de receber mensagens depois de ser ligado a outra ferramenta | Cada bot tem um só endereço de entrega (webhook) no Telegram. Se outra ferramenta configurou o bot depois, as mensagens vão para ela. | Use o bot só na NexTags. Depois, desconecte o Telegram e conecte de novo, com o token do bot. | [Reconectar um canal e atualizar as permissões da Meta](https://help.nextags.com.br/tutoriais/canais/reconectar-e-permissoes/) |
| O arquivo não sai ou não chega | Bots mandam arquivos de até 50 MB e só baixam até 20 MB do que os contatos mandam. | Mande um arquivo menor. | [Tipos de arquivo e limites por canal](https://help.nextags.com.br/tutoriais/canais/tipos-de-arquivo-e-limites/) |
| O campo de mensagem avisa *O usuário ficou inativo por mais de 24 horas* | A conversa veio de uma conta do Telegram Business. Nesse caso, a Caixa de Entrada só responde até 24 horas depois da última mensagem do contato. | Espere o contato escrever de novo. Nas outras conversas do Telegram, não há prazo. | [Responder uma conversa](https://help.nextags.com.br/tutoriais/caixa-de-entrada/responder-conversas/) |
| Apareceu *Já conectado a outra conta comercial.* ao conectar | O bot já está em outra conta da NexTags. | Desconecte lá e conecte de novo aqui. | [Canal que não conecta](https://help.nextags.com.br/tutoriais/erros/canal-nao-conecta/) |

## Os outros erros

A documentação oficial explica como o Telegram responde aos erros, em inglês: [Bot API](https://core.telegram.org/bots/api#making-requests) e [tipos de erro da API do Telegram](https://core.telegram.org/api/errors), consultadas em 25/10/2026.

> **Não achou o erro?:**
> Fale com o suporte, de segunda a sexta, das 8h às 17h (horário de Brasília). Mande a descrição do erro, o horário do envio e o contato. Veja [Como falar com o suporte](https://help.nextags.com.br/comecar/falar-com-o-suporte/).