Relatório de Erros nas Notificações Avulsas
Identifique notificações avulsas com falhas de envio para análise imediata.
Aqui você acompanha as notificações avulsas que apresentaram erro durante o envio, permitindo identificação de padrões de erro, foco na resolução de problemas e melhoria na qualidade dos disparos.
Como Acessar
Acesse: Marketing / Campanhas / Relatório de Erros nas Notificações Avulsas, conforme mostra a Figura 1:
Figura 1: Relatório de Erros nas Notificações Avulsas.
Tela Principal
Figura 2: Filtro do Relatório de Erros nas Notificações Avulsas.
A tela principal exibe uma tabela com todas as notificações que falharam, organizadas por ordem cronológica decrescente.
Contador de Erros
No canto superior direito da tela há um número indicando a quantidade total de erros registrados no período filtrado.
No exemplo da Figura 2: 34 erros. Este contador ajuda a ter uma visão rápida do volume de disparos com erro.
Botões Disponíveis
Filtros: Filtra os erros por período, serviço e chave da API
Exportar: Exporta o relatório em formato CSV ou PDF
Informações da Tabela
A tabela de erros contém as seguintes colunas:
Descrição
Tipo do erro ocorrido
Ícone de Serviço
Indicador visual do canal (SMS, WhatsApp, E-mail)
Data
Data e hora em que o erro ocorreu
Chave da API
Identificador técnico da mensagem (vazio quando não disponível)
Ações
Botão para investigar detalhes do erro
Tipos de Erros
Os erros são descritos na primeira coluna. O erro mais comum encontrado na imagem é:
Bad Request
Significado: Requisição inválida ou malformada
Possíveis causas:
Número de telefone inválido ou mal formatado
Template com parâmetros incorretos
Dados obrigatórios faltando
Problemas na estrutura da requisição à API
Como resolver:
Clique no ícone de lupa (Ações) para ver detalhes
Verifique o formato do número de telefone
Confirme se a template está correta
Valide todos os parâmetros obrigatórios
Filtrar Erros
Figura 3: Filtros Disponíveis.
O botão Filtros permite refinar a visualização dos erros.
Campos de Filtro
Período:
Campo de data inicial (formato: DD/MM/AAAA HH:MM)
Campo de data final (formato: DD/MM/AAAA HH:MM)
Exemplo na imagem: 08/01/2026 00:00 até 15/01/2026 23:59
Define intervalo de datas para visualizar erros específicos.
Serviço:
Campo de seleção
Permite escolher o canal específico
Opções: SMS, WhatsApp, E-mail
Exemplo na imagem: SMS selecionado
Possui botão X para limpar seleção
Chave da API:
Campo de seleção
Filtra por identificador técnico específico
Útil quando há referência técnica do erro
Como Aplicar Filtros
Clique no botão Filtros
Configure período, serviço e/ou chave da API desejados
Clique em Filtrar para aplicar
Ou clique em Cancelar para fechar sem aplicar
Os resultados são atualizados conforme os filtros selecionados, e o contador de erros é atualizado.
Exportar Relatório
Figura 4: Exportar Relatório.
O botão Exportar permite gerar relatórios dos erros para análise externa.
Como Exportar
Clique no botão Exportar
O sistema exibe o e-mail de login do usuário como padrão, podendo ser alterado
Escolha o formato desejado:
CSV: Para análise em planilhas
PDF: Para impressão ou apresentação
Clique em Exportar para confirmar
Ou clique em Cancelar para fechar
O arquivo é enviado para o endereço configurado, incluindo apenas os erros visíveis após aplicação de filtros.
Recomendação: Use CSV quando precisar analisar grandes volumes de erros ou fazer análises estatísticas em ferramentas como Excel ou Google Sheets.
Investigar Detalhes do Erro
Figura 5: Ícone de Investigação.
Na coluna Ações, cada erro possui um ícone de lupa. Ao clicar nele, você pode acessar informações detalhadas sobre aquele erro específico.
Informações Esperadas
Ao investigar um erro, você pode encontrar:
Número de telefone ou identificador do destinatário
Template utilizada
Parâmetros enviados
Mensagem de erro técnica completa
Timestamp exato do erro
Código de erro da API
Sugestões de correção
Padrões de Erro Comuns
Bad Request - Número Inválido
Sintomas: Múltiplos erros Bad Request via SMS
Causa provável: Números de telefone com formato incorreto
Solução:
Exporte o relatório de erros
Identifique os números problemáticos
Verifique formato (deve ter 13 dígitos: 55 + DDD + número com 9 na frente)
Corrija na base de dados
Valide números antes de novos envios
Bad Request - Template Incompatível
Sintomas: Erros concentrados em template específica
Causa provável: Template com parâmetros incorretos ou não aprovada
Solução:
Filtre por período específico
Identifique qual template está causando problemas
Revise template no sistema
Verifique aprovação junto ao Meta/operadora
Corrija parâmetros necessários
Bad Request - Dados Faltando
Sintomas: Erros esporádicos sem padrão claro
Causa provável: Campos obrigatórios não preenchidos
Solução:
Investigue erro específico
Verifique quais dados estão faltando
Revise processo de coleta de dados
Implemente validações antes do envio
Casos de Uso
Caso 1: Auditoria de Erros do Dia
Objetivo: Verificar todos os erros ocorridos nas últimas 24 horas
Fluxo:
Acesse Relatório de Erros nas Notificações Avulsas
Configure filtro para últimas 24 horas
Verifique contador total de erros
Analise padrões (mesmo erro, mesmo serviço, mesmo período)
Tome ações corretivas
Frequência recomendada: Diária
Caso 2: Identificar Problema Recorrente
Objetivo: Descobrir se há padrão nos erros
Fluxo:
Filtre por período de 7 dias
Exporte relatório em CSV
Abra em planilha
Agrupe por tipo de erro
Identifique o mais frequente
Investigue causa raiz
Implemente correção definitiva
Caso 3: Validar Correção Implementada
Objetivo: Confirmar que problema foi resolvido
Fluxo:
Identifique período antes da correção
Anote quantidade de erros
Implemente correção
Aguarde período equivalente
Compare quantidade de erros
Confirme redução
Caso 4: Relatório para Gestão
Objetivo: Documentar problemas para apresentação
Fluxo:
Filtre período desejado (exemplo: último mês)
Exporte em PDF
Analise principais tipos de erro
Calcule o percentual sobre total de envios
Prepare relatório executivo
Apresente com ações tomadas
Diferença entre Relatórios
Relatório de Erros nas Notificações Avulsas
Localização: Marketing / Campanhas / Relatório de Erros nas Notificações Avulsas
Exibe: Apenas notificações que falharam
Quando usar:
Investigar problemas específicos
Identificar padrões de falha
Medir taxa de erro
Auditoria de qualidade
Localização: Marketing / Campanhas / Relatório das Notificações Avulsas
Exibe: Todas as notificações (sucesso e erro)
Quando usar:
Visão geral de envios
Medir taxa de sucesso
Verificar entregas específicas
Análise de engajamento
Relatórios gerenciais
Relação entre os Relatórios
Os erros exibidos neste relatório também aparecem no Relatório das Notificações Avulsas, mas lá ficam misturados com os sucessos. Este relatório oferece foco exclusivo nos problemas.
Atualizado