> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/canais-de-atendimento/e-mail.md).

# E-mail

## 📧 Configuração de Canal de E-mail

Foi disponibilizado um novo canal de **e-mail**, permitindo a integração de contas que não estejam diretamente conectadas aos hubs nativos (Gmail e Outlook).

***

### 📍 1. Acessando o Canal

Acesse a área de canais e selecione a opção de **E-mail**.

<figure><img src="/files/uwqkIkBw7o3JhH4iHlqE" alt=""><figcaption><p>Imagem 1 - Localização do canal de e-mail</p></figcaption></figure>

***

### ⚙️ 2. Escolha do Modelo de Configuração

Ao iniciar a configuração, selecione o modelo correspondente ao seu provedor de e-mail:

***

#### 🆕 **Modelo: E-mail personalizado(Manual)**

* Todos os campos devem ser preenchidos manualmente.
* Indicado para provedores personalizados ou não listados.
* É necessário informar dados como:
  * Servidor IMAP/SMTP
  * Portas
  * Tipo de segurança (SSL/TLS)
  * Usuário e senha

<figure><img src="/files/zlo585sG4vTjxw1CDKmY" alt=""><figcaption><p>Imagem 2 - Modelo de e-mail personalizado</p></figcaption></figure>

***

#### 📩 **Modelo: Gmail**

* Os campos técnicos são preenchidos automaticamente.
* Você deverá informar:
  * Usuário (e-mail)
  * Senha de aplicativo
  * Fluxo padrão de atendimento

<figure><img src="/files/fvjrkQRR7RJZPThI9RqM" alt=""><figcaption><p>Imagem 3 - Exemplo de canal do e-mail 'Gmail'</p></figcaption></figure>

{% hint style="info" %}

#### 🔴 Gmail — Obrigatório uso de Senha de Aplicativo

Para conectar uma conta Gmail, **não é possível utilizar a senha padrão da conta**.

Siga o passo a passo abaixo:

**Passo a passo para criar senha de app**

1. Acesse sua conta Google:\
   <https://myaccount.google.com>
2. No menu lateral, clique em **Segurança**
3. Em **“Como você faz login no Google”**, clique em **Verificação em duas etapas**
   * Caso não esteja ativa, será necessário ativar antes de continuar
4. Após ativar, acesse **Senhas de app**
5. Defina um nome para o aplicativo (ex: "Hyperflow")
6. Clique em **Criar**
7. Uma senha de 16 caracteres será gerada
   * Copie essa senha
   * Remova espaços, se houver
   * Utilize essa senha no campo de senha do canal
     {% endhint %}

***

#### 📩 **Modelo: Outlook**

* Os campos técnicos são preenchidos automaticamente.
* Autenticação realizada via **OAuth2**.
* Você deverá:
  * Logar usando login alternativo.
  * Definir o fluxo padrão de atendimento

<figure><img src="/files/HC5i5ryGW7S1BjknKbLN" alt=""><figcaption><p>Imagem 4 - Ao clicar em 'Logar com Outlook' é carregado para essa página para logar usando a opção alternativa diretamente.</p></figcaption></figure>

{% hint style="info" %}

#### 🟡 Outlook — Autenticação via OAuth2

* Não é mais necessário gerar senha de aplicativo
* A autenticação é feita utilizando **OAuth2**
* Requisitos obrigatórios:
  * Conta deve permitir conexão com aplicativos de terceiros
  * Credenciais válidas (e-mail e senha)

Se essa permissão não estiver ativa, a conexão será recusada.
{% endhint %}

***

### ⚠️ 3. Pontos de Atenção (Críticos)

* Falhas de autenticação normalmente estão relacionadas a:
  * Uso de senha incorreta (principal vs app)
  * Falta de permissão para apps terceiros
  * IMAP/SMTP desabilitado
* O sistema **não corrige automaticamente erros de configuração** — validação é responsabilidade do usuário