> ## 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.

# Cadastro e Configuração de Contas de E-mail

> Integre contas de e-mail ao Invenio Center para centralizar atendimento, histórico completo e direcionamento automático por segmento. Suporta Office 365, Gmail e servidores personalizados.

A integração de **contas de e-mail** no Invenio Center centraliza o atendimento em um único lugar, com:

* 📥 **Recebimento e envio** diretamente pela plataforma
* 🎯 **Direcionamento automático** por segmento
* 📋 **Histórico completo** e rastreabilidade
* 📣 **Campanhas de e-mail** enviadas pelo canal configurado

<Warning>
  **Uso exclusivo:** A conta de e-mail integrada deve estar **conectada apenas à Robbu**. Não pode estar logada em outros dispositivos ou vinculada a outras plataformas. Isso garante estabilidade, segurança e rastreabilidade total do canal.
</Warning>

***

## Acessar Canal de E-mail

**Caminho:** Invenio Center > Canais > **E-mail**

<Tip>
  **Acesso direto:** [Canal de E-mail no Invenio Center](https://inveniocenter.robbu.com.br/painel/canais/emails)
</Tip>

<Frame caption="Painel de canal de e-mail no Invenio Center">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/canais/canalEmail1.png" />
</Frame>

***

## Adicionar Nova Conta

Clique em **"+ Adicionar e-mail"** e escolha o método de conexão:

<Frame caption="Botão + Adicionar e-mail e métodos disponíveis">
  <img src="https://robbublob.blob.core.windows.net/docs/changelog/addemail.png" />
</Frame>

<Tabs>
  <Tab title="Office 365 / Gmail" icon="cloud">
    ### Conexão OAuth (recomendada)

    Conexão automática e segura via autenticação nativa dos provedores.

    <Steps>
      <Step title="Selecionar provedor">
        Clique em **"Conectar com Microsoft"** (Office 365) ou **"Conectar com Google"** (Gmail).

        <Frame caption="Opções de conexão OAuth: Microsoft e Google">
          <img src="https://robbublob.blob.core.windows.net/docs/changelog/addemail1.png" />
        </Frame>
      </Step>

      <Step title="Fazer login">
        Realize o **login** com suas credenciais do provedor na janela que se abrirá.
      </Step>

      <Step title="Autorizar acesso">
        Autorize o Invenio Center a acessar a conta. A conexão será estabelecida **automaticamente**.
      </Step>
    </Steps>

    <Check>
      Conexão OAuth não requer configuração manual de SMTP/IMAP. Mais segura e fácil de manter.
    </Check>
  </Tab>

  <Tab title="Cadastro Manual" icon="server">
    ### Conexão Manual (outros servidores)

    Para contas corporativas personalizadas ou servidores próprios.

    <Steps>
      <Step title="Preencher dados básicos">
        * **Nome:** Identificação interna da conta (ex: "Financeiro", "Suporte")
        * **Endereço de e-mail:** E-mail completo a ser integrado
        * **Segmento:** Carteira responsável pelas mensagens recebidas
      </Step>

      <Step title="Selecionar protocolos">
        Configure os protocolos de **envio** e **recebimento**:

        **Envio (SMTP) — obrigatório:**

        | Protocolo            | Porta | Descrição                   |
        | -------------------- | ----- | --------------------------- |
        | **SMTPS**            | 465   | Envio com SSL (recomendado) |
        | **SMTP TLS**         | 587   | Envio com TLS               |
        | **SMTP alternativo** | 2525  | Alternativa à porta 587     |

        **Recebimento — escolha um:**

        | Protocolo | Porta | Descrição                               |
        | --------- | ----- | --------------------------------------- |
        | **POP3S** | 995   | Download local com SSL/TLS              |
        | **IMAPS** | 993   | Sincronização em tempo real com SSL/TLS |

        <Note>
          **POP3 vs IMAP:**

          * **POP3:** Baixa e-mails para o Invenio sem manter sincronização com o servidor
          * **IMAP:** Sincroniza em tempo real — alterações refletem em ambos os lados (**recomendado**)
        </Note>

        <Frame caption="Configuração dos protocolos SMTP e recebimento">
          <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/canais/SMTP.png" />
        </Frame>
      </Step>

      <Step title="Informar credenciais">
        Preencha as credenciais de acesso ao servidor:

        * **Usuário:** Endereço de e-mail para autenticação
        * **Senha:** Senha da conta
        * **Host:** Endereço do servidor (ex: `smtp.empresa.com.br`)
        * **Porta:** Conforme o protocolo selecionado

        <Frame caption="Campos de credenciais de acesso ao servidor">
          <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/canais/SMTP2.png" />
        </Frame>
      </Step>

      <Step title="Criar e testar conexão">
        Clique em **"Criar"**. O sistema testará a conexão automaticamente.

        **Resultado esperado:** Status **"Conexão realizada com sucesso"**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Ativar e Gerenciar a Conta

Após criar a conta, ela ficará **inativa** até ser ativada. Clique nos **três pontinhos** ao lado direito para gerenciar:

<Frame caption="Menu de ações da conta de e-mail">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/canais/EmailAtivado1.png" />
</Frame>

| Ação                        | Descrição                                  |
| --------------------------- | ------------------------------------------ |
| ✏️ **Editar configurações** | Ajusta carteira, nome e conta de e-mail    |
| 🔄 **Alterar status**       | Alterna entre **ativo** e **inativo**      |
| 🗑️ **Deletar conta**       | Remove permanentemente a conta do ambiente |

<Frame caption="Menu de Editar, Alterar status e Deletar">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/canais/EditarAlterarDeletar.png" />
</Frame>

<Warning>
  **Conta inativa** não envia nem recebe mensagens. Ative a conta após o cadastro para que o canal funcione.
</Warning>

***

## Benefícios da Integração

<Columns>
  <Column>
    **📥 Atendimento centralizado**

    * Receba e responda e-mails pela plataforma
    * Histórico completo de interações
    * Rastreabilidade total dos envios

    **🎯 Direcionamento inteligente**

    * Roteamento automático por segmento
    * Múltiplas contas por setor/carteira
  </Column>

  <Column>
    **📣 Campanhas de e-mail**

    * Use o canal como remetente de campanhas
    * Templates personalizados por conta

    **🔒 Segurança**

    * SSL/TLS em todos os protocolos
    * Credenciais protegidas
    * Conexão exclusiva Robbu
  </Column>
</Columns>

<Tip>
  **Boas práticas de segurança:** Mantenha as credenciais protegidas, use SSL/TLS e revise os acessos periodicamente.
</Tip>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Campanhas de E-mail" icon="bullhorn" href="https://docs.robbu.global/docs/center/campanhas-de-email">
    Usar a conta em campanhas
  </Card>

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

  <Card title="Canais de Atendimento" icon="comments" href="https://docs.robbu.global/docs/center/canais-atendimento">
    Todos os canais disponíveis
  </Card>

  <Card title="Cancelamento de Inscrição" icon="ban" href="https://docs.robbu.global/docs/center/cancelamento-inscricao">
    Configurar opt-out de e-mail
  </Card>

  <Card title="Restrições de Envio" icon="shield" href="https://docs.robbu.global/docs/center/restricoes">
    Regras e limites de segurança
  </Card>

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

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="🔌 Qual protocolo é obrigatório para envio?">
    O **SMTP** é obrigatório — é o responsável pelo **envio** de mensagens.

    **Opções de porta SMTP:**

    * **465 (SMTPS):** Envio com SSL — recomendado
    * **587 (SMTP TLS):** Envio com TLS — padrão moderno
    * **2525:** Alternativa quando 465 e 587 estão bloqueados

    Para o **recebimento**, escolha entre POP3 (porta 995) ou IMAP (porta 993).
  </Accordion>

  <Accordion title="📬 Qual a diferença entre POP3 e IMAP?">
    | Característica      | POP3                         | IMAP                      |
    | ------------------- | ---------------------------- | ------------------------- |
    | Funcionamento       | Baixa e-mails para o Invenio | Sincroniza com o servidor |
    | E-mails no servidor | Removidos após download      | Mantidos no servidor      |
    | Multi-dispositivo   | ❌ Não                        | ✅ Sim                     |
    | Recomendado         | Para uso simples             | **Para uso profissional** |

    **Recomendação:** Use **IMAP** para manter sincronização e evitar perda de mensagens.
  </Accordion>

  <Accordion title="📧 Posso conectar contas além de Gmail e Outlook?">
    **Sim!** Use o **Cadastro Manual** para qualquer servidor de e-mail:

    * Servidores corporativos próprios
    * Provedores regionais (UOL, Terra, etc.)
    * Servidores de e-mail empresariais

    Você precisará informar: Host, Porta, Usuário e Senha.

    **Caminho:** Invenio Center > Canais > E-mail > + Adicionar e-mail > Cadastro Manual
  </Accordion>

  <Accordion title="✅ Como ativar a conta após o cadastro?">
    Após criar a conta, acesse:

    **Invenio Center > Canais > E-mail > Três pontinhos > Alterar status > Ativar**

    O status exibirá **"Conexão realizada com sucesso"** quando a conta estiver ativa e pronta para uso.

    <Note>
      A conta permanece **inativa** por padrão após o cadastro e não envia/recebe mensagens até ser ativada.
    </Note>
  </Accordion>

  <Accordion title="🏢 Posso ter múltiplas contas de e-mail no mesmo ambiente?">
    **Sim!** O Invenio Center suporta **múltiplas contas integradas**, ideais para organizar por:

    * 🏷️ Segmentos (Financeiro, Suporte, Comercial)
    * 📧 Endereços diferentes por produto/serviço
    * 🌍 Operações regionais ou filiais

    Cada conta é vinculada a um segmento específico, com roteamento automático das mensagens.
  </Accordion>

  <Accordion title="🎯 Como funciona o direcionamento por segmento?">
    Durante o cadastro, você associa a conta a um **segmento** (carteira).

    **Como funciona:**

    1. E-mail recebido → identificado pelo endereço de destino
    2. Sistema consulta o segmento vinculado à conta
    3. Conversa direcionada automaticamente para a equipe do segmento
    4. Atendentes veem apenas conversas do seu segmento

    **Caminho:** Invenio Center > Canais > E-mail > Editar conta > Campo "Segmento"
  </Accordion>

  <Accordion title="⚠️ Por que a integração precisa ser exclusiva com a Robbu?">
    Se a conta estiver logada em outros dispositivos ou plataformas simultaneamente, ocorrem:

    * ❌ **Conflitos de sincronização** — mensagens processadas duas vezes
    * ❌ **Instabilidade na conexão** — desconexões frequentes
    * ❌ **Perda de rastreabilidade** — respostas fora da plataforma não registradas

    **Solução:** Desconecte a conta de outros dispositivos antes de integrar no Invenio.
  </Accordion>

  <Accordion title="🔧 O que fazer se a conexão falhar ao cadastrar?">
    **Checklist de verificação:**

    1. ✅ **Credenciais** (usuário e senha) estão corretas
    2. ✅ **Porta e protocolo** correspondem ao seu provedor
    3. ✅ **Host do servidor** está correto (ex: `smtp.empresa.com`)
    4. ✅ Servidor aceita **conexões externas** (verifique firewall)
    5. ✅ Conta **não está integrada** em outra plataforma

    Após corrigir, clique em **"Criar"** novamente para testar a conexão.

    **Erro comum no Gmail:** Ative o "Acesso de apps menos seguros" ou use uma **Senha de App** específica.
  </Accordion>

  <Accordion title="✏️ Posso editar ou remover uma conta após criada?">
    **Sim.** No menu de três pontinhos da conta:

    * ✏️ **Editar:** Altera nome, carteira/segmento e endereço de e-mail
    * 🔄 **Alterar status:** Ativa ou desativa a conta sem excluir
    * 🗑️ **Deletar:** Remove permanentemente (ação irreversível)

    **Caminho:** Invenio Center > Canais > E-mail > Três pontinhos > Ação desejada
  </Accordion>

  <Accordion title="🔒 Quais são as boas práticas de segurança?">
    * 🔐 **Use SSL/TLS** em todos os protocolos (portas 465/993/995)
    * 🔑 **Não compartilhe** logins entre usuários
    * 🔄 **Revise credenciais** periodicamente
    * 👁️ **Monitore o status** e conectividade regularmente
    * 📵 **Mantenha exclusividade** — conta ativa apenas no Invenio
    * 🛡️ **No Gmail:** Prefira conexão OAuth (mais segura que senha de app)
  </Accordion>
</AccordionGroup>