Como podemos ajudar?

Exportar relatórios de disparo de mensagens no Zenvia Customer Cloud
7 min
Criado por Leonora Alves em 15/02/2024 16:21
Atualizado por Ligia Sarmento em 04/09/2025 10:31
Importante: Antes de seguir com as instruções, confirme se a funcionalidade está disponível para o seu perfil de acesso.

O Zenvia Customer Cloud permite a exportação de um relatório de disparo para que você possa obter os detalhes de um envio específico, com o status de envio por destinatário. Esta lista é exportada para um arquivo formato .csv e pode conter mais de 100 mil contatos.

Para isso, clique em Análises > Envio de mensagens > Performance dos envios e selecione o disparo que deseja exportar o relatório.

Na lista de destinatários, você pode aplicar filtros de status específicos para entender a situação de cada contato. Para fazer isso:

  1. Clique em Selecionar filtros;

  2. Escolha os status que você deseja visualizar e clique em Aplicar. Por exemplo, se for selecionado Erro no envio, só serão exibidos os resultados que tenham dado erro (todos os outros casos não serão mostrados). Para exportar tudo, basta desabilitar os filtros clicando em Limpar filtros;

  3. Clique no botão Exportar para iniciar a exportação;

  4. Confirme o endereço de e-mail e clique em Iniciar exportação.

⚠️ Atenção: A página não é atualizada automaticamente. É necessário clicar em Atualizar dados.

  1. Por fim, clique em Baixar relatório.

O arquivo traz informações detalhadas sobre os status, inclusive com informações sobre os erros, e fica disponível para download no Zenvia Customer Cloud, seção Envio de mensagens > Relatórios, por até 30 dias após a solicitação. Caso o período expire, é necessário solicitar a exportação novamente.

O que é exportado

Ao exportar um relatório, é gerado um arquivo com os seguintes dados:

  • date: data e horário da última interação do destinatário com a mensagem;

  • recipient: exibe o número de telefone (se o disparo for via SMS, WhatsApp ou RCS) ou o endereço de e-mail (se for um disparo de e-mail) do destinatário;

  • channel: o canal do disparo;

  • status: status do envio;

  • reason_description: descrição do status de envio;

  • reicipient_answer: resposta do destinatário (se houver).

A seguir, veja cada um dos status de envio por canal.

Quais são os status de SMS

Como o SMS funciona de forma assíncrona, os relatórios de disparos também são afetados por essa particularidade, ou seja, algumas vezes o status não é recebido na cadência esperada. Apesar dessa particularidade, o Zenvia Customer Cloud sempre exibe o status mais atual recebido pelo servidor.

Abaixo, veja a lista dos status que podem ser exibidos:

  • Em análise: o envio está sendo analisado pelo filtro de regras da Zenvia. Seu SMS ainda não foi enviado;

  • Enviando: a mensagem está em processo de envio;

  • Enviado: a Zenvia enviou sua mensagem para o provedor, responsável pela entrega da mensagem;

  • Erro no envio: mensagem não enviada ao celular. É possível que o número esteja incorreto ou escrito de forma incorreta (ex.: fora do padrão DDI + DDD + Número). Para saber os motivos dos erros no envio, baixe o arquivo em Exportar lista. Nele você encontrará a coluna que representa os motivos de possíveis erros;

  • Recebido: mensagem enviada ao celular e recebida pelo destinatário;

  • Não recebido: mensagem enviada ao celular, mas não recebida pelo destinatário. Entre os motivos para o problema estão: celular desligado, celular inativo, indisponível ou fora da área de cobertura da operadora, conta bloqueada ou cancelada, problemas na operadora durante a entrega, indisponibilidade ou problema na rede da operadora, etc;

  • Lido: a mensagem foi recebida e lida pelo destinatário.

Quais são os status de e-mail, RCS e WhatsApp

  • Enviado: a Zenvia enviou sua mensagem para o provedor, responsável pela entrega da mensagem;

  • Erro no envio: mensagem não enviada ao celular. É possível que o número esteja incorreto ou escrito de forma incorreta (ex.: fora do padrão DDI + DDD + Número). Para saber os motivos dos erros no envio, baixe o arquivo em Exportar lista. Nele você encontrará a coluna que representa os motivos de possíveis erros;

  • Recebido: mensagem enviada ao celular e recebida pelo destinatário;

  • Não recebido: mensagem enviada ao celular, mas não recebida pelo destinatário. Entre os motivos para o problema estão: celular desligado, celular inativo, indisponível ou sem sinal de internet, número bloqueado ou cancelado, indisponibilidade ou problema no serviço, etc;

  • Aberto: mensagem recebida e aberta pelo destinatário (para e-mail) | Lido: mensagem recebida e lida pelo destinatário (para WhatsApp e RCS);

  • Clicado: o arquivo enviado na mensagem recebeu ao menos um clique do destinatário;

  • Descadastrado: o destinatário optou por não receber suas campanhas de e-mail ou WhatsApp, ou seja, cancelou a inscrição (unsubscribe) nos e-mails enviados ou desativou o recebimento das mensagens (opt-out) enviadas via WhatsApp.

O status Lido só está disponível caso o usuário não tenha desabilitado a confirmação de leitura (dois risquinhos azuis).

O sistema sempre envia uma notificação quando o relatório estiver pronto para download.

Pronto! Agora você sabe como exportar um relatório de disparos no Zenvia Customer Cloud.