Cómo enviar correos con Cloudflare Workers
Envía correos desde un Cloudflare Worker con el SDK de Publiq, leyendo la API key de los secrets del Worker.
Define el secret con wrangler secret put PUBLIQ_API_KEY y léelo de env:
import { Publiq } from 'publiq';
export default {
async fetch(req: Request, env: { PUBLIQ_API_KEY: string }) {
const publiq = new Publiq(env.PUBLIQ_API_KEY);
await publiq.emails.send({
from: 'you@yourdomain.com',
to: 'user@example.com',
templateKey: 'welcome-email',
});
return new Response('sent');
},
};Buenas prácticas
- Llama a Publiq siempre desde el servidor — nunca expongas la API key en el cliente.
- Crea la instancia del cliente una vez y reutilízala entre peticiones.
- Prefiere
templateKeysobre HTML inline para mantener el contenido versionado. - Maneja
PubliqError(status/code); el SDK ya reintenta errores transitorios con backoff. - Envía desde un dominio verificado — ver Dominios.