Falhas no envio de mensagens ativas: Onde encontrar e o que significam – Blip | Blip Help

O que são as falhas no envio?

Falhas nos envios de mensagens ativas são erros que impedem que uma comunicação iniciada por uma empresa (como disparos de campanhas ou notificações) chegue até o destinatário.

Uma falha no envio acontece quando a Blip tenta realizar o disparo dessa mensagem para o usuário final, mas a entrega é negada ou impedida por algum erro técnico, erro na montagem da requisição (API) ou por bloqueios relacionados às políticas de uso do canal WhatsApp.

Antes de começar

A verificação de falhas deve ser realizada diretamente no bot conectado ao canal WhatsApp.
Se o seu contato inteligente utiliza a arquitetura de roteadores e sub-bots, a verificação precisará ser feita no roteador, pois é nele que o seu canal WhatsApp estará conectado.

Onde encontro as falhas no envio?

Atualmente, existem duas maneiras principais de identificar o motivo de falha no envio de uma mensagem ativa:

Pelo dashboard de mensagens ativas no módulo de Análise;
Pelo relatório de campanha no Growth;

Em ambas as abordagens descritas abaixo, a verificação deve ser realizada diretamente no bot conectado ao canal WhatsApp.

Vale lembrar: se o seu contato inteligente utiliza a arquitetura de roteadores e sub-bots, a verificação precisará ser feita no roteador, pois é nele que o seu canal WhatsApp estará conectado

Pelo dashboard de mensagens ativas no módulo de Análise:

1. Acesse o portal;
2. Em seguida, acesse o bot conectado ao canal WhatsApp;
3. Selecione a aba “Análise”;
4. Dentro de Análise, clique no dashboard "Mensagens Ativas".
5. Filtre pelo período ou pela data desejada;
6. Ou pesquise pelo nome do template cujas falhas você deseja investigar;
7. No fim do relatório, existe uma seção específica com o detalhamento dos erros, “Falhas no envio”, onde você pode observar as falhas pelo período ou template desejado:

Nessa seção você irá encontrar informações importantes sobre os envios que falharam com base nas colunas existentes. Abaixo detalhamos cada uma delas:

Código: Exibe o código técnico da falha. Você pode consultar este código diretamente na documentação oficial da Meta (ou em ferramentas de busca) para identificar a causa exata do bloqueio;
Descrição do erro: Complementa a coluna anterior, explicando de forma sucinta o que o código de erro significa;
Ocorrências: Indica o volume total de mensagens que falharam devido a este mesmo erro, de acordo com o período ou template filtrado.

Pelo relatório de campanha no Growth:

1. Em seu bot conectado ao WhatsApp, selecione a aba ‘Growth’;

2. Selecione ‘Mensagens Ativas;’

3. Em seguida clique em ‘Resumo dos envios’;

4. (Opcional) É possível filtrar por:

Canal desejado (caso você não utilize somente o WhatsApp);
Tipo de mensagem (agendadas ou não agendadas);
Tipo de campanha (individual ou em massa).

Caso não selecione nenhuma das opções, todas serão exibidas.

5. (Opcional) É possivel buscar pelo nome da campanha. Caso não utilize o campo de busca, todas as campanhas serão exibidas.

6. Localize a campanha/envio desejado e selecione, na coluna Ações, os 3 pontinhos;

7. Selecione ‘Baixar relatório’:

Você irá baixar um arquivo .csv que contem as seguintes colunas:

Data
ID da campanha
Nome da campanha
Modelo de mensagem
Enviado por
Canal
Identidade do contato
Telefone do contato
Status da mensagem
Enviada
Recebida
Lida
Falha
Código de falha
Descrição da falha
Direcionamento de resposta
Código de erro
Grupo do erro
Mensagem de erro
Descrição do erro

Para verificar se uma mensagem falhou, análise as colunas Status da Mensagem e Falha.

Para analisar o motivo da falha, verifique as colunas Código de falha, Descrição da falha, Código de erro, Mensagem de erro e Descrição do erro.

O que significam os erros apresentados no relatório?

