Solução de Problemas ⚠️
- Erros do PortSIP
- Falhas de envio pelo GA (Envios manuais)
- Atenção: Esta mensagem não foi entregue para manter o engajamento saudável do ecossistema. Detalhe: In order to maintain a healthy ecosystem engagement, the message failed to be delivered.
- Erro ao enviar mensagem. OAuthException, (#132018) There’s an issue with the parameters in your template
- Erro na API Meta (codigo 130472). Consulte o suporte se o problema persistir. Detalhe: Failed to send message because rhis usher's phone number ir part of an experiment
- Erro Whatsapp / Meta #131048
- Erro Whatsapp/Meta #331026
- Erro Whatsapp / Meta #131042 : Ocorreu um erro relacionado ao seu método de pagamento
- Falhas de envios por Campanha (Automações)
- A mensagem nao foi enviada e o conector nao registrou um motivo detalhado
- Conta do WhatsApp Business bloqueada ou restrita. Revise o Gerenciador do WhatsApp Business.
- A mensagem nao foi enviada e o conector nao registrou um motivo detalhado
- Fila da conexão não condiz com a campanha
- Falha no envio - Nenhuma conexão padrão foi encontrada
- Portsip - Erros
- Quando a empresa não se qualifica para a verificação
Erros do PortSIP
1. Erro “400 Bad Request”
Causas identificadas:
Correções realizadas:
2. Erro “Forbidden (Bad auth)”
Causa identificada:
Correções realizadas:
3. Erro “503 Service Unavailable”
Causas identificadas:
Correções realizadas:
4. Aplicativo desconectando sozinho após um período
Causas identificadas:
Correções realizadas:
5. Erro “Request Timeout” em Wi-Fi específico
Causas identificadas:
Correção que resolveu:
Resultado:
6. PortSIP não permitia alterar de UDP para TCP
Correções realizadas:
Falhas de envio pelo GA (Envios manuais)
Atenção: Esta mensagem não foi entregue para manter o engajamento saudável do ecossistema. Detalhe: In order to maintain a healthy ecosystem engagement, the message failed to be delivered.
Esse bloqueio acontece quando a Meta identifica que um template está com baixo engajamento dos usuários, como poucas respostas, poucos cliques ou ausência de interação após o envio das mensagens.
Quando isso acontece, o sistema pode interpretar o template como um possível envio de spam ou comunicação de baixo interesse para os usuários. Como forma de proteger a experiência dentro do WhatsApp, a Meta começa a limitar ou impedir novos envios desse modelo de mensagem.
Normalmente isso ocorre em templates que:
- possuem mensagens muito genéricas;
- não deixam claro o motivo do contato;
- não incentivam interação do usuário;
- têm baixa taxa de resposta ou clique;
- são enviados para muitos contatos sem retorno.
Possível correção
O recomendado nesses casos é criar um novo template ou editar o atual, deixando a comunicação mais objetiva, contextual e clara sobre o motivo do contato.
Além disso, incluir botões de ação costuma ajudar bastante no engajamento, como por exemplo:
- “Confirmar interesse”
- “Falar com atendente”
- “Agendar horário”
- “Saiba mais”
Esses botões aumentam a taxa de interação do cliente, melhoram os indicadores de engajamento e reduzem as chances de limitação pela Meta.
Outro ponto importante é garantir que o público que está recebendo as mensagens realmente tenha contexto ou interesse naquele contato, evitando disparos muito amplos ou pouco segmentados.
Erro ao enviar mensagem. OAuthException, (#132018) There’s an issue with the parameters in your template
Esse erro acontece quando existe alguma inconsistência entre os parâmetros enviados na mensagem e a estrutura do template aprovado na Meta/WhatsApp.
Na prática, o template espera receber determinadas variáveis, conteúdos ou formatos específicos, mas no momento do envio alguma informação está diferente, faltando ou incompatível.
Os casos mais comuns são:
- quantidade de variáveis diferente do template;
- parâmetro vazio ou nulo;
- envio de texto em campo que espera imagem/documento;
- ordem incorreta dos parâmetros;
- variável configurada no template mas não enviada no payload;
- botão dinâmico sem parâmetro obrigatório;
- template editado na Meta, mas não atualizado/sincronizado na plataforma;
- caracteres ou formatações inválidas em variáveis.
Exemplo clássico:
O template possui:
Mas o sistema envia apenas:
Nesse caso, a variável {{2}} fica faltando e a Meta retorna o erro #132018.
Sugestão de correção:
O ideal é validar se os parâmetros enviados estão exatamente iguais à estrutura configurada no template da Meta.
Recomendações:
- conferir quantidade e ordem das variáveis;
- validar se nenhum parâmetro está vazio;
- revisar se o tipo do conteúdo enviado corresponde ao template;
- sincronizar novamente os templates caso tenham sido alterados na Meta;
- testar o template diretamente pela Meta/API antes de usar na automação;
- evitar parâmetros dinâmicos sem validação prévia.
Erro na API Meta (codigo 130472). Consulte o suporte se o problema persistir. Detalhe: Failed to send message because rhis usher's phone number ir part of an experiment
O erro que apareceu não é bloqueio do número, nem problema da sua API. O código 130472 significa que o telefone da cliente entrou em um experimento da Meta/WhatsApp. A Meta faz isso com uma pequena parcela dos usuários para limitar o recebimento de mensagens iniciadas por empresas — principalmente templates de marketing.
O trecho do erro confirma isso:
“Failed to send message because this user's phone number is part of an experiment”
O que está acontecendo na prática
Se você está tentando iniciar uma conversa via template (fora da janela de 24h), a Meta pode bloquear o envio para essa cliente específica porque o número dela está no grupo do experimento. Reenviar não resolve — continuará falhando.
Sugestão para conseguir mandar mensagem para este cliente
Se o template enviado foi classificado como Marketing, ele tende a ser barrado nesse experimento.
Se a mensagem for algo operacional/relacionado a serviço contratado (implantação, boleto, atualização de processo, agendamento, suporte, onboarding etc.), vale mudar para Utilidade (Utility), porque em muitos cenários o bloqueio afeta principalmente templates de marketing.
Enviar um outro template de tipo UTILIDADE.
Erro Whatsapp / Meta #131048
O próprio texto do erro já dá a pista:
“A mensagem não pode ser enviada porque há restrições quanto ao número de mensagens que podem ser enviadas deste número de telefone.”
O que significa na prática
A Meta reduz ou bloqueia temporariamente a capacidade de envio quando percebe algo como:
- muitas pessoas ignorando as mensagens;
- muitos usuários bloqueando o número;
- muitas denúncias (“spam”);
- templates com baixa performance;
- volume alto de mensagens para contatos frios ou sem consentimento;
- qualidade do número deteriorando (Quality Rating baixo).
Em resumo: o WhatsApp entende que o número pode estar enviando mensagens pouco desejadas e reduz a entrega. Isso costuma afetar principalmente mensagens iniciadas pela empresa (templates).
Como verificar a causa
No painel do WhatsApp Business Manager:
- Entre no Gerenciador do WhatsApp
- Vá no número afetado
- Verifique:
- Quality Rating (Qualidade) do número
- status dos templates
- limites de mensagens
- se há templates pausados/rejeitados
A qualidade geralmente aparece como:
- High (Alta) → saudável
- Medium (Média) → alerta
- Low (Baixa) → risco de restrição
Erro Whatsapp/Meta #331026
Essa falha tem algumas possibilidades, todas listadas na propria mensagem.
Uma dessas possibilidades é que o número nao tenha whatsapp.
Quando encontramos este erro em uma comversa RECEPTIVA geralmente ocorre quando o número de origem é um numero fixo e a plataforma auto competa com o 9 digito.
Para resolver essa situação, basta editar o contato e retirar o 9 digito.
Erro Whatsapp / Meta #131042 : Ocorreu um erro relacionado ao seu método de pagamento
Neste erro, peça ao cliente para acessar a este link: https://business.facebook.com/business/loginpage/?next=https%3A%2F%2Fbusiness.facebook.com%2Fsettings%2Fsecurity
Ele tem que ter uma forma de pagamento selecionada, caso ele nao tenha, peça para ele adicionar e logo em seguida testar;
Depois de acessar o link, siga esse passo a passo
Caso ele ja tenha uma forma selecionada, peça para ele alterar esta forma e testar novamente, pois este problema esta envolvido diretamente com o metodo de pagamento:
Falhas de envios por Campanha (Automações)
A mensagem nao foi enviada e o conector nao registrou um motivo detalhado
{"id":0,"status":"Erro WhatsApp\/Meta #100: A solicitacao incluia um ou mais parametros nao suportados ou com erros de ortografia. Consulte a documentacao do endpoint para determinar quais parametros sao suportados e como eles sao escritos. Para fluxos do WhatsApp com endpoint, certifique-se de que a chave publica da empresa seja uma chave RSA de 2048 bits valida no formato PEM. Verifique tambem incompatibilidades de telefone e restricoes de comprimento do parametro. Status HTTP: 400 (Pedido ruim). Saiba mais: https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/support\/error-codes","ticket_id":0},"error":null,"http_res":500}
PORQUE ISSO ACONTECE?
Isso ocorre quando é enviadas nas variáveis conteudos com quebra de linha, caracteres especiais como asteriscos ou parametros nao suportedos.
SOLUÇÃO:
Revise o conteudo enviado dentro das variáveis e certifique-se que o conteudo da mensagem nao conta com nenhum dos itens descritos acimas. Após essa análise e correção, tentar um novo envio.
Conta do WhatsApp Business bloqueada ou restrita. Revise o Gerenciador do WhatsApp Business.
Nesse caso o número de whatsapp foi restrito ou banido.
Como corrigir
Fazer a apelação junto a meta para a normalização do numero.
A mensagem nao foi enviada e o conector nao registrou um motivo detalhado
No caso de erros genéricos, deve-se buscar o nuporte N2 para mais informações
Fila da conexão não condiz com a campanha
A jblar estava com problemas no envio das campanhas, eles disparavam 1k de campanhas e efetuavam somente 10, isso aconteceu pois a fila la nas conexões estava incorreta:
Esta fila estava errada, por isso a falha na maioria das campanhas, após ser alterada para a certa tudo foi resolvido
Falha no envio - Nenhuma conexão padrão foi encontrada
Ocorre quando a conexão de envio não está mais disponivel para envio.
Ver se a conexão está ativa e disponivel para envio indo em conexões.
Em caso de conexões não oficiais, verificar se a conexão está conectada (ler novamente QR CODE)
Em caso de conexões oficiais, confirmar se o número nao foi banido, bloqueado, portado.
Portsip - Erros
Correções aplicadas — PortSIP
1. Erro “400 Bad Request”
Causas identificadas:
Correções realizadas:
2. Erro “Forbidden (Bad auth)”
Causa:
Correções realizadas:
3. Erro “503 Service Unavailable”
Causa identificada:
Correções realizadas:
4. Aplicativo desconectando sozinho após um período
Causa identificada:
Correções realizadas:
5. Erro “Request Timeout” em Wi-Fi específico
Causa identificada:
Correção que resolveu:
Após a troca para TCP, o aplicativo voltou a registrar normalmente.
6. PortSIP não permitia alterar de UDP para TCP
Correção realizada:
- Testar clicando no simbolo de UDP
- Se não der certo, segurar na opção que está o UDP para aparecer as outras opções
Quando a empresa não se qualifica para a verificação
Neste caso, teremos que "forçar" a verificação.
Para isso basta iniciar o processo de ativação como se já fossem ativar o numero.
Acessando o Tallk.me manager, chat, conexões.
Clicar em CRIAR e seguir o processo de ativação até o momento de receber o codigo.
OBS: Não precisa concluir a ativação. Basta chegar até a parte que envia o codigo.
Nesse momento basta voltar ao link inicial que aparecerá o botão para INICIAR VERIFICAÇÃO da conta.
