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 templateKey sobre 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.

Ver también

Cómo enviar correos con Cloudflare Workers — Publiq Docs