Guia do desenvolvedorIntegrações
Odoo: servidor de e-mail de saída
Configure o servidor de e-mail de saída do Odoo com o SMTP do Couryo para faturas, cotações e avisos chegarem na caixa de entrada, com o remetente certo e o filtro FROM.
Quando as faturas do Odoo caem no spam, quase sempre é uma destas duas coisas: o Odoo envia por um servidor que não está autorizado a falar pelo seu domínio, ou envia "como" o vendedor (fulano@gmail.com) por um servidor que não é do Gmail. Os dois quebram o SPF, o DKIM e o DMARC. Este guia resolve os dois.
Antes de começar#
- No Couryo, verifique o domínio da empresa (por exemplo,
exemplo.com.br). - Crie uma chave de API com escopo
send. Ela é a senha do SMTP.
1. Crie o servidor de saída#
No Odoo, ative o modo de desenvolvedor (Configurações > Ativar o modo de desenvolvedor). Depois:
- Odoo 15 ou mais novo: em Configurações > Configurações gerais, na seção de e-mail, marque Usar servidores de e-mail personalizados (no Odoo Online, essa opção libera o servidor próprio) e clique em Servidores de e-mail de saída.
- Qualquer versão: Configurações > Técnico > E-mail > Servidores de e-mail de saída.
Crie um servidor com:
| Campo | Valor |
|---|---|
| Nome | Couryo |
| Filtro FROM | exemplo.com.br (o domínio verificado) |
| Servidor SMTP | smtp.couryo.com |
| Porta SMTP | 587 |
| Segurança da conexão | TLS (STARTTLS) (ou SSL/TLS com a porta 465) |
| Autenticar com | Nome de usuário |
| Nome de usuário | couryo |
| Senha | a chave de API (ck_live_...) |
| Prioridade | menor que a dos outros servidores, para ser o escolhido |
Clique em Testar conexão. "Conexão bem-sucedida" quer dizer que o login passou.
2. Acerte o remetente#
O Odoo usa o e-mail de quem criou o documento como remetente. Se o vendedor tem fulano@gmail.com no cadastro, a fatura sai "de" um endereço do Gmail, por um servidor que não é do Gmail: o DMARC do Gmail manda recusar ou jogar no spam.
Com o Filtro FROM preenchido, o Odoo só usa este servidor para remetentes do seu domínio e reescreve os outros para um endereço seu, mantendo o nome da pessoa. Para isso, em Configurações > Técnico > Parâmetros > Parâmetros do sistema, confira:
| Chave | Valor |
|---|---|
mail.catchall.domain |
exemplo.com.br |
mail.default.from |
notificacoes (vira notificacoes@exemplo.com.br) |
Resultado: a fatura sai como "Fulano notificacoes@exemplo.com.br", assinada com o DKIM do seu domínio. As respostas continuam voltando para o Odoo pelo endereço de catchall, se você usa um servidor de entrada.
O melhor ainda é cadastrar os usuários com o e-mail da empresa (fulano@exemplo.com.br).
3. Mande uma fatura de teste#
Abra uma fatura de teste e use Enviar e imprimir para o seu próprio e-mail. No painel do Couryo, em E-mails, a mensagem aparece com a linha do tempo e a resposta do servidor de destino. Se ela foi recusada, a explicação diz por quê.
Faturas, boletos e anexos#
- O modelo de fatura do Odoo já traz o botão para ver o documento no portal. Quando a pessoa não precisa do PDF no e-mail, o link sozinho é mais leve e tem menos chance de cair em filtro.
- Boleto como anexo é o pior caso: boletos falsos em anexo são um golpe comum, e os filtros desconfiam. Mande o boleto por link.
- Evite assuntos só com "Cobrança" ou "Fatura": "Fatura 2026/0042 da Exemplo, vencimento 10/11" é mais claro para a pessoa e para o filtro.
Problemas comuns#
| Sintoma | O que fazer |
|---|---|
Teste de conexão falha com 535 |
usuário diferente de couryo ou chave inválida, revogada ou sem escopo send |
550 5.7.1 na fila de e-mails do Odoo |
o remetente não está num domínio verificado: confira o Filtro FROM e o mail.default.from |
| O Odoo continua usando outro servidor | ajuste a Prioridade e o Filtro FROM; servidores sem filtro valem para qualquer remetente |
| E-mails parados em Técnico > E-mail > E-mails com status "Exceção" | abra a mensagem: o erro do SMTP aparece ali, com o código. Veja os códigos de erro SMTP |
| Entregue, mas no spam | veja Por que meu e-mail cai no spam |