Resumo
Este artigo de ajuda fornece um guia abrangente para solucionar problemas de mensagens de erro comuns encontradas ao enviar transmissões ou mensagens de modelo no WATI. Ele aborda vários cenários de erro, suas possíveis causas e soluções práticas para resolver. O guia também inclue informações sobre restrições do Meta, requisitos de mensagens de modelo, limites de mensagens e problemas relacionados a pagamentos. Se você não encontrar uma resolução para um erro específico, o artigo fornece detalhes sobre como entrar em contato com o suporte do WATI para obter assistência adicional.
Instruções
Pode ser que você encontre erros ao enviar mensagens no WATI. Abaixo estão as mensagens de erro comuns, seus significados e os passos para solucionar.
A mensagem não é entregue e você vê o seguinte erro:
Isso significa que o WhatsApp não conseguiu entregar sua mensagem devido a um problema com o número de telefone do destinatário.
O número pode não estar associado a uma conta válida do WhatsApp.
O código do país pode estar faltando.
O destinatário pode estar usando uma versão desatualizada do WhatsApp.
O destinatário não aceitou os Termos de Serviço e Política de Privacidade mais recentes do WhatsApp.
Peça a eles para visitar este link para aceitar os últimos Termos de Serviço.
Leia mais sobre este erro aqui: "Mensagem não entregável" ao enviar mensagens de modelo
A mensagem não é entregue e você vê o seguinte erro:
“Message undeliverable as Meta has restricted it for higher quality messaging - retry again in a few days.”
Se você estiver enviando um modelo de marketing, note que o Meta impõe restrições sobre essas mensagens. Consulte este guia para saber mais sobre essas restrições.
O número do usuário não está acessível e você vê o seguinte erro:
“O número do usuário faz parte de um experimento”
Desde 14 de junho de 2023, o Meta está executando experimentos onde cerca de 1% dos usuários do WhatsApp não recebem mensagens de modelo de marketing de empresas a menos que tenham iniciado a conversa primeiro. Se isso acontecer, você precisará entrar em contato com o cliente por outro canal e pedir para que eles te envie uma mensagem, permitindo que você envie o modelo de marketing dentro da janela de 24 horas.
Você não consegue enviar as mensagens e vê um dos seguintes erros:
“Limite de taxa de spam atingido”
"A mensagem não conseguiu ser enviada porque existem restrições sobre quantas mensagens podem ser enviadas deste número de telefone. Isso pode ser porque too muitas mensagens anteriores foram bloqueadas ou marcadas como spam."
Este erro indica que o número de mensagens enviadas de sua conta excedeu o Limite de Mensagens definido pelo WhatsApp (ex.: 1k/10k/100k contatos por 24 horas). Uma vez que a janela de 24 horas seja reiniciada, você poderá continuar enviando mensagens. Seu nível de mensagens aumentará automaticamente ao longo do tempo com base no volume e na avaliação da qualidade das suas mensagens. Verifique seu limite de mensagens em Análise de Transmissão ou na página Status do Canal. O limite de mensagens é um processo automatizado do WhatsApp com base em seu histórico de volume e avaliações de qualidade de mensagens.
Você não consegue enviar mensagens e vê o seguinte erro:
“A conta foi bloqueada.”
Verifique se sua conta está atualmente restrita ou desativada pelo Meta.
Se estiver restrita, você pode apresentar um recurso ao Meta.
Revisões geralmente levam 24-48 horas.
Se a restrição foi levantada, mas o erro persistir, entre em contato conosco para assistência adicional.
Você não pode usar um modelo e vê um dos seguintes erros:
"Verifique seu modelo, ele não pode conter erros de digitação ou texto em branco"
Certifique-se de que o modelo está corretamente formatado e não contém campos em branco.
"Atributos do cliente ausentes - verifique as informações de contato"
Verifique se todas as informações necessárias do cliente foram incluídas na sua mensagem.
"Informações ausentes - verifique o mídia do modelo ou as informações de contato"
Certifique-se de que todos os parâmetros/variáveis necessários estão preenchidos corretamente ao enviar uma mensagem de modelo.
Se estiver usando um cabeçalho dinâmico, defina sempre um valor para o cabeçalho.
Evite usar quebras de linha, guias ou mais de quatro espaços consecutivos em parâmetros do modelo e conteúdo de carrossel.
Algumas variáveis são específicas para Shopify ou integração com WooCommerce, algumas variáveis podem ser usadas apenas para mensagens automatizadas específicas.
A mensagem não conseguiu ser enviada e você vê o seguinte erro:
"A mensagem não conseguiu ser enviada porque havia um ou mais erros relacionados ao seu método de pagamento"
Se você recentemente criou uma conta ou migrou de outro BSP para o WATI, certifique-se de que seguiu os passos corretos de cadastramento. Por favor, clique aqui para ler mais sobre os passos.
Você pode precisar criar uma nova Conta WhatsApp Business e repetir o processo de cadastramento. Siga os passos aqui.
Você não consegue usar um modelo e vê um dos seguintes erros:
"O nome do modelo não existe"
"O status do modelo está pausado ou desativado; não é possível enviá-lo."
Novos modelos aprovados podem levar 15-30 minutos para aparecer nos registros do Facebook.
O WhatsApp pode ter desativado o modelo devido a uma avaliação de baixa qualidade.
Verifique esse status no Gerenciador do WhatsApp na sua Conta Business do Facebook.
Você pode enviar o conteúdo novamente como um novo modelo e ver se o WhatsApp o aprova. Uma vez aprovado, você poderá usá-lo novamente.
Se o modelo foi excluído, você pode precisar enviá-lo novamente como um novo modelo.
Se estiver enviando por API, verifique erros de digitação no nome do modelo.
Você está vendo o seguinte erro sobre a mensagem:
"Texto traduzido muito longo."
Verifique a mensagem que você enviou e certifique-se de que a conta de caracteres não exceda as regras de formatação:
Certifique-se de que sua mensagem atenda aos seguintes limites de caracteres:
Cabeçalho e Rodapé: 60 caracteres
Corpo: 1024 caracteres
Botão de Visitar Site dinâmico: 2000 caracteres
Símbolos de formatação também contam para o limite de caracteres.
Você está tentando enviar uma mensagem via API e vê o seguinte erro:
"Não há parâmetros de solicitação obrigatórios suficientes para enviar o modelo XYZ"
Se estiver enviando uma mensagem de modelo via API, certifique-se de que todos os parâmetros e valores estão definidos corretamente.
Verifique erros de digitação nos nomes dos parâmetros.
Compilamos uma biblioteca de receitas de API para ajudar você a tirar o máximo proveito do WATI. Você pode encontrá-las aqui
Você está tentando enviar uma mensagem via API e vê o seguinte erro:
"O número de parâmetros não corresponde ao número esperado de parâmetros!"
Se você atualizou o número de parâmetros no Gerenciador do WhatsApp, você deverá enviar um novo modelo em vez de modificar um existente.
Você está tentando enviar um mídia e vê o seguinte erro:
"Erro ao fazer upload de mídia"
Certifique-se de que o mídia carregado atende às diretrizes de mídia suportadas pelo WhatsApp: diretrizes:
Imagens: Deve ser 8-bit, RGB ou RGBA.
Vídeos: Devem usar codec de vídeo H.264 e codec de áudio AAC. Apenas um stream de áudio é permitido.
Documentos: Se usados como cabeçalho do modelo, apenas o formato PDF é suportado.
Se um vídeo atende ao limite de tamanho ainda assim falha, tente convertê-lo usando um conversor online para resolver o problema de codec.
Você não consegue entrar em contato com um usuário e vê o seguinte erro:
"Erro de usuário genérico"
Esse é um erro desconhecido do Meta para modelos recentemente aprovados.
Tente enviar o modelo novamente e veja se o problema é resolvido.
Você não consegue usar um modelo e vê o seguinte erro:
"O conteúdo nesta linguagem já existe"
Verifique se outro modelo aprovado tem o mesmo nome.
Modelos excluídos permanecem pendentes de exclusão por 30 dias, impedindo o reuso do mesmo nome nesse período.
Você não consegue enviar uma mensagem de transmissão e vê o seguinte erro:
"Créditos insuficientes"
Certifique-se de que tem créditos suficientes para a transmissão.
Verifique se todos os contatos estão com os códigos de país corretos adicionados.
Perguntas Frequentes (FAQs)
Perguntas Gerais
1. Por que estou vendo um erro ao enviar uma mensagem no WATI?
→ Erros podem ocorrer devido a vários motivos, como números de telefone incorretos, restrições do WhatsApp, parâmetros ausentes ou limites de mensagens.-Verifique os detalhes da mensagem de erro neste guia para solucionar o problema.
Erros de Entrega e Limites de Mensagens
2. O que significa “Message undeliverable”?
→ Este erro ocorre quando o número do destinatário é inválido, está faltando o código do país, está usando uma versão desatualizada do WhatsApp ou não aceitou os Termos de Serviço mais recentes do WhatsApp.
3. Por que minha mensagem não consegue ser enviada devido a “Spam rate limit hit”?
→ Isso significa que você excedeu o limite de mensagens do WhatsApp para seu nível de conta (1k/10k/100k mensagens por 24 horas). Aguarde a janela de 24 horas ser reiniciada antes de continuar.
4. Como posso verificar meu limite de mensagens?
→ Você pode verificar seu nível de limite de mensagens em Análise de Transmissão ou na página de Status do Canal.
5. Por que minha mensagem é bloqueada devido a restrições do Meta em modelos de marketing?
→ O Meta impõe restrições em modelos de marketing para controle de qualidade. Se você ver este erro, tente novamente após alguns dias ou use uma abordagem diferente para se envolver com o seu público.
Problemas com Modelos e Formatação
6. Por que vejo “Template name does not exist”?
→ O modelo pode não ter sido registrado no sistema, ou pode haver um erro de digitação no nome, se estiver usando a API.
7. O que fazer se meu modelo está “paused or disabled”?
→ Modelos aprovados recentemente podem levar 15-30 minutos para aparecer nos registros do Facebook. Se desativado, verifique o Gerenciador do WhatsApp na sua Conta Business do Facebook quanto a problemas de qualidade ou envie um novo modelo.
8. Como corrigir o erro “Translated text too long”?
→ Certifique-se de que sua mensagem não exceda os seguintes limites de caracteres:
Cabeçalho/rodapé: 60 caracteres
Corpo: 1024 caracteres
Botão de Visitar Site: 2000 caracteres
9. O que significa “Not enough required request Parameters to send template XYZ”?
→ Se você estiver usando a API, verifique se todos os parâmetros estão corretamente incluídos na sua solicitação. Verifique erros de digitação e valores ausentes.
Problemas com Conta e Pagamento
10. O que significa “Account has been locked”?
→ Sua conta pode estar restrita ou desativada pelo Meta. Você pode enviar um recurso, e o processo de revisão geralmente leva 24-48 horas.
11. Como resolver “Message failed to send because there were one or more errors related to your payment method”?
→ Se você recentemente criou uma conta ou migrou de outro BSP, certifique-se de que seguiu o processo de cadastramento correto da Conta WhatsApp Business.
12. O que fazer se eu ver o erro “Insufficient credits”?
→ Verifique seus créditos disponíveis para transmissões e certifique-se de que seus contatos estejam com os códigos de país corretos adicionados.