# 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.

Fonte: https://couryo.com/docs/odoo

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](https://couryo.com/docs/domains.md) 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](https://couryo.com/guias/codigos-de-erro-smtp.md) |
| Entregue, mas no spam | veja [Por que meu e-mail cai no spam](https://couryo.com/guias/email-caindo-no-spam.md) |