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.
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 |
| 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 |
| 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 |
| 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 |
| 500 | Erro interno do Telegram. | Tente de novo mais tarde. | Como 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, 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 |
| 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 |
| 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 |
| 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 |
| 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 |
Os outros erros
A documentação oficial explica como o Telegram responde aos erros, em inglês: Bot API e tipos de erro da API do Telegram, 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.
Relacionados
Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.