Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Início rápido

Envie seu primeiro e-mail em poucos minutos.

1. Cadastre-se

Crie uma conta em billionsend.com. O painel fica lá; a API fica em https://api.billionsend.com.

2. Verifique um domínio

Você só pode enviar de domínios que verificou.

  1. Abra Domínios e adicione um domínio seu, por exemplo acme.dev.
  2. Adicione no seu provedor de DNS os registros mostrados (DKIM e MAIL FROM).
  3. Clique em Verificar domínio. A página mostra quais registros ainda faltam.

Veja Domínios.

3. Crie uma chave de API

Abra Chaves de API e crie uma. A chave bs_ aparece uma única vez, então copie. Uma chave pode ter acesso total ou apenas de envio, e pode ser limitada a um domínio.

4. Envie um e-mail

Com curl:

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

Ou com o SDK para Node.js (npm install @billionsend/node):

import { BillionSend } from "@billionsend/node";

const bs = new BillionSend("bs_..."); // or new BillionSend() with BILLIONSEND_API_KEY set

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

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

Ambos retornam { "id": "..." }. Veja o e-mail passar de queued para delivered na página E-mails. Outras linguagens: veja SDKs.

Testes

  • success@simulator.amazonses.com simula uma entrega sem enviar e-mail a ninguém. Acrescente um rótulo para variar: success+signup@simulator.amazonses.com.
  • E-mails para o simulador também contam na cota do seu plano.
  • bounce@, complaint@ e suppressionlist@ no simulador geram rejeições e reclamações reais: o endereço entra na sua lista de supressão e conta nas suas taxas de rejeição e de reclamação. Use-os à mão, não em testes automatizados. Cada endereço funciona uma vez, então acrescente um rótulo para um novo: bounce+2@simulator.amazonses.com.
  • Endereços em example.com, ou terminados em .test ou .invalid, não recebem e-mail. Um envio para um deles é recusado com 422 (veja o Básico da API).

Próximos passos

Esta página foi útil?