​

Newsletter Capture

Quero um formulário de newsletter / lead capture na vitrine. Como implementar?

​

Contratos utilizados

• leads.capture
• @corvex/theme-sdk — useCaptureLead

​

API pública

import { useCaptureLead } from '@corvex/theme-sdk';

const { capture, status, error, isNew, reset } = useCaptureLead('newsletter_footer');

await capture({
  email: 'maria@example.com',
  optedIn: true,
});

​

UX recomendada

1. Campo e-mail + checkbox de consentimento (optedIn)
2. Estados: idle → loading → success / error
3. Mensagem de sucesso após status === 'success'
4. Desabilitar submit durante loading

​

Escopo

• Section na vitrine (rodapé, home, landing)
• O cliente não impõe cota por minuto. Se a API responde 429, o erro tem code: 'RATE_LIMIT_EXCEEDED'

​

Settings do cookbook

​

Checklist

• useCaptureLead(source) com source estável
• optedIn: true quando usuário consente
• Tratar error e status
• corvex validate .

​

Veja também

• Header — outro ponto de captura no layout
• Lead resource (se documentado)