Durante o processamento de campanhas e disparos, os erros podem ter origem em duas frentes distintas: na própria plataforma Blip ou diretamente no provedor do canal (Meta).

Abaixo, detalhamos os possíveis retornos e códigos de falha que podem ser apresentados em seus relatórios, categorizados por suas respectivas origens:

Erros gerados pela plataforma blip:

Código	Mensagem	Detalhe
38	Max Command throughput rate reached - blocked until. Your limit is 200 per second.	O contato inteligente atingiu o limite máximo de comandos/requisições por segundo (Rate Limit). A plataforma bloqueia envios excedentes temporariamente para proteger a infraestrutura.
N/A	NOT_PROCESSED	A mensagem não chegou a ser processada pela mensageria da Blip. Geralmente associado a payload JSON em formato inválido, falhas de roteamento hierárquico no bot ou indisponibilidade momentânea do serviço.

Erros gerados pela META:

Código	Mensagem (Meta API)	Detalhe
0	Authentication error	Não foi possível autenticar o usuário. O token expirou, é inválido ou o acesso foi bloqueado.
1	General Error	Ocorreu um erro geral. Possível erro de servidor ou requisição inválida.
2	Service Unavailable	Ocorreu um erro de timeout. Serviço temporariamente fora do ar ou sobrecarregado.
3	Capability or Permission Issue	A aplicação não tem permissão para realizar esta ação.
4	Rate limit hit	O aplicativo atingiu o limite da taxa de chamadas de API (Rate Limit).
10	Permission denied	A permissão para esta ação não foi concedida ou foi removida da aplicação.
33	Phone number deleted	O número de telefone comercial fornecido foi excluído ou não é válido.
38	Authorization Max Throughput Rate Reached	A taxa de transferência máxima de mensagens do bot foi atingida.
51	Dispatch Error	Erro geral de envio, o canal de destino não está disponível.
81	Gateway error	Erro geral de processamento do gateway, incluindo erros da API do canal.
86	Gateway operation timed out	A operação no provedor/gateway apresentou timeout.
100	Invalid parameter	A requisição incluiu parâmetros incompatíveis, ausentes ou com erro de digitação.
190	Access token has expired	O token de acesso da aplicação perdeu a validade.
200-299	Permission error	Permissão não concedida, revogada ou o token não foi enviado na requisição.
368	Account restricted	A Conta do WhatsApp (WABA) foi restringida/desativada por violar políticas da Meta.
429	Too Many Requests	O limite volumétrico de requisições à API foi excedido.
1013	User not found	O usuário destino não é válido para esta integração ou o perfil não pode ser alcançado.
1505	Invalid recipient for channel	O número de telefone não possui uma conta do WhatsApp ativa.
1601	General broadcast processing error	Erro genérico ocorrido durante o processamento de uma transmissão de campanha.
1602	Recipient in attendance	Mensagem barrada porque o cliente já está em atendimento humano ativo na plataforma Blip.
3304	Spam rate limit hit	A conta excedeu o limite de envio devido a uma alta taxa de denúncias de spam recentes.
80007	Rate limit reached	A conta do WhatsApp Business atingiu seu limite total de volume.
130403	Message undeliverable	A empresa foi bloqueada pelo usuário final diretamente no WhatsApp.
130429	Rate limit hit	A taxa de transferência da Cloud API foi atingida.
130472	User's number is part of an experiment	Cerca de 1% dos usuários não receberão templates de marketing devido a um experimento da Meta iniciado em 14/06/2024. A mensagem é retida temporariamente.
130497	Country restricted	A WABA não possui permissão para disparar mensagens a usuários deste país.
131000	Something went wrong	Falha interna desconhecida, erro de assinatura ou no endpoint GraphQL.
131005	Access denied	A aplicação não tem as permissões adequadas para executar esta ação.
131008	Required parameter is missing	Falta de informação crucial/obrigatória no payload da requisição.
131009	Parameter value is not valid	Um ou mais valores preenchidos na requisição não são aceitos ou válidos.
131016	Service unavailable	Algum serviço interno do WhatsApp está temporariamente fora do ar.
131021	Sender and recipient are the same	Tentativa de enviar uma notificação ativa para o próprio número comercial remetente.
131026	Message Undeliverable	Retorno da Meta indicando que a mensagem não pôde ser entregue. Causa comum: número incorreto ou inativo. Outras: cliente bloqueou a empresa, não aceitou os Termos de Serviço ou usa app desatualizado.
131031	Account has been locked	A WABA foi restringida ou falhou em verificações obrigatórias (ex: PIN incorreto).
131037	Business phone number not approved	O número de teste (555) utilizado não possui um nome de exibição validado.
131042	Payment issue	Ocorreu um erro com o método de pagamento/linha de crédito no Gerenciador.
131043	Outside allowed window	Tentativa de envio de mensagem de texto livre ou mídia solta fora da janela de 24 horas de atendimento.
131045	Incorrect certificate	Falha na entrega causada por uma anomalia no registro do número de telefone.
131047	Re-engagement message	Passaram-se mais de 24 horas desde a última interação livre do cliente.
131049	This message was not delivered to maintain healthy ecosystem engagement.	A Meta identificou unilateralmente que a mensagem pode não estar engajando os usuários como esperado, aplicando um bloqueio automático para preservar a qualidade das interações.
131050	Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business	A Blip enviou a requisição corretamente, mas o contato sinalizou nas configurações de "Ofertas e anúncios" do próprio aplicativo que deseja interromper mensagens de marketing.
131051	Unsupported message type	O formato enviado na mensagem ativa (ex: arquivo específico) não é compatível.
131052	Media download error	O sistema não pôde fazer o download da mídia recebida pelo usuário na conversa.
131053	Media upload error	Falha ao carregar a mídia enviada via requisição. Formato não suportado.
131055	Method not allowed	Tentativa de envio de template de utilidade/autenticação através da API de Marketing.
131056	Too many messages sent	Excesso de mensagens enviadas para o mesmo destinatário em curtíssimo intervalo.
131057	Account in maintenance mode	A Conta WhatsApp Business está passando por processos de manutenção interna.
131061	Template not approved	Tentativa de disparar um template que ainda está com o status "Pendente" ou "Rejeitado".
131063	Marketing messages disabled	O template é de marketing, mas disparos deste tipo estão desligados na Cloud API.
131064	Template quality limit reached	A conta sofreu restrições no volume de envio por uso de templates com baixa qualidade.
132000	Template parameter count mismatch	A quantidade de variáveis na requisição não bate com o exigido pelo template.
132001	Template does not exist	Template inexistente, não aprovado, ou há divergência no idioma solicitado.
132005	Template hydrated text too long	O texto final após a substituição das variáveis excede o limite imposto pela Meta.
132007	Template policy violation	O conteúdo formatado no template fere as políticas de comércio e mensagens da Meta.
132012	Template parameter format mismatch	O formato das variáveis enviadas está inválido e não casa com a configuração.
132015	Template paused due to low quality	Template interrompido temporariamente por gerar muitas denúncias ou bloqueios.
132016	Template disabled	O template foi inativado de vez após pausar múltiplas vezes por denúncias.
132018	Template validation error	Problema detectado nos parâmetros durante o uso da API de Mensagens de Marketing.
132068	Flow blocked	O WhatsApp Flow em questão sofreu bloqueio pela plataforma.
132069	Flow limited	Excesso de mensagens trafegadas utilizando este mesmo fluxo na última hora.
133000	Incomplete deregistration	Uma tentativa anterior de cancelar o registro deste número no canal WhatsApp falhou.
133004	Server temporarily unavailable	Falha momentânea nas chamadas aos servidores principais do WhatsApp.
133005	Two-step verification PIN incorrect	O PIN de duas etapas enviado no processo de ativação/requisição é inválido.
133006	Phone number needs to be verified	O número ainda não está com a propriedade confirmada e precisa ser validado.
133008	Too many two-step verification PIN guesses	Foram feitas sucessivas tentativas incorretas ao tentar acionar o PIN do número.
133009	Two-step verification PIN guessed too fast	O processo de validação sofreu disparos excessivos em curto tempo.
133010	Phone number not registered	A linha inserida não se encontra oficialmente cadastrada no WhatsApp Business.
133011	Phone number restricted	O número remetente foi banido ou severamente restringido pela Meta por violações.
133015	Wait before registering	A linha comercial sofreu exclusão recentemente e o processo de deleção ainda tramita.
133016	Registration limit reached	Esgotado o limite estrito para registros ou exclusões de conta num intervalo breve.
133017	Invalid configuration	Problema com a configuração sistêmica, muitas vezes na chave do perfil de negócios.
134011	Payment terms pending	Houve falha porque os Termos de Serviço de Pagamentos não foram aceitos na WABA.
134100	Only marketing messages supported	A API Marketing foi utilizada para enviar modelos utilitários ou de autenticação.
134101	Template still syncing	O template ou anúncio ainda está tramitando seu ciclo interno de sincronização.
134102	Template unavailable for use	O template recém validado não pôde completar a sincronização, ou a WABA não é qualificada.
135000	Generic user error	Falha de formatação que causa um erro desconhecido na montagem dos parâmetros.
1752041	Duplicate Request	Tentativa de onboarding duplicada (já ocorreu via outro provedor ou parceiro).
2388012	Phone number already exists	A linha que você tenta migrar já faz parte da lista desta conta comercial do WhatsApp.
2388019	Template limit exceeded	A WABA preencheu sua cota limite de templates nativos (máx. 250 modelos).
2388039	Cannot change template status	Tentativa de editar/excluir um modelo de mensagem que ainda se encontra em análise prévia.
2388040	Character limit exceeded	O conteúdo em um dos campos do template (botão, texto, etc.) feriu a margem de segurança.
2388047	Message header format incorrect	A construção técnica do cabeçalho viola regras ou envia quebras indevidas.
2388072	Message body format incorrect	O body principal apresentou quebras ou tipagens de variáveis fora do padrão exigido.
2388073	Message footer format incorrect	O bloco final de rodapé exibe conteúdos barrados ou com extrapolação técnica.
2388091	Phone not eligible	Utilização incorreta de APIs voltadas à migração, mas o número não se enquadra no cenário.
2388293	Word to parameter ratio exceeds limit	O template possui um excesso de campos variáveis para quase nenhum texto fixo (contexto).
2388299	Starting or ending parameters not allowed	Parâmetros dinâmicos inseridos de forma bruta no início total ou no final da frase do modelo.
2494100	Account in maintenance mode	Os recursos para esta linha comercial não estão respondendo (manutenção provisória).
2593085	Invalid WABA for OBO Mobility	O usuário já ativou compartilhamento na WABA (WABA sharing) e OBO não funciona mais.
2593107	Sync request limit exceeded	Ocorreram tentativas reincidentes de evocar a API de Sincronização de contatos.
2593108	Sync request outside allowed window	A ativação do endpoint estourou o prazo mandatório de 24 horas a partir do Onboarding.
200005	Template insights unavailable	A extração analítica desse painel do WhatsApp não é suportada/disponível nesta conta.
200006	Cannot disable template insights	Foi enviada uma operação buscando desabilitar os insights, o que é proibido na plataforma.
200007	Template insights not enabled	A ferramenta que extrai métricas visuais avançadas da Meta encontra-se desativada nesta WABA.

Status "Sucesso" e "Falha" simultâneos: Em casos raros, o status recebido pode ser sucesso e falha. Se isso acontecer, pode considerar que a mensagem foi entregue com sucesso. Isso acontece porque o usuário está conectado com o WhatsApp em dois aparelhos, então um recebeu a mensagem com sucesso e o outro não. Leia mais sobre essas particularidades no artigo da Meta.

Status PROCESSED: Este retorno significa que o envio foi realizado com sucesso do lado da Blip e o status de ‘entregue’, ‘recebido’ ou ‘lido’, não foi atualizado pela Meta com base no usuário final.

Erro não listado: No caso de você receber um erro que não foi citado nesse artigo, favor contatar o suporte da Blip.

Documentação Oficial: Veja as documentações oficiais listadas como Mensagens de erro e status e Códigos de erro da API de Nuvem para mais informações detalhadas.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