Como enviar e-mails com Cloudflare Workers

Envie e-mails de um Cloudflare Worker com o SDK do Publiq, lendo a API key dos secrets do Worker.

Defina o secret com wrangler secret put PUBLIQ_API_KEY e leia 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');
  },
};

Boas práticas

  • Chame o Publiq sempre do servidor — nunca exponha a API key no cliente.
  • Crie a instância do cliente uma vez e reutilize-a entre requisições.
  • Prefira templateKey a HTML inline para manter o conteúdo versionado.
  • Trate PubliqError (status/code); o SDK já retenta erros temporários com backoff.
  • Envie de um domínio verificado — veja Domínios.

Veja também

Como enviar e-mails com Cloudflare Workers — Publiq Docs