Saltar al contenido
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Inicio rápido

Crea una cuenta, verifica un dominio, genera una clave de API y envía tu primer email con curl o el SDK de Node.js; prueba con el simulador de SES.

1. Regístrate

Crea una cuenta en billionsend.com. El panel está allí; la API está en https://api.billionsend.com.

2. Verifica un dominio

Solo puedes enviar desde dominios que hayas verificado.

  1. Abre Dominios y añade un dominio tuyo, por ejemplo acme.dev.
  2. Añade en tu proveedor de DNS los registros que se muestran (DKIM y MAIL FROM).
  3. Haz clic en Verificar dominio. La página muestra qué registros faltan todavía.

Consulta Dominios.

3. Crea una clave de API

Abre Claves de API y crea una. La clave bs_ se muestra una sola vez, así que cópiala. Una clave puede tener acceso completo o solo de envío, y puede limitarse a un dominio.

4. Envía un email

Con 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>"
  }'

O con el SDK de Node.js (npm install @billionsend/node):

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

const bs = new BillionSend("bs_..."); // o new BillionSend() con BILLIONSEND_API_KEY definida

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 devuelven { "id": "..." }. Mira cómo el email pasa de queued a delivered en la página Emails. Otros lenguajes: consulta SDKs.

Pruebas

  • success@simulator.amazonses.com simula una entrega sin enviar email a nadie. Añade una etiqueta para variar: success+signup@simulator.amazonses.com.
  • Los emails al simulador también cuentan en la cuota de tu plan.
  • bounce@, complaint@ y suppressionlist@ en el simulador generan rebotes y quejas reales: la dirección entra en tu lista de supresión y el evento activa tus webhooks, pero la respuesta del simulador nunca cuenta en tus tasas de rebote y de quejas. Úsalos a mano, no en pruebas automatizadas. Cada dirección funciona una sola vez, así que añade una etiqueta para obtener una nueva: bounce+2@simulator.amazonses.com.
  • Las direcciones en example.com, o que terminan en .test o .invalid, no pueden recibir correo. Un envío a una de ellas se rechaza con 422 (consulta los Conceptos básicos de la API).

Siguientes pasos

¿Te ha resultado útil esta página?