Conecte uma caixa de email ao Codewo via IMAP (pra receber) + SMTP (pra enviar). Funciona com Gmail, Outlook/Office 365, ou servidor próprio. Threading e anexos vêm sem você precisar configurar.
Como funciona
O Codewo se conecta à sua caixa de email como um cliente — exatamente como Thunderbird ou o app Mail do Mac fariam — usando IMAP pra ler mensagens novas e SMTP pra enviar respostas. Não é integração proprietária; é o padrão de email que existe há décadas, então funciona com praticamente qualquer provedor.
Cada email recebido vira uma conversa no Inbox. Respostas dentro do thread são agrupadas. Anexos são puxados e salvos.
Antes de começar — credenciais
Você vai precisar de:
- Host IMAP (ex:
imap.gmail.com,outlook.office365.com) - Porta IMAP (geralmente 993 com SSL)
- Host SMTP (ex:
smtp.gmail.com,smtp.office365.com) - Porta SMTP (geralmente 587 com TLS ou 465 com SSL)
- Email e senha da caixa
Gmail / Google Workspace
Gmail bloqueia "apps menos seguros" desde 2022. Você precisa de uma senha de app:
- Ative 2FA na conta Google.
- Vá em myaccount.google.com → Segurança → Senhas de app.
- Crie uma senha de app específica pro Codewo.
- Use essa senha (16 caracteres) no Codewo, não a senha normal da conta.
Outlook / Office 365
Mesmo princípio. Crie uma "senha de aplicativo" no painel da Microsoft se a conta tiver 2FA.
Servidor próprio (cPanel, Plesk, etc.)
As credenciais são as mesmas que você usaria em qualquer cliente de email. Veja no painel do servidor.
Passo a passo
Em Configurações → Canais → Novo canal → Email:
Aba IMAP (receber)
- Host —
imap.gmail.com, etc. - Porta — 993 (default).
- Criptografia — SSL.
- Usuário — Seu email completo.
- Senha — Senha de app (Gmail/Outlook) ou senha normal (servidor próprio).
- Clique em "Listar pastas" — Codewo conecta, valida credencial e mostra as pastas da caixa.
- Escolha quais pastas monitorar — Geralmente só INBOX. Algumas operações monitoram também "Suporte" ou pastas específicas.
Aba SMTP (enviar)
- Host —
smtp.gmail.com, etc. - Porta — 587 (TLS) ou 465 (SSL).
- Criptografia — TLS ou SSL conforme a porta.
- Usuário e senha — Mesmas credenciais (geralmente).
- From Name — Nome que aparece no remetente (ex: "Suporte Empresa").
- From Address — Email que aparece no remetente. Pode ser o mesmo da caixa ou um alias.
- Clique em "Testar conexão SMTP" — Codewo manda email de teste pra si mesmo. Se chegar, está OK.
Salvar
Quando ambos IMAP e SMTP estiverem testados, salve o canal. Codewo começa a buscar emails novos imediatamente (intervalo curto de polling).
Pegadinhas comuns
- "Authentication failed" no IMAP — 99% das vezes é senha de app. Gmail e Outlook não aceitam mais senha normal pra apps externos com 2FA ativo.
- Codewo cria conversas duplicadas pro mesmo email. Acontece se o servidor retornar o mesmo Message-ID em emails diferentes (raro mas existe). O Codewo tem proteção interna, mas se você ver duplicatas, abra suporte.
- Lista grande de pastas trava a UI. Caixas com 50+ pastas demoram pra carregar a listagem. Pode parecer travado — espere 30 segundos.
- Credenciais ficam armazenadas em texto. Por design técnico atual, senhas IMAP/SMTP ficam acessíveis ao admin com acesso ao banco. Se isso é problema, considere um relay de email dedicado ou aplicação intermediária.
- Polling não é instantâneo. Codewo busca emails novos em intervalos curtos (segundos a minutos). Pra email em tempo real, considere usar webhook do provedor (se houver) ou aguarde o polling.
- Email enviado pelo Codewo aparece na pasta "Enviados" da caixa. Isso é o SMTP padrão — não há como evitar sem configuração especial. Útil pra histórico fora do Codewo.
- Anexos pesados. Anexos muito grandes (>25MB no Gmail) podem ser bloqueados pelo provedor antes de chegar ao Codewo.
Boas práticas
- Use email dedicado — Não conecte o email pessoal do CEO. Crie
suporte@empresa.com.brou similar. - Configure From Name — "Suporte Empresa" em vez de só "suporte@empresa.com.br" passa profissional.
- Use uma pasta só — Monitorar várias pastas complica polling e pode duplicar conversas. INBOX basta na maioria dos casos.
- Combine com filtros do provedor — Spam, listas de discussão e newsletters podem ser filtrados antes pelo Gmail/Outlook, evitando lixo no Inbox.
- Faça backup de senhas de app — Se você perder a senha de app criada, precisa criar outra (não tem como recuperar a antiga). Salve em gerenciador de senhas.