For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/messaging/export-sending-history.md.
  • Português
  • Como exportar o histórico de envios em CSV?

    Abra Mensagens → Histórico de Envios, ajuste os filtros e clique em Exportar. O arquivo é gerado em segundo plano: você acompanha o progresso no canto da tela e baixa o CSV quando ficar pronto, sem precisar ficar na página.

    Antes de começar

    • Você precisa de acesso à área de Mensagens do workspace. Veja Permissões.
    • O arquivo traz dados pessoais dos contatos (nome, e-mail, telefone). Compartilhe com cuidado e conforme a proteção de dados.

    Passos

    1. Abra Mensagens e entre na aba Histórico de Envios.
    2. Na aba Mensagens, use os filtros de busca, Status, Plataforma, Broadcast e Automação para chegar ao recorte que você quer exportar. O arquivo respeita exatamente os filtros aplicados; sem filtros, exporta todo o histórico do workspace.
    3. Clique em Exportar.
    4. Confira a quantidade de mensagens informada e confirme em Gerar CSV.
    5. Acompanhe o progresso na notificação que aparece no canto da tela. Quando terminar, clique nela para abrir os detalhes e use Baixar para salvar o arquivo.

    Se fechar a notificação ou trocar de página, o arquivo continua disponível em Contatos → Ações em massa, na linha "Exportar N mensagens do histórico de envios".

    O que vem no arquivo

    Cada linha é uma mensagem enviada (ou tentada) para um contato. As colunas, na ordem do arquivo:

    ColunaO que contém
    ID da instânciaIdentificador único do envio
    Enfileirado em, Enviado em, Entregue em, Visualizado em, Clique em, Falhou emData e hora de cada etapa do envio (formato ISO, fuso UTC). Vazio (-) quando a etapa não aconteceu
    StatusSituação atual: queued, sending, sent, delivered, visualized, failed, held ou cancelled
    PlataformaCanal do envio: email, gupshup (WhatsApp), telegram, sms, voice, instagram ou webchat
    Destinatário (canal)Endereço usado no envio: número, e-mail ou identificador do chat
    ID do contato, Nome do contato, E-mail do contato, Telefone do contatoDados do contato no momento da exportação
    ID da mensagem, MensagemIdentificador e nome da mensagem (template) que originou o envio
    Categoria de envioOrigem: workflows (automação), broadcast ou individual
    Modobroadcast, transactional, individual, group ou system
    Assunto do e-mailAssunto, só para e-mails
    Template do WhatsAppNome do template aprovado, só para envios por template
    Parâmetros do templateValores usados nas variáveis do template, separados por |
    Formato do conteúdoTipo da primeira parte da mensagem: text, html, template, image, audio, etc.
    Conteúdo (prévia)Texto da mensagem como o contato recebeu, limitado a 100 caracteres. E-mails vêm sem o HTML (só o texto); mídias mostram a legenda ou o nome do arquivo
    ID do broadcast, BroadcastBroadcast que originou o envio, quando houver
    ID da automação, Automação, ID da etapa da automação, ProjetoAutomação e etapa que originaram o envio, quando houver
    Erro, Código do erro, Mensagem do erro, Status de falha do e-mailDetalhes da falha, quando houver
    Custo em créditosCréditos consumidos pelo envio
    ReprocessamentosQuantas vezes o envio foi retomado manualmente
    Webhooks recebidosQuantidade de eventos de status recebidos do provedor

    O CSV usa vírgula como separador e codificação UTF-8. Ao abrir no Excel, use Dados → Obter dados → De texto/CSV para preservar acentos.

    Relacionados

    Se não funcionou

    • O botão Exportar não aparece: confirme que está na aba Mensagens do Histórico de Envios (a aba Webhooks não exporta) e que tem acesso à área de Mensagens.
    • A exportação ficou com falha: abra os detalhes na notificação ou em Ações em massa para ver o erro e tente novamente. Se persistir, veja os códigos de erro.
    • O arquivo não tem o texto completo da mensagem: é esperado. A coluna de conteúdo é uma prévia de até 100 caracteres; para ler a mensagem inteira, abra o envio no Histórico de Envios.