> ## Documentation Index
> Fetch the complete documentation index at: https://docs.robbu.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Campanhas de E-mail

> Crie, configure e monitore campanhas de e-mail no Invenio Center: público-alvo, agendamento, remetente, templates e relatórios de desempenho em tempo real.

As **Campanhas de E-mail** do Invenio Center permitem o envio programado e massivo de mensagens para públicos segmentados. Ideal para:

* 📣 **Marketing:** promoções, lançamentos e engajamento
* 💳 **Cobranças:** lembretes e notificações de vencimento
* 🔔 **Notificações:** atualizações de status e confirmações

A interface guia o processo em etapas, com controle total sobre envios, segmentação e análise de resultados.

***

## Pré-requisito: Público-Alvo

<Warning>
  **Antes de criar uma campanha**, o público deve estar cadastrado no módulo **Público**.

  **Caminho:** Invenio Center > Converter > Público > Importar

  Consulte: [Importação de Público no Invenio Center](https://docs.robbu.global/docs/center/publico-importacao)
</Warning>

***

## Criar Campanha de E-mail

**Caminho:** Invenio Center > Converter > Campanhas > E-mail > **+ Criar campanha**

<Tip>
  **Acesso direto:** [Campanhas de E-mail](https://inveniocenter.robbu.global/painel/campanhas/email)
</Tip>

<Frame caption="Tela inicial das campanhas de e-mail">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/campEmail1.png" />
</Frame>

<Frame caption="Listagem de campanhas criadas">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/campEmail1.2.png" />
</Frame>

<Frame caption="Botão para criar nova campanha">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/campEmail1.3.png" />
</Frame>

<Steps>
  <Step title="Descrição da campanha">
    Defina um **nome** para identificação interna, organização e acompanhamento dos resultados.
  </Step>

  <Step title="Selecionar público-alvo">
    1. Escolha o **segmento** correspondente ao público que receberá os e-mails
    2. Selecione o **arquivo do público** importado

    <Frame caption="Seleção de segmento e público-alvo">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/descricaoPublico.png" />
    </Frame>

    <Warning>
      O canal de e-mail remetente deve estar **vinculado ao mesmo segmento** do público selecionado.
    </Warning>
  </Step>

  <Step title="Agendamento e intervalo de envio">
    Agende para data e horário específicos para:

    * ✅ **Planejamento** adequado dos disparos
    * ✅ **Evitar envios** fora do horário comercial
    * ✅ **Reduzir sobrecarga** no servidor

    **Intervalo de envio (opcional):**
    Configure o percentual de contatos que receberão o e-mail por ciclo de tempo.

    **Exemplo:** A cada 15 minutos, enviar para 20% dos contatos.
  </Step>

  <Step title="Contatos em atendimento">
    Defina como lidar com contatos em atendimento ativo no momento do disparo:

    | Opção                  | Comportamento                                           |
    | ---------------------- | ------------------------------------------------------- |
    | **Manter na campanha** | Contatos em atendimento recebem o e-mail normalmente    |
    | **Remover recentes**   | Exclui contatos atendidos dentro do período configurado |

    **Exemplo de configuração:** Remover contatos atendidos nas últimas 2 horas.

    <Frame caption="Configuração de limite de contatos em atendimento">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/LimiteContatosEmAtendimento.png" />
    </Frame>
  </Step>

  <Step title="Definir remetente e título">
    **Remetente:**

    | Opção                             | Endereço                                  |
    | --------------------------------- | ----------------------------------------- |
    | 📧 **Canal de e-mail próprio**    | E-mail cadastrado e vinculado ao ambiente |
    | 🏢 **Canal padrão da plataforma** | `mensagem@avisoseguro.com.br`             |

    **Título do e-mail:**
    Informe o assunto exibido na caixa de entrada do destinatário. Campo essencial para uma boa **taxa de abertura**.

    <Frame caption="Configuração de remetente e título do e-mail">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/RemetenteTitulo.png" />
    </Frame>
  </Step>

  <Step title="Conteúdo da mensagem">
    Escolha como definir o conteúdo:

    <Tabs>
      <Tab title="Público importado" icon="database">
        **Usar conteúdo existente** no campo "Mensagem" do público importado.

        Ideal quando o conteúdo já está personalizado por contato no arquivo de público.
      </Tab>

      <Tab title="Construtor visual" icon="pen-ruler">
        **Editor visual drag-and-drop** para criar e-mails sem precisar de HTML.

        **Vantagens:**

        * 🎨 Interface intuitiva de arrastar e soltar
        * 📱 Layout responsivo automático
        * 👁️ Pré-visualização em tempo real
        * 🖼️ Suporte a imagens, botões e colunas

        Ideal para criação rápida com controle visual.
      </Tab>

      <Tab title="HTML Direto" icon="code">
        **Insira código HTML** para controle total sobre o design.

        **Vantagens:**

        * 🎯 Personalização completa do layout
        * 🔧 Compatível com templates HTML externos
        * 💻 Ideal para equipes com conhecimento técnico

        Cole ou importe seu código HTML diretamente.
      </Tab>
    </Tabs>

    <Frame caption="Opções de conteúdo da mensagem">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/conteudoMensagem.png" />
    </Frame>

    <Note>
      Consulte: [Templates de E-mail no Invenio Center](https://docs.robbu.global/docs/center/templates-de-email)
    </Note>
  </Step>

  <Step title="Iniciar campanha">
    Revise todas as configurações e clique em **"Iniciar campanha"** para disparar ou confirmar o agendamento.

    <Check>
      Campanha criada com sucesso! Agora você pode acompanhar os resultados em tempo real no painel.
    </Check>
  </Step>
</Steps>

***

## Acompanhamento da Campanha

Na tela inicial, consulte informações de campanhas já realizadas:

* 📅 Horário, data de criação e conclusão
* ▶️ Início de envio
* 📊 Quantidade de mensagens processadas

Clique nos **três pontinhos** ao lado de cada campanha para:

* 📈 **Estatísticas** detalhadas da campanha
* 📥 **Download** do relatório CSV

<Frame caption="Painel de acompanhamento de campanhas de e-mail">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhas-email/painelCampanha2.png" />
</Frame>

***

## Estatísticas da Campanha

Acompanhe o desempenho em tempo real com três visões:

<Columns>
  <Column>
    **📤 Informações de envio**

    * Total de contatos da campanha
    * E-mails enviados com sucesso
    * E-mails pendentes de envio
    * Falhas durante o disparo
  </Column>

  <Column>
    **📈 Retorno por período**

    Quantidade de respostas/interações por hora. Considera todos os retornos do público engajado, independente do canal de entrada.

    **🎯 Retorno por evento**

    Eventos registrados por atendentes e chatbots para o público engajado.
  </Column>
</Columns>

***

## Relatório CSV (Download)

Exporte o relatório completo em **formato Excel (.csv)** pela opção **Download** no painel:

| Campo                             | Descrição                                     |
| --------------------------------- | --------------------------------------------- |
| **NomePessoa**                    | Nome do destinatário                          |
| **CpfCnpj**                       | CPF ou CNPJ do cliente                        |
| **CodPessoaCliente**              | Código interno da plataforma                  |
| **DDDTelefone**                   | DDD do telefone (quando disponível)           |
| **NumeroTelefone**                | Telefone do cliente (quando disponível)       |
| **EnderecoEmail**                 | E-mail de destino da campanha                 |
| **DataHoraSolicitacao**           | Data/hora do registro de envio                |
| **DataHoraEnvio**                 | Data/hora do envio efetivo                    |
| **Mensagem**                      | Conteúdo do e-mail enviado                    |
| **SituacaoEntrega**               | Status: enviado, entregue, falha, bloqueado   |
| **Data/Hora Entrega Email**       | Confirmação de recebimento pelo servidor      |
| **Data/Hora Clique Email**        | Data/hora do clique em link pelo destinatário |
| **Data/Hora Abertura Email**      | Data/hora da abertura do e-mail               |
| **Data/Hora Cancelamento Insc.**  | Data/hora do opt-out do destinatário          |
| **Data/Hora Marcação Spam Email** | Data/hora da marcação como spam               |

<Note>
  **Relatório "Campanhas Realizadas"** também disponível na plataforma, com filtro por período e canal (incluindo e-mail).

  Consulte: [Relatórios no Invenio Center](https://docs.robbu.global/docs/center/relatorios)
</Note>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Cadastro de Conta de E-mail" icon="envelope" href="https://docs.robbu.global/docs/center/cadastrar-conta-de-email">
    Configurar canal de e-mail próprio
  </Card>

  <Card title="Templates de E-mail" icon="file-lines" href="https://docs.robbu.global/docs/center/templates-de-email">
    Criar e gerenciar templates
  </Card>

  <Card title="Importação de Público" icon="users" href="https://docs.robbu.global/docs/center/publico-importacao">
    Cadastrar público para campanhas
  </Card>

  <Card title="Relatórios" icon="chart-line" href="https://docs.robbu.global/docs/center/relatorios">
    Campanhas Realizadas e NPS
  </Card>

  <Card title="Segmentos" icon="layer-group" href="https://docs.robbu.global/docs/center/segmentos">
    Configurar segmentos de envio
  </Card>

  <Card title="Filtro por Canal" icon="filter" href="https://docs.robbu.global/docs/live/filtro-por-canal">
    Filtrar conversas de e-mail
  </Card>
</CardGroup>

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="📋 É obrigatório ter público cadastrado antes de criar a campanha?">
    **Sim.** O público deve estar importado **antes** de criar a campanha.

    **Caminho de importação:**
    Invenio Center > Converter > Público > Importar > Selecionar arquivo > Confirmar

    Durante a criação da campanha, você selecionará o segmento e o arquivo importado.

    Consulte: [Importação de Público](https://docs.robbu.global/docs/center/publico-importacao)
  </Accordion>

  <Accordion title="📧 Quais remetentes posso usar nas campanhas de e-mail?">
    **Duas opções disponíveis:**

    | Opção             | Endereço                      | Quando usar                              |
    | ----------------- | ----------------------------- | ---------------------------------------- |
    | **Canal próprio** | Seu e-mail cadastrado         | Maior credibilidade e personalização     |
    | **Canal padrão**  | `mensagem@avisoseguro.com.br` | Quando não há e-mail próprio configurado |

    **Recomendação:** Use um canal próprio para melhor taxa de entrega e confiança do destinatário.

    **Caminho para cadastrar:** Invenio Center > Configurações > Canais > E-mail > Adicionar conta

    Consulte: [Cadastro de Conta de E-mail](https://docs.robbu.global/docs/center/cadastrar-conta-de-email)
  </Accordion>

  <Accordion title="⏰ Posso agendar a campanha para envio futuro?">
    **Sim!** O agendamento permite definir data e hora exatas para o disparo.

    **Boas práticas de agendamento:**

    * ✅ Horário comercial (9h–18h) para B2B
    * ✅ Evite fins de semana para cobranças
    * ✅ Terça a quinta têm melhores taxas de abertura

    **Caminho:** Invenio Center > Converter > Campanhas > E-mail > Criar > Agendamento
  </Accordion>

  <Accordion title="📊 Como funciona o intervalo de envio por percentual?">
    Permite enviar a campanha de forma **graduada**, evitando sobrecarga.

    **Como configurar:**

    * Defina o **percentual** de contatos por ciclo (ex: 20%)
    * Defina o **intervalo de tempo** entre ciclos (ex: 15 minutos)

    **Exemplo prático:**

    * 1.000 contatos na campanha
    * Configuração: 20% a cada 15 minutos
    * Resultado: 200 e-mails a cada 15 min → campanha concluída em \~1h15

    **Benefícios:** Evita bloqueios por volume anormal e mantém a reputação do servidor de e-mail.
  </Accordion>

  <Accordion title="👤 O que fazer com contatos em atendimento ativo no momento do disparo?">
    Você pode escolher entre duas opções:

    **Manter na campanha:**

    * Contato recebe o e-mail mesmo estando em atendimento
    * Pode causar mensagens duplicadas ou redundantes

    **Remover contatos recentes:**

    * Define um período de exclusão (ex: últimas 2 horas)
    * Contatos atendidos dentro do período são excluídos do disparo
    * Evita comunicação desnecessária com clientes já assistidos

    **Caminho:** Invenio Center > Converter > Campanhas > E-mail > Criar > Contatos em Atendimento
  </Accordion>

  <Accordion title="📝 Qual a diferença entre o Construtor visual e o HTML Direto?">
    | Característica       | Construtor             | HTML Direto            |
    | -------------------- | ---------------------- | ---------------------- |
    | Conhecimento técnico | ❌ Não precisa          | ✅ Recomendado          |
    | Interface            | Visual (drag-and-drop) | Código HTML            |
    | Flexibilidade        | Moderada               | Total                  |
    | Velocidade           | Rápida                 | Depende da experiência |
    | Responsividade       | Automática             | Manual                 |

    **Recomendação:**

    * **Equipe de marketing sem dev:** use o Construtor
    * **Equipe técnica ou layout complexo:** use HTML Direto
  </Accordion>

  <Accordion title="📈 Como acompanhar os resultados em tempo real?">
    Após o disparo, acesse as estatísticas:

    **Caminho:** Invenio Center > Converter > Campanhas > E-mail > Três pontinhos > Estatísticas

    **Métricas disponíveis:**

    * 📤 **Enviados / Pendentes / Falhas**
    * 📊 **Retorno por período** (respostas por hora)
    * 🎯 **Retorno por evento** (ações de atendentes e chatbots)
  </Accordion>

  <Accordion title="📥 O que contém o relatório CSV da campanha?">
    O relatório exportado inclui dados detalhados por contato:

    **Dados de entrega:** situação, data/hora de envio e entrega
    **Engajamento:** abertura, clique em links
    **Problemas:** opt-out (cancelamento de inscrição), marcação como spam

    **Como exportar:**
    Invenio Center > Converter > Campanhas > E-mail > Três pontinhos > Download

    Também disponível o relatório **"Campanhas Realizadas"** com filtro por período e canal.
  </Accordion>

  <Accordion title="🔗 O canal de e-mail precisa estar vinculado ao segmento do público?">
    **Sim, obrigatoriamente.**

    * O **segmento do público** define quem recebe o e-mail
    * O **canal de e-mail remetente** deve estar vinculado ao mesmo segmento
    * Se houver incompatibilidade, a campanha pode falhar ou não aparecer como opção

    **Como verificar:** Invenio Center > Configurações > Canais > E-mail > Verificar segmentos vinculados
  </Accordion>

  <Accordion title="⭐ Posso usar templates de e-mail prontos nas campanhas?">
    **Sim!** Durante a criação da campanha, ao selecionar a opção de conteúdo personalizado, você pode:

    * ✅ **Selecionar um template existente** criado anteriormente
    * ✅ **Criar um novo template** direto na campanha (Construtor ou HTML)
    * ✅ **Editar templates** existentes antes de usar

    **Caminho:** Invenio Center > Converter > Campanhas > E-mail > Criar > Conteúdo da Mensagem

    Consulte: [Templates de E-mail](https://docs.robbu.global/docs/center/templates-de-email)
  </Accordion>
</AccordionGroup>