Códigos crus da Meta dizem pouco. Aqui ficam 10 erros mais comuns com explicação humana e solução pronta. Arara Diagnostics traduz isso em runtime — você só lê.
ararahq-63016A Meta exige que, após 24h sem interação do cliente, o primeiro contato seja obrigatoriamente via um Template Aprovado.
SoluçãoEnvie uma mensagem de Template para reabrir a conversa com este cliente.
ararahq-invalid-numberO número de destino não possui uma conta ativa no WhatsApp ou está formatado incorretamente.
SoluçãoVerifique o formato (+55DDD9XXXXXXXX) e confirme se o número possui WhatsApp.
ararahq-meta-blockA Meta detectou comportamento de marketing excessivo ou houve denúncias recentes de spam por parte dos usuários.
SoluçãoAguarde uma interação espontânea do usuário ou revise o conteúdo pra ser menos agressivo.
ararahq-opt-outO cliente final clicou em 'Bloquear' ou 'Parar' no WhatsApp para não receber mensagens da sua empresa.
SoluçãoRespeite a decisão e remova este contato da sua lista de disparos.
ararahq-template-errorModelo reprovado pela Meta ou pausado automaticamente por baixa qualidade nas métricas de leitura.
SoluçãoVerifique o status do template no Gerenciador de Negócios da Meta e ajuste o conteúdo.
ararahq-genericErro genérico no processamento da operadora ou do provedor upstream Meta.
SoluçãoTente reenviar em alguns minutos. Se persistir, fale com suporte.
ararahq-insufficient-fundsSua carteira Arara não possui créditos suficientes pra realizar o envio.
SoluçãoAcesse 'Faturamento' no painel e recarregue via PIX ou cartão.
ararahq-rate-limitVocê atingiu o número máximo de requisições por segundo do seu plano.
SoluçãoImplemente uma fila com retry e backoff exponencial, ou use o motor de Campanhas.
ararahq-template-mismatchOs dados em 'variables' não coincidem com os placeholders {{n}} definidos no template.
SoluçãoConfira a estrutura do template no dashboard e passe todos os parâmetros corretos.
ararahq-media-invalidO arquivo excede os limites Meta (16MB vídeo / 100MB doc) ou o formato não é aceito.
SoluçãoComprima o arquivo ou use formatos suportados (PDF, MP4, JPG).
Encontrou erro fora dessa lista? Manda email — adicionamos junto com a solução em até 48h.