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.
Abrir a configuração SMTP
- Vá para Configurações → Caixas de Entrada.
- Abra a caixa de entrada de e-mail que será configurada.
- Na aba Configuração, localize a seção SMTP.
- Marque Ativar a configuração SMTP para esta caixa de entrada.
- 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.
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:
- Abra a área Segurança da sua Conta Google.
- Ative a Verificação em duas etapas, se ainda estiver desligada.
- Abra Senhas de app, crie uma senha para o Chatwoot e copie o código exibido.
- 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.
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
- Salve a configuração SMTP.
- Abra uma conversa da mesma caixa de entrada de e-mail.
- Envie uma resposta para um endereço que você consiga consultar.
- 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.comousmtp.sendgrid.net, porta587eSTARTTLS. - 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.