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

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 é:

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#

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.
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.
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.
DMARC: se já existe um, mantenha e acrescente mailto:reports@dmarc.couryo.com ao rua para receber os relatórios no agente de entregabilidade; se não existe, publique o sugerido pelo Couryo (começa em p=none).
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).
Boleto e nota fiscal: mande por link, não como anexo. Anexo de boleto é um padrão de golpe que os filtros conhecem.

Migrar do SMTP da Locaweb

Pelo SMTP (sem mudar o código)#

Pela API REST#

DNS: cuidado com as caixas de e-mail#

Bom saber#