![Fluxo para configurar o SMTP de uma caixa de e-mail: preparar a conta no Google ou SendGrid, abrir a configuração da caixa de entrada, ativar SMTP, preencher servidor e credenciais e enviar uma resposta de teste.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazhSIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--322755ab0e35ec6316be4e26b0739f33121b29d9/1715794730-como-usar-o-smtp-do-google-para-enviar-e_mails.png)

Use uma configuração SMTP própria quando quiser que as respostas de uma **caixa de entrada de e-mail** saiam pelo seu domínio ou provedor. Este ajuste é feito no painel, dentro da caixa de entrada — você não precisa alterar variáveis de ambiente nem reiniciar a plataforma.

> Este guia configura o envio das conversas da sua caixa de e-mail. Os e-mails gerais da plataforma, como convites e recuperação de senha, são administrados pelo serviço ChatWoot BR.

## Antes de começar

Você precisa:

- ser **Administrador** da conta;
- ter uma caixa de entrada de **E-mail** já criada;
- possuir as credenciais SMTP do provedor;
- confirmar que o endereço usado como remetente está autorizado no provedor.

Se ainda não criou o canal, comece por [Como configurar um canal de e-mail](1715708241-como-configurar-um-canal-de-e_mail).

## Abrir a configuração SMTP

1. Vá para **Configurações → Caixas de Entrada**.
2. Abra a caixa de entrada de e-mail que será configurada.
3. Na aba **Configuração**, localize a seção **SMTP**.
4. Marque **Ativar a configuração SMTP para esta caixa de entrada**.
5. Preencha os campos do provedor e clique em **Atualizar configurações de SMTP**.

## Usar Gmail ou Google Workspace

O Google exige uma **senha de app** para este tipo de conexão. A conta precisa ter a verificação em duas etapas ativada; a senha normal da conta não deve ser usada. Consulte também a [orientação oficial do Google sobre senhas de app](https://support.google.com/accounts/answer/185833?hl=pt-BR).

Preencha:

| Campo no Chatwoot | Valor para Google |
| --- | --- |
| **Endereço** | `smtp.gmail.com` |
| **Porta** | `587` |
| **Entrar** | seu endereço de e-mail completo |
| **Senha** | a senha de app de 16 caracteres |
| **Domínio** | o domínio depois de `@` — por exemplo, `gmail.com` ou `suaempresa.com.br` |
| **Criptografia** | `STARTTLS` |
| **Autenticação** | `login` |

Para gerar a senha de app:

1. Abra a área **Segurança** da sua Conta Google.
2. Ative a **Verificação em duas etapas**, se ainda estiver desligada.
3. Abra **Senhas de app**, crie uma senha para o Chatwoot e copie o código exibido.
4. Cole esse código no campo **Senha** da configuração SMTP.

> O Google mostra cada senha de app apenas no momento da criação. Se você perdê-la ou revogá-la, gere outra.

## Usar SendGrid

Antes de conectar, autentique seu domínio de envio no SendGrid e crie uma chave de API com a permissão necessária para enviar e-mails. Crie e gerencie as chaves na [área API Keys do painel do SendGrid](https://app.sendgrid.com/settings/api_keys).

Preencha:

| Campo no Chatwoot | Valor para SendGrid |
| --- | --- |
| **Endereço** | `smtp.sendgrid.net` |
| **Porta** | `587` |
| **Entrar** | `apikey` — exatamente essa palavra |
| **Senha** | sua chave de API do SendGrid |
| **Domínio** | o domínio de envio autenticado no SendGrid |
| **Criptografia** | `STARTTLS` |
| **Autenticação** | `login` |

Não envie a chave de API por mensagem nem a reutilize em outros sistemas. Se houver suspeita de exposição, revogue-a no SendGrid e crie outra.

## Testar o envio

1. Salve a configuração SMTP.
2. Abra uma conversa da mesma caixa de entrada de e-mail.
3. Envie uma resposta para um endereço que você consiga consultar.
4. Confirme o recebimento e verifique se o remetente e o domínio estão corretos.

Se o teste falhar, confira:

- **Autenticação:** usuário e senha de app ou chave de API corretos.
- **Conexão:** endereço `smtp.gmail.com` ou `smtp.sendgrid.net`, porta `587` e `STARTTLS`.
- **Remetente:** endereço e domínio autorizados pelo provedor.
- **Google:** verificação em duas etapas ativa e senha de app ainda válida.
- **SendGrid:** domínio autenticado e chave com permissão de envio.

Depois de corrigir os dados, salve novamente e repita o teste na conversa.