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
templateKeya 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.