# Integração com E-mail

## Introdução

Esse documento tem como intuito instruir o usuário a integrar o Kwik com o E-mail.

Para isso, são necessários que o usuário preencha os 3 pre-requisitos listados abaixo.



1. Ter uma conta de e-mail
2. [Criar uma senha IMAP](https://instant.getoutline.com/doc/integracao-com-e-mail-v5RCr1SG2H#h-como-criar-uma-senha-imap)
3. [Adicione o seu e-mail no Kwik](https://instant.getoutline.com/doc/integracao-com-e-mail-v5RCr1SG2H#h-adicionando-uma-conta-de-e-mail)

   

## Como criar uma senha IMAP

De maneira geral, a senha IMAP é uma senha diferente da sua senha padrão de acesso ao e-mail, cada plataforma de e-mail possui diferentes maneiras de gera-la. Aqui iremos descrever como gerar esta senha nos principais provedores do mercado

### Gmail

Para gerar uma senha IMAP no Gmail:


1. Acesse as configurações do e-mail![Acesse as configurações do seu e-mail](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/9c0c6546-3abf-475b-8ffa-3423c5ac3362/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=d1e22e315ecefcb614169a205d16ea5f4a1dc52ce9992f090becdaa401ddbbfe&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)
2. Na aba de **Segurança** acesse a __Verificação em duas etapas__

   
   1. Caso a verificação em duas etapas ainda não esteja ativa em seu e-mail, é importante ativa-la para que a integração seja realizada.![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/f4c35203-59df-4a9c-bc90-18c7062313d2/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=73d0ef83a3609cfedec4475740d5b902c1dd81b9c72f2e7c2c666c01010471f8&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)
   2. Insira sua senha
   3. Role até o fim da página e click em **Senhas de app**![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/da94ae71-3628-493b-a210-4b4abbbab6a3/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=396e6c9bf4193a33761b759c4baddb429ea6c900af1fa2e5cdb45b8485878625&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

      
3. Dê um nome ao app, por exemplo: __Instant Solutions__![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/4d52f027-98fd-4ba7-8a52-1c95addf26c0/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=ab29b65029f5425b5adc40f559891e1fcdee4b4a800f7ff92519dd93a8abf353&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)
4. Ao clicar em **Criar** sua senha será exibida na tela. Esta será a senha que deve ser inserida quando você for [adicionar sua conta](https://instant.getoutline.com/doc/integracao-com-e-mail-v5RCr1SG2H#h-adicionando-uma-conta-de-e-mail)![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/ad9f6c65-f343-46bf-b53a-fbf50e6cb2aa/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=00e5d23a9719b04f9ed0bb9715ef0cf4b7e1ff15c526a7aa0543208fb7ec5624&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

   

### Outlook

Para o ambiente Office365, o processo se torna um pouco diferente. É necessário criar outras chaves de acesso para integração com o sistema. 


Acesse este documento para entender o passo a passo:

[Como Integrar Outlook ao Kwik](/doc/como-integrar-outlook-ao-kwik-CTE56cvoDj)


### Microsoft Exchange Oauth

## Adicionando uma conta de e-mail

Para adicionar uma conta de e-mail ao Kwik, você deve ir até **Canais de atendimento > EMAIL** e clicar no botão **ADICIONAR**

 ![Tela de preechimento das informações do e-mail](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/759395b0-8d39-4e5e-8086-816720e52d86/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=6ff52998404fe353a7707bce09ee2e6af3f309bb9c70c927b7b8a274e5b93ee6&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Exemplo de preenchimento dos dados:  
 ![Exemplo de preenchimento](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/fe597823-4209-4332-8d6b-c1b5ab4a63e9/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=c77b9f789538d4a8bbb21e3b0242a7b773a3c9c2b5ca13fa4fb80ac7e6ef7ab1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Preencha suas informações de:

* E-mail
* Senha IMAP
* Servidor
  * Para gmail, use: imap.gmail.com
  * Para outlook, use: outlook.office365.com
* Porta IMAP: 993 (Não precisa ser alterada)
* SMTP
  * **Gmail**: smtp.gmail.com
  * **Outlook**: smtp-mail.outlook.com
  * coloque a 465 para usar SSL e **porta 587 sem SSL**

    

Caso seu e-mail seja configurado de maneira diferente, click no botão “*Usa credenciais diferentes de imap e smtp?*“ e preecha com os dados da sua configuração de e-mail.


Com a sua conta adicionada, os e-mails da sua caixa serão visualizadas e os e-mails já podem ser respondidos através do Kwik.


## Configurando e utilizando o e-mail

[Configurando e-mails ignorados](/doc/configurando-e-mails-ignorados-PbiKvHPQ8e)

[Configurando templates padrão](/doc/configurando-templates-padrao-zg9w22T3YG)

[**Configurando o envio e recebimento de e-mails**](/doc/configurando-o-envio-e-recebimento-de-e-mails-PSAV18TSsR)


## Crie um bot para os e-mais (Builder)

Você deve criar um bot para dar uma tratativa aos e-mais recebidos. Veja o exemplo de um bot simples abaixo:

 ![Exemplo de fluxo para tratativa de e-mail](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/406fc1f3-dd71-4951-afec-292ed68d8793/60706c6d-b874-4e97-a42e-438beaecc5d9/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261022T224500Z&X-Amz-Expires=86400&X-Amz-Signature=71c807c2d5fc68c9dbc633e481011d6c329197673e3349b7ed59d6135e8ed2f9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Observe que neste bot, começamos com uma __condição__ onde o nome da variável deve ser exatamente ==is_email_in_reply_to==**,** esta variável interna irá verificar se o e-mail recebido é um e-mail novo ou de resposta. O valor esperado deve ser **==false==** ==ou **Empty**== por padrão.

Os demais blocos da ura seguem o padrão de atendimento, sendo importante lembrar que cada e-mail recebido, é considerado uma nova entrada de atendimento e passará por todo o fluxo desde o seu início. É importante considerar essa informação na criação de bots mais complexos para e-mail.





[Voltar ao início](/doc/integracoes-OhpyX1F3rR)

---

**Documents**

- [Guia de Onboarding - Kwik Scout](https://instant.getoutline.com/s/kwik-integracoes/doc/guia-de-onboarding-kwik-scout-Bmj6w7Jccq)
- [Integração SMS](https://instant.getoutline.com/s/kwik-integracoes/doc/integracao-sms-lmUhvyAs2t)
- [Integração com E-mail](https://instant.getoutline.com/s/kwik-integracoes/doc/integracao-com-e-mail-v5RCr1SG2H)
- [Integração com Facebook Messenger](https://instant.getoutline.com/s/kwik-integracoes/doc/integracao-com-facebook-messenger-GEZL9r8cML)