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.
- Abre Dominios y añade un dominio tuyo, por ejemplo
acme.dev. - Añade en tu proveedor de DNS los registros que se muestran (DKIM y MAIL FROM).
- 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.comsimula 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@ysuppressionlist@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.testo.invalid, no pueden recibir correo. Un envío a una de ellas se rechaza con422(consulta los Conceptos básicos de la API).
Siguientes pasos
- Emails, Contactos y Envíos masivos.
- SDKs para tu lenguaje.
- Referencia de la API con todos los endpoints.