Glossário · Erros da Meta
Erro 2388040 no WhatsApp Business API
Campo do template acima do limite
- Mensagem da Meta
- A field in your template has exceeded the maximum character limit
- Resposta HTTP
- 400
- Família
- Modelos de mensagem (templates)
O erro 2388040 é devolvido na criação ou edição de um template quando um dos campos passa do limite de caracteres. Diferente do 132005, que acontece no envio com as variáveis preenchidas, este aparece antes: o modelo sequer chega a ser submetido à aprovação.
Por que este erro acontece
- Corpo acima de 1.024 caracteres.
- Cabeçalho de texto ou rodapé acima de 60 caracteres.
- Texto de botão acima de 25 caracteres.
Como resolver
- Corte o corpo até o limite, deixando folga para o tamanho que as variáveis vão ocupar no envio.
- Encurte o rótulo dos botões: eles são o campo mais apertado do modelo.
- Se a mensagem não couber, quebre em duas etapas: template curto para reabrir a conversa e o detalhe na conversa aberta.
O que não adianta tentar
Submeter de novo sem cortar. A validação é feita antes da análise humana.
O que a Skynet.Talk mostra na tela
A Meta devolve o código cru em inglês. A plataforma traduz para uma frase que diz a causa e a ação: "Um campo do modelo passou do limite de caracteres. Reduza o texto do cabeçalho, do corpo, do rodapé ou dos botões." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.
Erros relacionados
Erro 132005 — Texto do template longo demais
O texto do template, já com as variáveis preenchidas, passou do limite de caracteres.
Erro 2388019 — Limite de templates da conta
A conta chegou ao teto de templates cadastrados e não aceita novos até apagar algum.
Perguntas frequentes
Variável conta no limite de criação?
Este erro aparece no meio de um atendimento e some no log de quem integra direto com a Meta. Na Skynet.Talk ele vira uma frase em português na tela de quem atende. Veja o catálogo completo dos códigos ou entenda como a Meta cobra por mensagem.
Publicado por Skynet.Talk · catálogo revisado em 18 de agosto de 2026 · código conferido na documentação oficial da Meta.