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 registro
Para entender o significado das suas mensagens, preste atenção na redação de cada mensagem e nas colunas correspondentes, pois isso pode ajudar na solução de problemas usando pistas contextuais.
Por exemplo, entradas de Aborted Message Error podem ocorrer por diversas razões, não apenas por mensagens de interrupção do Liquid. Leia a coluna Message para entender 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 registro de atividade 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 requisição nem as api_trigger_properties no registro de atividade de mensagens.
Mensagens comuns
Existem alguns tipos comuns de mensagens que você pode encontrar, e alguns podem até fornecer links de solução de problemas para ajudar a diagnosticar e corrigir problemas.
As mensagens a seguir são apenas exemplos e podem não corresponder exatamente ao que é exibido na coluna Message do seu registro.
| 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 a fundo, 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 algo específico daquele destinatário, mas se você está vendo essa mensagem com frequência, talvez seja hora de reavaliar seus hábitos de envio ou o conteúdo da sua mensagem. Além disso, pense: você fez o aquecimento do seu IP? Se não, entre em contato com a Braze para orientação sobre como começar. |
| 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 registro de atividade de mensagens podem vir de diversas fontes: da Braze, dos seus apps ou plataformas, ou de nossos parceiros terceiros. Isso significa que existe um número infinito de mensagens que podem aparecer neste registro — como você pode imaginar, não é possível listar todas!
Por exemplo, algumas possíveis mensagens de “Block”, além da listada na tabela anterior, podem 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 apagados e não ficam mais acessíveis.
Número de logs de erros armazenados
O número de logs salvos é influenciado por diversas condições. Por exemplo, se uma Campaign agendada é enviada para milhares de usuários, potencialmente veríamos uma amostra dos erros 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 erros do mesmo tipo são salvos para a mesma Campaign ou etapa do Canvas dentro de uma hora fixa do 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 na entrega de SMS
- Erros de falha do WhatsApp
- Erros de testes A/B
- Até 20 logs de erros 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 limite de tentativas esgotado
- Carga útil inválida
- Erro inesperado
- Até 100 logs de erros do mesmo tipo são salvos para o mesmo app dentro de uma hora fixa do 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 pelo feedback do APNS
- Até 100 logs de erros do mesmo tipo são salvos para a mesma Campaign ou etapa do Canvas dentro de uma hora fixa do 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 erros de aliasing de usuário são salvos para o mesmo espaço de trabalho dentro de uma hora fixa do 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 envios de teste não estão disponíveis para os seguintes canais: e-mail, Content Cards, mensagens no app e push.
Os registros de envios de teste são prefixados com “[TEST SEND]”, mas não é garantido que todos os registros de envios de teste tenham o prefixo (por exemplo, erros de Connected Content não têm o prefixo).