Você está no lugar certo se:
Sua campanha ficou com status Falha e apareceu um código como 131009, 131042 ou 100
Você viu a mensagem "Parameter value is not valid" e não sabe o que corrigir
Os disparos pararam de sair e aparece algo sobre pagamento ou cobrança na Meta
Você editou um modelo aprovado e as campanhas continuam falhando
O botão de copiar código Pix ou da oferta está dando erro no envio
Nenhuma mensagem de uma ação é entregue e aparece o código 132005
Visão geral
Quando uma campanha pelo WhatsApp API Oficial falha, o motivo quase sempre vem da Meta, não da Martz. A Meta devolve um código numérico, um título curto em inglês e uma descrição. Esse conjunto é a chave para entender o que corrigir.
Na Martz, você encontra esse retorno abrindo a campanha na aba Atividades, localizando a mensagem com status Falha e clicando em Ver detalhes. O mesmo código também aparece no menu Atividades do painel, filtrando por campanha, status e período. Veja também Principais motivos de falhas no envio.
Referência rápida dos códigos
Código | O que significa | Onde resolver |
131009 | Valor de parâmetro inválido (variável ou botão do modelo) | Situação 1 |
100 | Parâmetro inválido no envio (erro genérico da Meta) | Situação 2 |
131042 | Pendência de pagamento ou cobrança na Meta | Situação 3 |
132000 | Número de variáveis do envio diferente do modelo | Situação 4 |
132001 | Modelo não existe, idioma errado ou não aprovado | Situação 4 |
132005 | Texto do título passou do limite | Situação 5 |
131031 | Conta do WhatsApp bloqueada ou restringida pela Meta | Situação 6 |
131047 | Janela de 24 horas expirou (mensagem livre) | Situação 7 |
131026 | Mensagem não entregue ao destinatário | Situação 8 |
131053 | Erro no envio de mídia (imagem, vídeo ou documento) | Situação 8 |
133010 | Número não registrado (perdeu a conexão) |
Situação 1: erro 131009, "Parameter value is not valid"
O que acontece: a campanha falha e no detalhe aparece o código 131009 com a frase "Parameter value is not valid". Às vezes vem um complemento citando o botão, um CTA ou um nome de loja.
Por que acontece: algum valor da mensagem não está no formato que a Meta espera. Nas campanhas da Martz isso aparece com mais frequência em duas situações: uma variável do modelo fora do padrão de ordem, tipo ou limite de caracteres, ou um botão de pagamento (Pix, copiar código, detalhes do pedido) recebendo um conteúdo que ele não aceita.
Um caso comum: usar o botão Copiar código da oferta para enviar um código Pix. Esse botão não aceita mais de 15 caracteres nem caracteres especiais, então o código Pix quebra o envio. O formato certo para Pix é o Detalhes do pedido, que precisa ser liberado pela Meta antes de usar.
Como resolver:
Abra a campanha, vá em Editar e depois em Ações, e confira o modelo de mensagem usado.
Verifique cada variável do modelo: ela deve seguir a ordem, o tipo e o limite de caracteres definidos na aprovação. Evite caracteres especiais em botões.
Se o objetivo é enviar código Pix ou detalhes do pedido, solicite ao suporte da Meta a liberação do formato Detalhes do Pedido (Order Details) para a sua conta.
Após a Meta confirmar a liberação, avise o time da Martz para habilitarmos o formato na sua loja. Só depois disso ele aparece para criação de modelos no painel.
Atenção: o botão de copiar código serve para cupons e bônus curtos. Para código Pix, chave ou valores longos, o caminho é o formato Detalhes do pedido liberado pela Meta.
Situação 2: erro 100, "Invalid parameter"
O que acontece: a campanha falha com "(#100) Invalid parameter". A descrição que acompanha varia bastante: pode citar um botão, um campo obrigatório ausente, um valor fora do formato ou um parâmetro que a Meta não reconhece.
Por que acontece: o 100 é o erro mais genérico da Meta para parâmetro inválido. O texto que vem depois do código é o que diz qual parâmetro está errado. As causas mais comuns são:
Botão ou componente do modelo com valor faltando, vazio ou em formato inválido.
Variável fora do padrão esperado (tipo, ordem ou caractere não aceito).
Número do destinatário fora do formato correto com código do país.
Modelo aprovado que foi editado. Ao editar o antigo, a campanha continua apontando para a ação anterior, que segue sendo enviada e falhando.
Como resolver:
Leia a descrição que vem junto ao código 100 para saber qual parâmetro está inválido.
Ajuste o parâmetro apontado: preencha o campo obrigatório, corrija o formato da variável ou do número, ou remova o caractere não aceito.
Se o erro surgiu após editar um modelo aprovado: crie um modelo novo, sem parâmetros de rastreio (UTMs) nos links dos botões. Aguarde a aprovação, abra a campanha em Editar e depois Ações, e troque a ação antiga pela nova mensagem aprovada.
Faça um envio de teste e confira se saiu sem falha.
Situação 3: erro 131042, pendência de pagamento na Meta
O que acontece: os disparos param e a falha indica o código 131042, com a frase "Business eligibility payment issue". Todas as atividades ficam com falha ao mesmo tempo.
Por que acontece: a conta do WhatsApp Business na Meta está com um problema de cobrança: ausência de forma de pagamento válida, cartão vencido, limite estourado ou saldo em aberto.
Como resolver: regularize a forma de pagamento e o saldo na Meta. O atalho Métodos de pagamento, nos detalhes do número em Configurações › WhatsApp › Telefones oficiais, abre a cobrança da conta. O passo a passo completo está em Erro 131042 no disparo de WhatsApp e em Problemas com pagamento da Meta.
Situação 4: erros 132000 e 132001, problema no modelo
O que acontece: a falha traz o código 132000 ("Template Param Count Mismatch") ou 132001 ("Template does not exist").
Por que acontece: no 132000, o número de variáveis enviadas é diferente do que o modelo aprovado espera. No 132001, o modelo não existe naquele idioma, o nome não confere com o aprovado ou ele ainda está em análise pela Meta.
Como resolver:
Confira quantas variáveis o modelo tem.
Garanta que a ação da campanha preencha exatamente esse número de variáveis, sem faltar nem sobrar.
Confira se o status do modelo está Aprovado antes de disparar. Se o modelo foi criado direto na Meta, use sincronizar modelos em Configurações › WhatsApp › Modelos de mensagem.
Situação 5: erro 132005, título do modelo acima do limite
O que acontece: nenhuma mensagem da ação é entregue e, em Ver detalhes, aparece o código 132005. A ação inteira é recusada, não só alguns contatos.
Por que acontece: o título (cabeçalho) do modelo tem limite de 60 caracteres, contando o texto fixo do título somado ao texto preenchido na variável. Quando o total passa de 60, a Meta recusa todas as mensagens da ação.
Como resolver:
Abra a ação da campanha e localize o conteúdo usado na variável do título.
Encurte esse conteúdo para que título fixo + variável fiquem dentro de 60 caracteres.
Salve e faça um envio de teste para confirmar.
Situação 6: erro 131031, conta bloqueada ou restringida pela Meta
O que acontece: o disparo falha com o código 131031, geralmente com uma descrição indicando que a conta está bloqueada ou restringida. Costuma afetar todas as atividades ao mesmo tempo.
Por que acontece: a Meta bloqueou ou restringiu a conta do WhatsApp Business. Causas comuns: suspeita de violação de política, qualidade baixa do número (muitos bloqueios e denúncias), comportamento identificado como spam ou pendência de verificação do negócio.
Como resolver:
No Gerenciador de Negócios da Meta, verifique se há aviso de restrição, violação de política ou pendência de verificação na conta do WhatsApp.
Se houver violação apontada, use a opção Solicitar revisão no aviso da Meta. Veja Conta comercial do WhatsApp desabilitada pela Meta.
Confirme se a verificação do negócio está concluída e se não há pendência de pagamento.
Enquanto a conta estiver restrita, evite novos disparos no número afetado.
Na Martz, os detalhes do número mostram a Qualidade do envio, a Violação de políticas e os avisos Banido ou Banido em breve. Veja Detalhes do número oficial.
Situação 7: erro 131047, janela de 24 horas expirada
O que acontece: a mensagem falha com o código 131047 e a frase indica que passaram mais de 24 horas desde a última resposta do cliente.
Por que acontece: a Meta só permite mensagem livre nas 24 horas seguintes à última resposta do cliente. Passado esse prazo, é preciso usar um modelo aprovado para reabrir a conversa.
Como resolver:
Use um modelo de mensagem aprovado para reabrir a conversa, em vez de texto livre.
Assim que o cliente responder ao modelo, a janela de 24 horas reabre e a mensagem livre volta a funcionar.
Situação 8: erros 131026 e 131053, entrega e mídia
O que acontece: o 131026 ("Message Undeliverable") indica que a mensagem não chegou ao aparelho do cliente. O 131053 ("Media upload error") indica falha na imagem, vídeo ou documento anexado.
Por que acontece: no 131026, em geral o número não está ativo no WhatsApp, está fora do formato correto ou o cliente não aceitou os termos mais recentes do app. No 131053, a mídia está em formato não suportado ou acima do limite de tamanho.
Como resolver:
Para o 131026, confirme que o número está ativo no WhatsApp e no formato correto com código do país.
Para o 131053, ajuste a mídia ao formato e tamanho aceitos (imagem jpg ou png até 5 MB; vídeo mp4 até 16 MB, em H.264 com áudio AAC). Comprima ou reexporte o arquivo e envie de novo.
Dúvidas frequentes
O erro é da Martz ou da Meta?
Esses códigos vêm da Meta e descrevem algo na conta, no modelo ou no envio pela API Oficial. A Martz apenas exibe o retorno. Por isso a correção quase sempre passa pelo Gerenciador da Meta ou pela configuração da campanha.
Corrigi o problema. Preciso reenviar?
As mensagens que falharam não são reenviadas sozinhas. Após ajustar a causa, os novos disparos saem normalmente. Se tiver muitas atividades com falha, acione o suporte para orientar o reenvio.
Ainda com problema?
Se as etapas acima não resolveram, fale com o suporte pelo chat da plataforma. Para agilizar, envie:
O código completo do erro e a descrição, copiados da janela Ver detalhes
O fbtrace_id que aparece nos dados da falha
O nome da loja e o nome da campanha afetada
Um print da tela de Atividades mostrando o status Falha