Publiq

Enviar de um formulário com Server Actions

Use Server Actions do Next.js para enviar e-mails direto de um formulário, sem criar uma rota de API.

A action "use server" executa no servidor quando o formulário é submetido:

'use server';
import { Publiq } from 'publiq';

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

export async function subscribe(formData: FormData) {
  await publiq.emails.send({
    from: 'you@yourdomain.com',
    to: String(formData.get('email')),
    templateKey: 'welcome-email',
  });
}

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

Enviar de um formulário com Server Actions — Publiq Docs