1. [Ajuda](https://nuvia.ai/docs) 2. [Painéis](https://nuvia.ai/docs/colecoes/19368706-paineis) # Como acompanhar as falhas de envio (na conversa e na campanha) Veja onde as falhas de envio aparecem na Nuvia: o card de falha na conversa, com a causa em linguagem clara, e as causas agrupadas por etapa na campanha. Disponível em todos os planos. Quem pode fazer qualquer usuário com acesso à conversa ou à campanha onde o envio aconteceu. Atualizado em 3 de novembro de 2026 [Painéis](https://nuvia.ai/docs/colecoes/19368706-paineis) 1. [Como usar os Painéis de dados da Nuvia (atendimento, campanhas, funil)](https://nuvia.ai/docs/artigos/14499194-como-usar-os-paineis-de-dados-da-nuvia-atendimento-campanhas-funil) 2. [Como interpretar o painel de Funil da Nuvia](https://nuvia.ai/docs/artigos/14590408-como-interpretar-o-painel-de-funil-da-nuvia) 3. [Como acompanhar as falhas de envio (na conversa e na campanha)](https://nuvia.ai/docs/artigos/15518011-como-acompanhar-as-falhas-de-envio-na-conversa-e-na-campanha) 4. [Como exportar relatórios dos Painéis na Nuvia](https://nuvia.ai/docs/artigos/14570105-como-exportar-relatorios-dos-paineis-na-nuvia) Nesta página 1. Na conversa: o card de falha 2. Falha por variável de template vazia 3. Contato que pediu para não receber marketing 4. Na campanha: causas por etapa e Histórico de ações 5. Na integração com o HubSpot: Histórico de Sincronização 6. Falhas permanentes e transientes **Nesta página6 seções** 1. Na conversa: o card de falha 2. Falha por variável de template vazia 3. Contato que pediu para não receber marketing 4. Na campanha: causas por etapa e Histórico de ações 5. Na integração com o HubSpot: Histórico de Sincronização 6. Falhas permanentes e transientes Quando uma mensagem não consegue ser enviada, seja em uma campanha, em um follow-up, na resposta do agente ou em um envio manual, a Nuvia mostra a falha no próprio contexto do envio, com a causa em linguagem clara, o código do canal e, quando o reenvio é possível, um botão para tentar de novo. Este artigo explica onde essas falhas aparecem e como interpretá-las. Onde acontece **Conversas** (card de falha), **Campanhas** (causas por etapa, Histórico de ações e exportação de contatos), **Integrações → HubSpot** (Histórico de Sincronização) e no **webhook de saída** (evento MESSAGE_FAILED) ## Na conversa: o card de falha Quando uma mensagem disparada falha, ela aparece na conversa com um card vermelho. O card sempre traz três informações: 1. **A causa, em linguagem clara** — na primeira linha, depois do rótulo **Não enviada**. Exemplo: “Não enviada · A janela de 24h desta conversa expirou. Envie um template aprovado para reabrir o contato.” 2. **A linha de identificação** — logo abaixo, com o código do canal, a origem da falha e o horário: “Código 131047 · WhatsApp (Meta) · 10/08 14:32”. A origem é **WhatsApp (Meta)**, **LinkedIn** ou **Nuvia**. 3. **Ver detalhes técnicos** — um link que expande o retorno cru do provedor, o status HTTP e o número do registro da falha, quando essas informações existem. A causa é exibida **no seu idioma** (português, inglês ou espanhol) sempre que o código do canal é reconhecido pela Nuvia por exemplo: número fora da janela de 24h, limite de envio atingido, template pausado pela Meta, conta de LinkedIn desconectada ou pendência de cobrança na Meta. Bom saber não existe mais um título genérico do tipo “Não foi possível enviar esta mensagem”. Quando o código não é reconhecido, o card mostra o texto que o próprio canal devolveu, em vez de esconder a informação. Quando nem isso existe, ele diz que houve uma falha interna da Nuvia e informa o número do registro para você passar ao suporte. ### O botão Tentar novamente O botão **Tentar novamente** faz exatamente o mesmo que o campo de digitação da conversa. Por isso ele só aparece quando o reenvio realmente pode dar certo: - a mensagem que falhou é de **texto** (template e mídia não são reenviados por esse botão); - a conversa **não está encerrada**; - a conversa está **dentro da janela de 24h** do WhatsApp; - sua conta não está em **período de testes vencido**. Se qualquer uma dessas condições não for atendida, o botão não é exibido, o envio falharia de novo pelo mesmo motivo. ### Bloqueio de janela de 24h: dois textos diferentes Quando a Nuvia impede o envio porque não há janela aberta, o card explica **qual** das duas situações aconteceu: SituaçãoO que o card diz O contato já respondeu em algum momento, mas as 24h passaram “Janela de 24h expirada. Envie um template aprovado para reabrir a conversa.” O contato **nunca** respondeu nessa conversa “O contato ainda não respondeu, então não há janela de 24h aberta. Envie um template aprovado para iniciar a conversa.” Por que isso importa conversa em que o lead nunca falou não tem janela para “expirar”. O texto antigo dizia “janela expirada” nos dois casos, o que fazia parecer que a conversa já tinha estado aberta e fechado. Agora o card diz exatamente o que está acontecendo. Esse bloqueio é feito **pela Nuvia**, antes de a mensagem sair para o WhatsApp. Por isso ele aparece com origem **Nuvia** na linha de identificação — e não **WhatsApp (Meta)**, como antes. A mudança separa o bloqueio nosso do erro 131047 de verdade, aquele em que a própria Meta recusa o envio. ## Falha por variável de template vazia Um caso comum de falha em campanhas de WhatsApp é o template que não pode ser enviado porque uma das variáveis mapeadas está **vazia** para aquele lead. Nesse caso, a mensagem indica exatamente **qual campo preencher** por exemplo: “Não foi possível enviar o template: Nome da empresa está vazio neste lead. Preencha o campo e tente novamente.” O nome do campo aparece pelo rótulo amigável (ex: **Nome da empresa**), não pelo identificador técnico. Quando há mais de um campo vazio, todos são listados. Para entender como mapear variáveis e evitar campos vazios, veja [Como usar variáveis em templates WhatsApp](https://nuvia.ai/docs/artigos/15353096-como-usar-variaveis-em-templates-whatsapp-na-nuvia). ## Contato que pediu para não receber marketing Antes de enviar um template de **Marketing**, a Nuvia confere se aquele contato pode receber esse tipo de mensagem agora. Se não puder, o envio é bloqueado **antes** de sair para o WhatsApp e a falha aparece com origem **Nuvia** e o código MARKETING_SUPPRESSED. São duas situações diferentes, com textos diferentes no card: SituaçãoO que o card dizQuanto tempo dura O contato pediu para parar de receber marketing “Este contato pediu para não receber mensagens de marketing neste canal.” Sem prazo — vale até o contato voltar atrás O WhatsApp está limitando marketing para aquele contato “O WhatsApp está limitando mensagens de marketing para este contato no momento. O envio será liberado automaticamente.” 24 horas, e libera sozinho **De onde vem o pedido de parar:** o contato desativou as mensagens de marketing da sua empresa no próprio aplicativo do WhatsApp, ou a Meta recusou um envio com o código **131050** (o contato bloqueou marketing). Nos dois casos a Nuvia registra a preferência no contato e para de enviar marketing para ele naquele canal. **De onde vem o limite temporário:** a Meta recusou um envio com o código **131049** (limite de mensagens de marketing por usuário) ou **130472**. A Nuvia guarda esse bloqueio por 24 horas para aquele contato, naquele canal, dentro da sua empresa — e volta a enviar sozinha quando o prazo passa. ### O 131049 tem dois momentos diferentes — e dois cards diferentes Vale entender essa diferença, porque ela explica por que o mesmo problema aparece de duas formas na tela: MomentoO que aconteceuComo aparece na conversa **A primeira recusa** O WhatsApp aceitou o envio, criou a mensagem e só **depois** avisou que não entregou Origem **WhatsApp (Meta)**, código **131049**, com o texto “Não entregue: a Meta limita mensagens de marketing por usuário. Tente novamente em 24h.” **Os envios seguintes, dentro das 24h** A Nuvia já sabe do limite e nem chama o WhatsApp Origem **Nuvia**, código MARKETING_SUPPRESSED, com o texto “O WhatsApp está limitando mensagens de marketing para este contato no momento. O envio será liberado automaticamente.” Por que isso importa o **131049 não é uma falha de envio, é uma falha de entrega.** A mensagem chega a ser criada e pode aparecer como enviada por alguns instantes, até o aviso da Meta chegar e virar falha. Então não espere ver MARKETING_SUPPRESSED na primeira vez — ele só aparece a partir do segundo template de Marketing para aquele contato, enquanto as 24 horas estiverem correndo. Importante o bloqueio vale só para templates de categoria **Marketing**. Templates de **Utilidade** e **Autenticação** (confirmação de pedido, código de acesso, boleto) continuam saindo normalmente. Bom saber a preferência é por **meio de comunicação**, não por caixa de entrada. Quem cortou marketing no WhatsApp continua recebendo e-mail e LinkedIn. E não adianta trocar de conexão: WhatsApp Cloud API e Evolution contam como o mesmo WhatsApp para o contato. ## Na campanha: causas por etapa e Histórico de ações No detalhe da campanha, o indicador de **Falhas** de cada etapa pode ser expandido para ver as **causas agrupadas**, a mensagem em linguagem clara, o código do canal e a quantidade de cada causa. No **Histórico de ações** da campanha, cada execução que falhou mostra a mesma causa e a mesma linha de identificação (código e origem) que você vê no card da conversa. As duas telas usam a mesma tradução: o mesmo código nunca aparece com textos diferentes em lugares diferentes. Bom saber falha que a campanha vai reenviar (como o 131049) aparece nas causas da etapa **enquanto está esperando** o reenvio. Se a segunda tentativa entregar, a etapa passa a contar aquele contato como enviado. Ou seja: o número de falhas de uma etapa recém-disparada pode diminuir sozinho no dia seguinte. ### Na exportação de contatos da campanha A exportação de contatos da campanha traz duas colunas com o motivo, logo depois da coluna **Status**: - **Código do erro** — o mesmo código que aparece no card (ex: 131049, 131026) - **Motivo do erro** — a causa em linguagem clara, igual à da tela Antes a exportação só dizia “Erro de entrega” na coluna Status, sem dizer por quê. Agora você consegue filtrar a planilha por motivo e separar, por exemplo, “número não usa WhatsApp” de “limite de marketing”. ### No webhook de saída Se você usa os webhooks da Nuvia para acompanhar disparos em outro sistema, existe o evento **MESSAGE_FAILED**. Ele leva um campo failure_reason com o código, a causa em texto, a classificação e o provedor — **o mesmo texto que o operador lê na conversa**, não o retorno cru do canal. Veja também [Como interpretar as métricas de campanha](https://nuvia.ai/docs/artigos/14576475-como-interpretar-as-metricas-de-campanha). ## Na integração com o HubSpot: Histórico de Sincronização Quando a falha é do HubSpot, e não de um envio de mensagem, ela aparece no **Histórico de Sincronização** da integração. No detalhe do item com erro, a Nuvia mostra primeiro a **causa classificada** com o código do HubSpot (por exemplo INVALID_OPTION ou INVALID_PHONE_NUMBER), nomeando a propriedade que falhou, e só abaixo o retorno cru da API que pode passar de dois mil caracteres. Itens de sincronização antigos, gravados antes dessa mudança, continuam exibindo apenas o retorno cru. ## Falhas permanentes e transientes Toda falha de envio é classificada internamente em dois tipos, o que ajuda a entender se você precisa agir: - **Permanente** — a Meta (ou a Nuvia) recusou **esta tentativa**. Normalmente é definitivo e pede uma ação sua: reconectar um número de WhatsApp, ajustar uma permissão, reconectar a conta de LinkedIn ou corrigir os dados do lead - **Transiente** — falha temporária, em que o **reenvio acontece automaticamente** (ex: limite de envio momentâneo, instabilidade do canal). Nesses casos a própria mensagem avisa que o reenvio é automático e que você não precisa fazer nada Bom saber “Permanente” responde “esta tentativa não passou” — não “nunca mais vai passar”. São duas perguntas diferentes, e o limite de marketing por usuário (131049) é justamente o caso em que a resposta é diferente: aparece como permanente no card e ainda assim vale reenviar depois. Quem decide o reenvio na campanha é a regra da próxima seção, não esse rótulo. ### O que a campanha reenvia e o que ela encerra na hora Quando uma etapa de campanha falha, a Nuvia pode tentar o envio **mais uma vez, cerca de 24 horas depois**. É uma tentativa extra, não um ciclo infinito: se a segunda também falhar, o contato é encerrado naquela campanha. Esse reenvio só é descartado quando a espera não muda nada — ou quando insistir seria errado. **A campanha reenvia em 24h:** - **131049** e **130472** — limite de mensagens de marketing por usuário. É uma janela do destinatário e passa sozinha - Limites e instabilidade momentânea do WhatsApp (130429, 131048, 131056, 131000, 132069 e afins) - Códigos que a Nuvia não reconhece e erros internos da própria plataforma **A campanha encerra o contato na hora, sem reenviar:** - **131026** — o número não usa WhatsApp. Não recupera nunca - **131050** — o contato pediu para não receber marketing. Não se insiste, por política e não por eficácia - **Erros de template** (132000, 132001, 132015, 132016 e os outros 132xxx) — o problema está no template, não no momento - **Conexão e configuração do número** (0, 190, 3, 10, 200, 131031, 131037, 131042, 131045, 133010) — só sai depois que alguém arrumar - **Janela e conteúdo** (131047 janela expirada, 131051 tipo de conteúdo, 131052 e 131053 anexo, 131008 e 131009 variável faltando, 131021 próprio número do canal) - **Bloqueios da própria Nuvia** — MARKETING_SUPPRESSED e caixa de entrada sem agente padrão Correção até o começo de setembro de 2026 este artigo dizia que a campanha **não** reenvia o **131049**. Isso estava errado e foi corrigido no produto. O reenvio do 131049 **voltou**: medido em produção ao longo de 21 dias, reenviar 24 horas ou mais depois de um 131049 **entrega 41% das mensagens** (2.336 de 5.688). Desligar esse reenvio jogava fora quase metade dos envios recuperáveis. Se você leu a versão anterior e ajustou sua operação por causa dela, pode voltar atrás. Correção (setembro de 2026) a regra acima estava certa, mas na prática o reenvio de 24h quase nunca acontecia para o **131049**. O motivo: o 131049 é uma falha de **entrega** — o WhatsApp aceita o envio na hora e só alguns segundos depois avisa que não entregou. Nesse intervalo a campanha já tinha encerrado o contato naquela etapa, e o aviso de falha chegava tarde demais para agendar o reenvio. Agora, quando o aviso chega depois, a Nuvia **reabre o contato na campanha** e o reenvio acontece normalmente, cerca de 24 horas depois. Vale para todas as falhas que a lista acima diz que são reenviadas. Uma exceção se a campanha já estiver **concluída** no momento em que o aviso de falha chega, o contato continua encerrado e o reenvio de 24h não acontece. Isso pode ocorrer em campanhas de disparo manual ou agendado, que se encerram sozinhas quando o último contato termina. Campanhas ativas não são afetadas. Bom saber o contato só é reaberto quando a etapa foi encerrada **por causa desse envio**. Se ele foi encerrado por motivo próprio — respondeu, a conversa foi resolvida ou ele bateu o limite de falhas — a campanha não volta atrás. É o comportamento esperado: quem já respondeu não recebe uma nova tentativa. Bom saber ter conversado antes com o lead quase não muda a recuperação (45% para quem já respondeu, 40% para quem nunca respondeu). Ou seja: vale reenviar para a base fria também. Atenção ao encadeamento o reenvio da campanha acontece cerca de 24 horas depois da falha, e o bloqueio temporário daquele contato também dura 24 horas. Se o reenvio cair enquanto o bloqueio ainda está de pé, ele é barrado pela própria Nuvia com MARKETING_SUPPRESSED — e esse bloqueio encerra o contato na campanha. Na prática: se você ver MARKETING_SUPPRESSED logo depois de um 131049 na mesma etapa, é isso que aconteceu. ### Anexo recusado pela Meta (código 131053) O código **131053** passou a ser tratado como falha **permanente**, com o texto “A Meta recusou o anexo. Tente enviar novamente.” Antes ele aparecia como transiente e prometia reenvio automático — mas esse erro chega por aviso da Meta **depois** de o envio já ter sido aceito, então nenhum reenvio automático da plataforma alcança essa mensagem. O anexo simplesmente ficava pelo caminho e ninguém era avisado. Agora o card pede a ação: envie o anexo de novo. Bom saber boa parte desses casos vinha de **áudios gravados no navegador**, que saíam com um pedaço inválido no fim do arquivo e eram recusados pela Meta. A Nuvia passou a corrigir o áudio no momento do upload, então o arquivo já nasce válido — esse motivo específico de recusa deve praticamente desaparecer. ## Perguntas frequentes **Qual a diferença entre falha permanente e transiente?** Uma falha **transiente** é temporária, a Nuvia re-tenta o envio automaticamente (ex: limite de envio atingido por instantes, instabilidade do canal). Uma falha **permanente** significa que **esta tentativa** foi recusada, e normalmente pede uma ação sua: reconectar um número de WhatsApp, ajustar uma permissão ou revisar os dados do destinatário. O rótulo não decide o reenvio da campanha. O limite de marketing por usuário (131049) aparece como permanente e ainda assim é reenviado em 24h, porque recupera. Já a janela de 24h expirada (131047) aparece como permanente e não é reenviada. A lista de quem reenvia e quem encerra está na seção “O que a campanha reenvia e o que ela encerra na hora”. **Um contato falhou com 131049. A campanha tenta de novo?** Sim. O **131049** é o limite de mensagens de marketing por usuário que a Meta aplica — uma janela do destinatário, que passa sozinha. A campanha faz uma tentativa extra cerca de 24 horas depois, e essa tentativa entrega em torno de **41%** dos casos medidos em produção. Você não precisa fazer nada: nem reenviar na mão, nem tirar o contato da campanha. Se a segunda tentativa também falhar, aí sim o contato é encerrado naquela campanha. **Minha campanha aparece como concluída e nenhum contato foi reenviado. Por quê?** O reenvio de 24h só acontece em campanha **ativa**. Se a campanha já tinha se encerrado quando o aviso de falha chegou da Meta, o contato continua encerrado e a segunda tentativa não é agendada. Isso é mais comum em campanhas de disparo manual ou agendado, que se encerram sozinhas assim que o último contato termina. Para recuperar esses contatos, você pode inscrevê-los novamente em uma campanha ativa. **Para que serve o código que aparece no card?** É o código que o próprio canal devolveu (Meta ou LinkedIn). Ele fica sempre visível porque é o que o suporte e a engenharia usam para investigar: ao abrir um chamado, informe esse código junto com o horário do envio. Códigos criados pela própria Nuvia, que a Meta não reconheceria, não são exibidos nessa linha. **O card diz que “o motivo não ficou registrado”. O que isso significa?** Significa que a mensagem falhou antes de a Nuvia passar a registrar a causa de cada falha, e não há como recuperar esse motivo depois. Falhas antigas não são reprocessadas. Para envios novos, sempre há causa, código ou número de registro. **Por que não aparece o botão Tentar novamente nessa falha?** Porque o reenvio falharia do mesmo jeito. O botão só aparece em mensagens de texto, em conversas abertas, dentro da janela de 24h e com a conta ativa. Se a janela de 24h expirou, envie um template aprovado; se a conversa foi encerrada, reabra antes de enviar; se o período de testes venceu, fale com o time de vendas. **O card diz que o contato ainda não respondeu. Como eu inicio a conversa?** Com um **template aprovado**. Enquanto o contato não escrever para você, não existe janela de 24h e mensagem livre não sai. Vale lembrar: enviar o template **não** abre a janela — ela abre quando o contato responde. **Um contato parou de receber minhas campanhas de repente. Por quê?** Provavelmente ele pediu para não receber mais mensagens de marketing — no próprio WhatsApp ou por recusa da Meta na entrega (código 131050). Na primeira vez o card mostra origem **WhatsApp (Meta)** com o código 131050; dos envios seguintes em diante ele mostra origem **Nuvia**, porque a plataforma já não chama mais o WhatsApp. Esse bloqueio não tem prazo: só sai quando o contato voltar atrás. Se o texto falar em limitação temporária do WhatsApp (131049), é outra coisa: libera sozinho em 24 horas e a campanha reenvia. **O bloqueio de marketing impede todos os meus envios para aquele contato?** Não. Ele vale só para templates de categoria **Marketing** naquele canal. Templates de **Utilidade** e **Autenticação** continuam saindo, e a conversa segue normal se o contato escrever para você. Outros canais (e-mail, LinkedIn) também não são afetados. **Uma mensagem falhou por “campo vazio neste lead”. O que faço?** Significa que o template tinha uma variável mapeada para um campo que está vazio naquele contato (ex: **Nome da empresa**). Preencha o campo no contato e use **Tentar novamente**, ou segmente a audiência para incluir apenas contatos com o campo preenchido antes de lançar a campanha. [AnteriorComo interpretar o painel de Funil da Nuvia](https://nuvia.ai/docs/artigos/14590408-como-interpretar-o-painel-de-funil-da-nuvia) [PróximoComo exportar relatórios dos Painéis na Nuvia](https://nuvia.ai/docs/artigos/14570105-como-exportar-relatorios-dos-paineis-na-nuvia) Este artigo ajudou? ## Artigos relacionados - [Como melhorar a taxa de resposta em campanhas de WhatsApp](https://nuvia.ai/docs/artigos/14501604-como-melhorar-a-taxa-de-resposta-em-campanhas-de-whatsapp) - [Glossário de termos da Nuvia](https://nuvia.ai/docs/artigos/14580494-glossario-de-termos-da-nuvia) - [Como enviar áudio, imagem, documento e mídia pelo Inbox](https://nuvia.ai/docs/artigos/15353019-como-enviar-audio-imagem-documento-e-midia-pelo-inbox) - [Como disparar templates WhatsApp na Nuvia direto de um workflow do HubSpot](https://nuvia.ai/docs/artigos/15879535-como-disparar-templates-whatsapp-na-nuvia-direto-de-um-workflow-do-hubspot) - [Como inscrever leads/contatos em campanhas da Nuvia direto de um workflow do Hubspot](https://nuvia.ai/docs/artigos/15879734-como-inscrever-leads-contatos-em-campanhas-da-nuvia-direto-de-um-workflow-do-hubspot) [Painéis](https://nuvia.ai/docs/colecoes/19368706-paineis) 1. [Como usar os Painéis de dados da Nuvia (atendimento, campanhas, funil)](https://nuvia.ai/docs/artigos/14499194-como-usar-os-paineis-de-dados-da-nuvia-atendimento-campanhas-funil) 2. [Como interpretar o painel de Funil da Nuvia](https://nuvia.ai/docs/artigos/14590408-como-interpretar-o-painel-de-funil-da-nuvia) 3. [Como acompanhar as falhas de envio (na conversa e na campanha)](https://nuvia.ai/docs/artigos/15518011-como-acompanhar-as-falhas-de-envio-na-conversa-e-na-campanha) 4. [Como exportar relatórios dos Painéis na Nuvia](https://nuvia.ai/docs/artigos/14570105-como-exportar-relatorios-dos-paineis-na-nuvia) ## Ainda precisa de ajuda? Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time. [Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact) --- Source: https://nuvia.ai/docs/artigos/15518011-como-acompanhar-as-falhas-de-envio-na-conversa-e-na-campanha