MillionSend Docs

Início rápido

Obtenha o MillionSend e envie seu primeiro e-mail em poucos minutos.

O MillionSend funciona igual no MillionSend Cloud e na sua própria infraestrutura — mesmo painel, mesma API, mesmos SDKs. Escolha sua implantação abaixo; as abas lembram sua escolha em toda a documentação.

1. Obtenha o MillionSend

Cadastre-se em millionsend.com. Só isso — sem infraestrutura, sem conta AWS. O painel fica em millionsend.com e a API em api.millionsend.com.

2. Verifique um domínio de envio

O MillionSend só envia a partir de domínios que você verificou.

  1. No painel, vá em Domínios e adicione um domínio que você controla (ex.: acme.dev).
  2. Adicione os registros DNS exibidos — um registro TXT de DKIM e os registros de MAIL FROM — no seu provedor de DNS.
  3. Clique em Checar DNS. O MillionSend também resolve os registros ao vivo, então você vê na hora quais ainda faltam.

3. Crie uma chave de API

Vá em Chaves de API e crie uma. O token ms_ é exibido uma única vez — copie agora. Chaves podem ter acesso total ou somente envio, e opcionalmente ficar restritas a um único domínio.

4. Envie um e-mail

Sua URL base da API:

https://api.millionsend.com

Com curl:

curl -X POST https://api.millionsend.com/emails \
  -H "Authorization: Bearer ms_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <onboarding@acme.dev>",
    "to": ["success@simulator.amazonses.com"],
    "subject": "Hello from MillionSend",
    "html": "<strong>It works!</strong>"
  }'

Ou com o SDK de Node (npm install millionsend):

import { MillionSend } from "millionsend";

const ms = new MillionSend("ms_...", { baseUrl: "https://api.millionsend.com" });

const { data, error } = await ms.emails.send({
  from: "Acme <onboarding@acme.dev>",
  to: "success@simulator.amazonses.com",
  subject: "Hello from MillionSend",
  html: "<strong>It works!</strong>",
});

if (error) console.error(error.name, error.message);
else console.log("sent", data.id);

Ambos retornam { "id": "..." }. Acompanhe o e-mail indo de queued a delivered na página E-mails.

Em uma instância auto-hospedada, eventos de entrega (entregue, bounce, reclamação) exigem o pipeline de eventos do SES que o assistente de setup configura — veja Auto-hospedagem → Eventos do SES. Na Nuvem eles fluem automaticamente.

Já usa o Resend? Aponte o SDK oficial do Resend para o MillionSend — defina RESEND_BASE_URL com a sua URL base e use sua chave ms_. O formato da API é idêntico.

Testes

  • Para testar de ponta a ponta sem mandar e-mail para ninguém, envie para success@simulator.amazonses.com, como nos exemplos acima: o SES simula a entrega, e o e-mail aparece como delivered, com os webhooks email.sent e email.delivered (sem aberturas nem cliques: ninguém lê o e-mail). Endereços com + também funcionam: success+cadastro@simulator.amazonses.com.
  • O SES não conta os e-mails do simulador na própria cota de envio nem nas taxas de bounce e reclamação, mas na Nuvem cada envio ainda conta na cota do seu plano, como qualquer outro e-mail. Em uma instância auto-hospedada, o simulador funciona mesmo com a sua conta AWS ainda no sandbox do SES, e a AWS cobra cada mensagem normalmente.
  • Os endereços bounce@, complaint@ e suppressionlist@ do simulador geram bounces e reclamações que colocam o endereço na lista de supressão da sua equipe e disparam seus webhooks como os de verdade, mas nunca pesam na sua taxa de bounce ou de reclamação nem pausam seus envios. Cada endereço fica suprimido depois do primeiro uso; para repetir o teste, use um +: bounce+2@simulator.amazonses.com.
  • Endereços em example.com, ou terminados em .test ou .invalid, não recebem e-mail, então um envio para um deles é recusado com 422 (veja Erros).

Próximos passos

  • Conceitos para contatos, segmentos, tópicos e transmissões.
  • SDKs para as nove bibliotecas oficiais.
  • Referência da API para todos os endpoints.
  • Auto-hospedagem para implantação em produção, referência de ambiente e o relay SMTP.

Nesta página