Pular para o conteúdo
couryo

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.

Ver em Markdown

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#

  1. No Couryo, verifique o domínio da empresa (por exemplo, exemplo.com.br).
  2. 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