Envie seu primeiro e-mail

Crie uma chave, verifique um domínio e envie uma mensagem. A maioria das equipes começa a enviar em uma hora; a única etapa lenta é esperar o DNS.

Antes de começar

Você precisa de uma conta MigoSMTP e de um domínio sob seu controle, como example.com. Enviar de um subdomínio como mail.example.com mantém seus e-mails de marketing e de produto separados do domínio principal, e é um bom padrão.

1. Crie uma chave de API

No painel, abra Chaves de API e crie uma chave com permissão de envio. Dê a cada aplicação sua própria chave para poder revogar uma sem afetar as outras. Guarde-a como segredo, nunca no controle de versão.

export MIGOSMTP_KEY="YOUR_API_KEY"

2. Verifique um domínio

Adicione seu domínio de envio no painel e publique os registros DNS exibidos: SPF, DKIM e, o recomendado, uma política DMARC. As alterações de DNS podem demorar a se propagar, então aguarde o status do domínio indicar Verificado antes de enviar.

3. Envie uma mensagem

Chame o endpoint de envio com um endereço From do seu domínio verificado. Troque os endereços de exemplo pelos seus.

curl -X POST https://api.migosmtp.com/v1/send \
  -H "Authorization: Bearer $MIGOSMTP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@example.com","to":"you@example.com","subject":"Hello","text":"It works."}'

4. Confira o resultado

A resposta inclui um ID de mensagem. Use-o para consultar a mensagem e seus eventos no painel, ou receba-os no seu próprio sistema por webhooks.

Prefere SMTP?

Se sua aplicação já fala SMTP, basta apontá-la para o host SMTP exibido no painel. Não é preciso alterar código além das configurações de conexão. Veja o guia de integração SMTP.

Antes de entrar em produção

Confira antes: envie de um domínio verificado, publique um registro DMARC, trate respostas 429 com backoff, assine os webhooks de bounce e reclamação para parar de enviar a endereços que falham e mantenha as chaves de API fora do seu repositório.

Próximos passos

Leia a referência da API com todos os endpoints, configure webhooks para eventos de entrega e revise os códigos de erro e limites de taxa para que sua integração lide bem com falhas.