# Migrar do SMTP da Locaweb

> Guia para sair do SMTP da Locaweb e ir para o Couryo. Troca das credenciais SMTP, mapeamento da API REST para POST /v1/emails, cuidado com o MX e o SPF de quem tem as caixas de e-mail na Locaweb e a ordem segura da troca.

Fonte: https://couryo.com/docs/migrate-locaweb

Quem envia pela Locaweb quase sempre usa o SMTP (servidor, usuário e senha no sistema) e, muitas vezes, mantém as caixas de e-mail da empresa na própria Locaweb. A migração para o Couryo troca **só o envio**: as caixas continuam onde estão. Siga a [ordem segura da migração](https://couryo.com/docs/migration.md) e use este guia para os detalhes.

## Pelo SMTP (sem mudar o código)

Troque as credenciais no seu sistema (ERP, loja, WordPress, Laravel, PHPMailer):

| Campo | Antes (SMTP da Locaweb) | Depois (Couryo) |
|---|---|---|
| Servidor | o servidor SMTP do seu plano | `smtp.couryo.com` |
| Porta | a do seu plano | `587` (STARTTLS), `465` (TLS direto) ou `2525` |
| Usuário | o usuário do SMTP | `couryo` |
| Senha | a senha do SMTP | a chave de API do Couryo (`ck_live_...`) |
| Remetente | um endereço autorizado | um endereço num [domínio verificado](https://couryo.com/docs/domains.md) no Couryo |

Cada mensagem recebe um id (`250 2.0.0 Ok: queued as msg_...`) e aparece em **E-mails** com a linha do tempo, a resposta do servidor de destino e a explicação em linguagem simples. Tags e o fluxo de marketing vão por cabeçalho (`X-Couryo-Tags`, `X-Couryo-Stream`), veja [SMTP](https://couryo.com/docs/smtp.md#opcoes-por-cabecalho).

## Pela API REST

Se você chama a API do SMTP da Locaweb (JSON com assunto, corpo, remetente e destinatário e o token num cabeçalho), a chamada equivalente no Couryo é:

```bash title="Couryo: POST https://api.couryo.com/v1/emails"
curl https://api.couryo.com/v1/emails \
  -H "Authorization: Bearer $COURYO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1042-confirmacao" \
  -d '{
    "from": "Loja <pedidos@exemplo.com.br>",
    "to": "ana@exemplo.com.br",
    "subject": "Pedido 1042 confirmado",
    "html": "<p>Obrigado, Ana!</p>",
    "text": "Obrigado, Ana!"
  }'
```

| Locaweb | Couryo | Observação |
|---|---|---|
| `subject` | `subject` | |
| `body` (com o tipo em `headers`) | `html` e `text` | mande as duas partes: a parte em texto ajuda a entrega |
| `from` | `from` | `"Nome <email>"`, num domínio verificado |
| `to`, `cc`, `bcc` | `to`, `cc`, `bcc` | texto ou lista, até 50 destinatários |
| `headers` | `headers` | cabeçalhos da plataforma são ignorados |
| token no cabeçalho | `Authorization: Bearer ck_live_...` | chave por projeto, com escopo e IPs permitidos |
| (sem equivalente) | `Idempotency-Key` | repetir a chamada não duplica o e-mail |
| (sem equivalente) | `tags`, `metadata`, `scheduled_at`, `template` | filtros, dados seus nos webhooks, agendamento e templates salvos |

## DNS: cuidado com as caixas de e-mail

1. **Não mexa no MX.** Se as caixas da empresa estão na Locaweb, o MX do domínio continua apontando para ela. O Couryo não usa o MX do domínio principal.
2. **Não mexa no SPF do domínio principal.** O `include:` da Locaweb continua lá enquanto as caixas enviarem por ela. O Couryo passa no SPF pelo subdomínio `bounces`, que aponta para ele por CNAME.
3. **Publique os registros do Couryo** no painel de DNS onde o domínio está (Locaweb, Registro.br ou Cloudflare): `couryo1._domainkey`, `couryo2._domainkey` e `bounces`, todos CNAME. A página do domínio no Couryo mostra o nome de cada registro como o seu painel espera.
4. **DMARC:** se já existe um, mantenha e acrescente `mailto:reports@dmarc.couryo.com` ao `rua` para receber os relatórios no [agente de entregabilidade](https://couryo.com/docs/deliverability.md); se não existe, publique o sugerido pelo Couryo (começa em `p=none`).
5. Espere o domínio ficar verificado e mova o envio aos poucos.

## Bom saber

- **Hotmail e Outlook** são a dor número 1 de quem envia no Brasil. A exigência da Microsoft para quem envia em volume (SPF, DKIM e DMARC, senão `550 5.7.515`) fica atendida com os registros do Couryo, e o agente de entregabilidade avisa quando algo falta.
- **UOL, BOL e Terra** aparecem separados nas estatísticas por provedor, para você ver onde a entrega está boa.
- Endereços que já devolviam ou reclamavam na Locaweb: cadastre como supressão antes do primeiro envio ([copiar as supressões](https://couryo.com/docs/migration.md#copiar-as-supressoes)).
- Boleto e nota fiscal: mande por link, não como anexo. Anexo de boleto é um padrão de golpe que os filtros conhecem.