Registro de atividades de envio de mensagem
O Registro de atividades de envio de mensagem permite que você veja todas as mensagens (especialmente mensagens de erro) associadas às suas campanhas e envios.
Você pode ver transações de campanhas da API, solucionar problemas com detalhes sobre mensagens com falha e obter insights sobre como melhorar a entrega de notificações ou resolver problemas técnicos existentes.
Para acessar o registro, acesse Configurações > Configuração e teste > Registro de atividades de envio de mensagem.
Além deste artigo, também recomendamos conferir nosso curso do Braze Learning Ferramentas de garantia de qualidade e depuração, que aborda como usar o Registro de atividades de envio de mensagem para conduzir sua própria solução de problemas e depuração.
Você pode filtrar pelo seguinte conteúdo registrado no Registro de atividades de envio de mensagem:
- Erros de notificação por push
- Erros de mensagens no app com modelo abortado
- Erros de webhook
- Erros de e-mail
- Registros de mensagens da API
- Erros de Conteúdo conectado
- Erros de público conectado da REST API
- Erros de aliasing de usuário
- Erros de testes A/B
- Erros de SMS/MMS
- Erros de WhatsApp
- Erros de Live Activity
- Erros de gatilho de usuário inválido
- Erros de limite diário de invocações do Braze Agents
- Erros de modelo indisponível do Braze Agents
Essas mensagens podem vir do nosso próprio sistema, dos seus apps ou plataformas, ou dos nossos parceiros terceiros. Isso pode resultar em um número infinito de mensagens que podem aparecer neste registro.
Entendendo as mensagens do log
Para determinar o que suas mensagens significam, preste atenção ao texto de cada mensagem e às colunas correspondentes, pois isso pode ajudar na solução de problemas usando pistas de contexto.
Por exemplo, entradas de Aborted Message Error podem ocorrer por vários motivos, não apenas por mensagens de interrupção do Liquid. Leia a coluna Message para ver o motivo específico:
- Se o envio foi interrompido por uma tag
abort_messagedo Liquid, a coluna Message mostra o snippet exato do Liquid que foi chamado, por exemplo{% abort_message('Module count is less than or equal to 1') %} called. - Para outros motivos de interrupção, a coluna Message explica por que o envio foi interrompido.
Cargas úteis de Campaigns via API
O log de atividades de mensagens registra informações diferentes dependendo do tipo de Campaign via API. O endpoint /messages/send registra o corpo da mensagem (messages) nos registros de mensagens da API, enquanto o endpoint /campaigns/trigger/send não registra a carga útil da solicitação nem as api_trigger_properties no log de atividades de mensagens.
Mensagens comuns
Existem alguns tipos comuns de mensagens que você pode ver, e alguns podem até fornecer links de solução de problemas para ajudar a diagnosticar e corrigir questões.
As mensagens a seguir são apenas para fins de exemplo e podem não corresponder exatamente ao que é exibido na coluna Message do seu log.
| Tipo de mensagem | Mensagem potencial | Descrição |
|---|---|---|
| Soft Bounce | The email address [email protected] soft bounced. | O endereço de e-mail era válido e a mensagem de e-mail chegou ao servidor de e-mail do destinatário, mas foi rejeitada por um problema “temporário”. Motivos comuns de soft bounce incluem:
|
| Hard Bounce | The email account that you tried to reach does not exist. Try double-checking the recipient’s email address for typos or unnecessary spaces. | Sua mensagem nunca chegou à caixa de entrada dessa pessoa porque não havia uma caixa de entrada para alcançar. Se quiser investigar mais, mensagens como essa podem às vezes ter links na coluna View Details que permitem visualizar o perfil do destinatário pretendido. |
| Block | Spam message is rejected because of anti-spam policy. | Sua mensagem foi categorizada como SPAM. Esse erro de e-mail é registrado para um usuário se recebermos um evento do provedor de serviços de e-mail indicando que o e-mail foi descartado. Pode ser apenas para aquele destinatário específico, mas se você está vendo essa mensagem com frequência, talvez queira reavaliar seus hábitos de envio ou o conteúdo da sua mensagem. Além disso, pense: você aqueceu seu IP? Se não, entre em contato com a Braze para obter orientações sobre como fazer isso. |
| Aborted Message Error | {% abort_message('Module count is less than or equal to 1') %} called |
Quando um envio é interrompido por uma tag abort_message do Liquid, a coluna Message mostra o snippet exato do Liquid que foi chamado. Outras entradas de Aborted Message Error podem ter mensagens diferentes que descrevem o motivo da interrupção. |
Por que minha mensagem não está listada aqui?
As mensagens no log de atividades de mensagens podem vir de diversas fontes: da Braze, dos seus apps ou plataformas, ou dos nossos parceiros terceiros. Isso significa que há um número infinito de mensagens que poderiam aparecer nesse log — como você pode imaginar, não é possível listar todas!
Chamadas de abort_message em etapas de contexto e de agente não são registradas aqui, porque essas etapas não enviam uma mensagem. Para verificar se uma variável de contexto foi definida, use a métrica Not Updated da etapa ou Prévia de jornadas do usuário.
Por exemplo, algumas possíveis mensagens de “Block”, além da listada na tabela anterior, poderiam ser:
- Unfortunately, messages from [IP_ADDRESS] weren’t sent. Please contact your Internet Service provider since part of their network is on our block list.
- Message rejected due to local policy.
- The message was blocked by the receiver as spam.
- Service unavailable, Client host [IP_ADDRESS] blocked using Spamhaus.
Período de retenção de armazenamento
Erros das últimas 60 horas estão disponíveis nos Logs de atividade de mensagens. Logs com mais de 60 horas são limpos e não ficam mais acessíveis.
Número de logs de erro armazenados
O número de logs salvos é influenciado por diversas condições. Por exemplo, se uma Campaign agendada é enviada para milhares de usuários, é possível que apenas uma amostra dos erros seja exibida no Log de atividade de mensagens, em vez de todos os erros. A seguir, uma visão geral das condições que afetam quantos logs são salvos:
- Até 20 logs de erro do mesmo tipo são salvos para a mesma Campaign ou etapa do Canvas dentro de uma hora fixa de relógio para os seguintes tipos de erro:
- Erros de Connected Content
- Erros de interrupção de mensagem
- Erros de webhook
- Erros de rejeição de SMS
- Erros de falha de entrega de SMS
- Erros de falha do WhatsApp
- Erros de testes A/B
- Até 20 logs de erro de notificação por push do mesmo tipo são salvos para a mesma Campaign ou etapa do Canvas e combinação de app para os seguintes tipos de erro:
- Credencial de push inválida
- Token por push inválido
- Sem credencial de push
- Erros de token
- Cota excedida
- Tempo esgotado nas tentativas
- Carga útil inválida
- Erro inesperado
- Até 100 logs de erro do mesmo tipo são salvos para o mesmo app dentro de uma hora fixa de relógio para os seguintes tipos de erro:
- Erro de Live Activity (sem credencial de push)
- Erro de Live Activity (credencial de push inválida)
- Outros erros de Live Activity
- Erros de token removido por feedback do APNS
- Até 100 logs de erro do mesmo tipo são salvos para a mesma Campaign ou etapa do Canvas dentro de uma hora fixa de relógio para os seguintes tipos de erro:
- Erros de soft bounce de e-mail
- Erros de hard bounce de e-mail
- Erros de bloqueio de e-mail
- Até 100 logs de erro de aliasing de usuário são salvos para o mesmo espaço de trabalho dentro de uma hora fixa de relógio.
Envios de teste
O Registro de atividade de mensagens exibe registros de teste para os seguintes canais de envio de mensagens:
- SMS
- LINE
- KakaoTalk
- Webhook
Os registros de envio de teste não estão disponíveis para os seguintes canais: e-mail, Content Cards, mensagens no app e push.
Os registros de envio de teste são prefixados com “[TEST SEND]”, mas não há garantia de que todos os registros de envio de teste tenham o prefixo (por exemplo, erros de Connected Content não incluem o prefixo).