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.
- No painel, vá em Domínios e adicione um domínio que você controla
(ex.:
acme.dev). - Adicione os registros DNS exibidos — um registro TXT de DKIM e os registros de MAIL FROM — no seu provedor de DNS.
- 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 comodelivered, com os webhooksemail.senteemail.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@esuppressionlist@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.testou.invalid, não recebem e-mail, então um envio para um deles é recusado com422(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.