Exportar o resultado de uma campanha

Depois da execução, o resultado da campanha pode ser exportado em CSV com o status de cada envio. É onde você descobre quem recebeu, quem não recebeu e por quê.

Como exportar

Na lista de campanhas, localize a campanha executada e use a exportação de resultado. O arquivo sai em CSV.

O que o arquivo mostra

O status de cada contato da base, individualmente. O status agregado que aparece na tela diz que a campanha terminou; o arquivo diz o que aconteceu com cada linha.

Uma campanha marcada como Executada pode ter falhas dentro dela. Sem abrir o arquivo, essas falhas passam despercebidas.

As colunas do arquivo

Coluna	Conteúdo
`campaignId`	Identificador da campanha
`nome`	Nome do contato
`telefone`	Número usado no envio, já normalizado
`status`	Situação do envio para aquele contato
`created_at`	Quando o registro foi criado
`updated_at`	Última atualização do registro
`timestamp_status_sent`	Quando a mensagem foi enviada
`timestamp_status_delivered`	Quando foi entregue no aparelho
`timestamp_status_read`	Quando foi lida pelo contato
`timestamp_status_received`	Quando houve resposta recebida
`timestamp_status_error`	Quando ocorreu erro
`timestamp_status_failed`	Quando o envio falhou
`errors`	Descrição do erro, quando houver

As colunas de horário ficam vazias nas etapas que não aconteceram. É por elas que se mede o funil real da campanha: quantos saíram, quantos chegaram, quantos foram lidos.

Nota: entregue e lido dependem do que o WhatsApp devolve. Um contato com confirmação de leitura desligada pode aparecer como entregue e nunca como lido, mesmo tendo lido.

Motivos de falha que você vai encontrar

Motivo	O que fazer
Telefone inválido	Corrigir o número na base de origem
Número na lista de opt-out	Nada a fazer — o contato pediu para não receber
Número sem WhatsApp	Remover ou atualizar o contato
Falha de entrega do canal	Verificar se o número existe e está ativo

Atenção: contatos bloqueados por opt-out aparecem como falha, mas isso não é um problema a corrigir. É o sistema respeitando o descadastro do contato. Reenviar para essas pessoas não é permitido.

Use o resultado para higienizar a base

O maior valor da exportação é a próxima campanha. Depois de cada disparo:

Filtre as linhas com falha.
Separe as falhas de telefone inválido — são corrigíveis.
Corrija ou remova esses contatos na base de origem.
Deixe as linhas de opt-out de fora dos próximos envios.

Bases que nunca passam por essa limpeza acumulam erro a cada campanha.

Perguntas frequentes

A opção de exportar não aparece. A exportação fica disponível após a execução. Campanhas Pendentes ou Agendadas ainda não têm resultado.

A campanha está Executada, mas muita gente não recebeu. Abra o arquivo e olhe os motivos de falha. Normalmente é formato de telefone na base de origem. Ver Preparar o arquivo CSV de contatos.

Posso reenviar só para quem falhou? Não há reenvio automático. Monte uma nova campanha com a lista corrigida — sem incluir os contatos de opt-out.