Receba alertas por e-mail dos erros nos envios de comunicações em automações. Esses alertas notificam quando condições específicas são identificadas, permitindo um acompanhamento ativo dos resultados das automações e ação imediata para corrigir possíveis problemas.
Como funcionam os alertas
Atualmente, os alertas estão disponíveis para automações que usam os canais WhatsApp, E-mail, SMS, Push e RCS. A contagem de erros é feita uma vez ao dia, às 8h, referente aos envios do dia anterior.
Os e-mails de alerta incluem informações como o volume total de comunicações consideradas, o volume de erros identificados, o percentual de erros e a origem do erro, incluindo a automação e a data/hora do último disparo com erro.
As notificações são enviadas para os usuários configurados na tela Alertas e notificações.
Como configurar um alerta
- Acesse Automações > Alertas e notificações;
- Clique na barra Assinantes e insira o endereço de e-mail de quem receberá a notificação quando determinada condição for identificada. Se desejar que outras pessoas também recebam esses alertas, adicione os endereços de e-mail separados por ponto e vírgula.
- Ao finalizar, clique em Salvar contatos.
- Em seguida, abra a barra do canal desejado e habilite o critério para que o alerta de erro seja acionado:
- Inconsistência na contagem de erros durante o envio das mensagens: selecione o percentual de erro;
- Depois, clique em Personalizar notificações e defina para quem deseja enviar a notificação:
- Para enviar para todas as pessoas já adicionadas, selecione a opção Assinantes;
- Caso queira que pessoas específicas recebam alertas quando ocorrer um erro em uma automação, selecione Personalizado e indique o(s) endereço(s) de e-mail.
- Salve as alterações.
⚠️ Atenção: É importante destacar que as configurações de alerta são da conta/Tenant. Isso significa que qualquer alteração feita em uma configuração existente afetará todos os usuários que estão recebendo esses alertas.
Por exemplo, se você adicionou seu endereço de e-mail à lista de assinantes e configurou um alerta de SMS com um limite de erro de 5%, e outro usuário mais tarde se incluir na lista e alterar esse limite, isso afetará a configuração original que você definiu.
Erros comuns
Para identificar detalhes dos erros, é necessário exportar um relatório:
- Acesse Análises > Exportar Relatório;
- Selecione a opção + Nova Planilha e defina um nome e período para a planilha. A data deve ser compatível ao período de análise do alerta;
- Escolha os eventos que deseja incluir na planilha, como Automações, Dados de Clientes e Interações;
- Para focar apenas nos erros, é recomendável selecionar as interações Erros, Removidos, Opt-out e Spam.
- Escolha o destinatário para receber a planilha, que será enviada para o e-mail cadastrado.
Você pode identificar os erros na coluna "motivo" do relatório exportado.
Entenda os erros de e-mail
Ao exportar o relatório de erros no Zenvia Docs, você encontrará códigos que indicam a decisão do provedor em relação à sua mensagem. Cada código é composto por 3 dígitos (XXX), sendo o primeiro dígito o status da sua mensagem:
4XX – Erro temporário (Soft bounce)
Esse código indica um erro temporário durante o envio da sua mensagem, como a caixa de entrada do destinatário cheia ou instabilidade temporária no serviço de e-mail do destinatário. Você pode tentar enviar novamente, pois pode ser aceito em outro momento. Analise os demais dígitos (4.X.X) para entender melhor a descrição do alerta.
Veja algumas possíveis soluções:
-
Bloqueio anti-spam: O serviço de e-mail do contato possui um bloqueio interno que pode incluir o domínio, IP ou algum conteúdo específico do e-mail. Mantenha a base de contatos atualizada, evitando contatos inexistentes e conteúdo que possa ser considerado spam.
-
Caixa de entrada cheia: Ignore ou remova o contato da base, ou envie para um e-mail alternativo.
-
Conta indisponível, servidor indisponível, falha na entrega: ignore ou remova o contato da lista temporariamente.
-
Variáveis inválidas: Alguma variável no conteúdo do e-mail não está preenchida corretamente, portanto, atualize as informações cadastrais do contato.
5XX – Erro permanente (Hard bounce)
Indica que a conta inválida ou domínio inválido, ou seja, o endereço de e-mail é inexistente ou o endereço não aceita mensagens do remetente. Para entender melhor o tipo de erro permanente relatado, analise os demais dígitos (5.X.X).
A seguir, veja o código dos erros específicos mais comuns e como você pode tentar resolvê-los.
|
Erro |
Solução |
|
450 Mailbox unavailable Indica que o endereço de e-mail do destinatário não está acessível. |
Aguardar e tentar enviar o e-mail novamente mais tarde ou verificar se o endereço de e-mail do destinatário está correto e atualizado. |
|
452 Insufficient system storage Indica que o servidor do provedor não tem armazenamento de sistema suficiente. |
Aguardar e tentar enviar o e-mail novamente mais tarde; reduzir o tamanho do anexo ou dividir o conteúdo do e-mail em partes menores; ignorar ou remover o contato da base. |
|
454 Relay access denied Indica uma falha na sessão de entrega do e-mail devido a uma operação inadequada. |
Verificar se o servidor de e-mail do remetente está configurado corretamente para retransmitir e-mails para o destinatário, ou usar um servidor de e-mail intermediário que tenha permissão para retransmitir o e-mail. |
|
550 Requested action not taken |
Verificar se o endereço de e-mail do destinatário está correto e atualizado, verificar se o destinatário está na lista negra do servidor. |
|
552 Exceeded storage allocation Indica que o tamanho do email excede o limite de armazenamento do servidor de e-mail do destinatário. |
Reduzir o tamanho do anexo ou dividir o conteúdo do e-mail em partes menores. |
|
554 Transaction failed Resposta genérica indicando que a transação de entrega do e-mail falhou por algum motivo. |
Verificar se o endereço de e-mail do destinatário está correto e atualizado, verificar se o conteúdo do e-mail está em conformidade com as políticas de segurança do servidor de e-mail. |
Entenda os erros do WhatsApp
Para o canal WhatsApp, listamos os códigos dos erros específicos mais comuns e como solucioná-los.
Para verificar todos os erros de mensagens do WhatsApp, acesse a tabela Códigos de erro do cliente da WhatsApp Business API.
|
Erro |
Solução |
|
400 - Media download error Erro de download de mídia |
Falha ao baixar a mídia do remetente. Verificar se a mídia está disponível e tentar enviar novamente. |
|
408 - Message is not valid A mensagem não é válida |
Falha ao enviar a mensagem porque ela ficou pendente por muito tempo. Envie a mensagem novamente. |
|
429 - Rate limit hit Limite de taxa atingido |
Para mensagens enviadas: falha ao enviar a mensagem porque o número de telefone fez envios demais em um curto período. Envie as mensagens com falha novamente. Para mensagens de entrada: falha ao baixar a mídia devido à limitação de volume. Solicite ao remetente que envie a mensagem novamente. |
|
470 - Re-engagement message Mensagem de reengajamento |
Falha ao enviar a mensagem porque mais de 24 horas se passaram desde a última vez que o cliente respondeu a este número. Verificar se a mensagem de reengajamento está configurada corretamente e se atende às políticas do WhatsApp. |
|
471 - Spam rate limit hit Limite de taxa de spam atingido |
Verificar o conteúdo e a frequência das mensagens enviadas para evitar ser marcado como spam. |
|
1001 - Message too long Mensagem muito longa |
Reduzir o tamanho da mensagem ou dividi-la em partes menores antes de enviar. |
Entenda os erros de SMS
Para o canal SMS, saiba quais são os erros mais comuns e como solucioná-los.
|
Erro |
Solução |
|
Mensagem bloqueada por infração de conteúdo |
Rever o conteúdo da mensagem para garantir que esteja em conformidade com as políticas do provedor de SMS. Evite enviar mensagens com conteúdo considerado impróprio ou violador de diretrizes. |
|
O limite de conteúdo da mensagem foi ultrapassado |
A mensagem SMS excedeu o limite de 160 caracteres. |
|
Número do destinatário incorreto ou incompleto; Contato inválido |
Verificar o número do destinatário e corrigi-lo. Certificar-se de incluir os códigos DDI+DDD para enviar a mensagem com sucesso. |
|
Valor de campo variável inválido |
Corrigir qualquer valor de campo variável inválido antes de enviar a mensagem. |
|
O serviço ainda não está pronto. Tente novamente mais tarde; Serviço temporariamente indisponível |
Tentar enviar a mensagem novamente em um momento posterior, quando o serviço estiver disponível. |
Pronto! Agora você pode acompanhar e identificar os erros nos envios de comunicações em suas automações.