Como enviar e-mails com Remix

No Remix, as `action`s rodam no servidor — o lugar certo para o Publiq. Envie ao submeter um formulário.

Instale o SDK (npm install publiq) e defina PUBLIQ_API_KEY no ambiente do servidor. O código abaixo roda no servidor — a API key nunca vai ao cliente.

import type { ActionFunctionArgs } from '@remix-run/node';
import { Publiq } from 'publiq';

const publiq = new Publiq(process.env.PUBLIQ_API_KEY);

export async function action({ request }: ActionFunctionArgs) {
  const form = await request.formData();
  await publiq.emails.send({
    from: 'you@yourdomain.com',
    to: String(form.get('email')),
    templateKey: 'welcome-email',
  });
  return { ok: true };
}

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.