Newsletter Capture

Cookbook — captura de leads com useCaptureLead e storefront.leads.capture.

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

Referência: seu tema (adaptado do cookbook)

Índice: Cookbooks

---

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: '[e-mail]',
  optedIn: true,
});

O hook injeta automaticamente pageUrl, referrer e UTMs via getLeadTrackingContext().

Campo	Obrigatório
email	✅
optedIn	Recomendado para marketing
fields	Opcional (name, phone, …)
source	Default do hook. O exemplo usa newsletter_footer

---

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

Setting	Uso
title, description	Cabeçalho
emailPlaceholder, buttonLabel	Formulário
successText	Após cadastro
optInLabel	Texto do consentimento

enabledOn: ['index', 'page', 'collection']

---

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)