Recaudo Docs

Marketing

Páginas de destino

Crie, edite e publique páginas de destino a partir do seu sistema ou de um agente. É o mesmo motor do editor visual: o que você faz pela API aparece igual no editor e vice-versa.

GET /v1/landing-pages Lista as páginas (filtre com status=draft, published ou unpublished).
GET /v1/landing-pages/templates Modelos disponíveis para criar uma página.
GET /v1/landing-pages/{id} Uma página com o documento completo (include_document=false para omiti-lo).
POST /v1/landing-pages Cria uma página a partir de um modelo, escrita pela IA ou com seu próprio documento.
PATCH /v1/landing-pages/{id} Altera título, endereço, configurações ou o rascunho inteiro.
POST /v1/landing-pages/{id}/publish Publica o rascunho atual.
POST /v1/landing-pages/{id}/unpublish Tira a página do ar; o rascunho é mantido.
GET /v1/landing-pages/{id}/analytics Visitas, contatos, cliques no WhatsApp, pagamentos e origens (days=7, 30 ou 90).
DELETE /v1/landing-pages/{id} Exclui a página e a tira do ar.

Criar uma página

Envie um de três: template, ai_description ou document. Sem nenhum, é criada uma página em branco com as cores e a fonte da sua marca.

Campo Descrição
title Nome interno da página. Também é o título da aba se você não definir um em SEO.
slug Parte final do endereço (promo-verao). Se já existir, um número é adicionado.
template Chave de um modelo de /v1/landing-pages/templates.
ai_description O que a página deve conseguir. A IA escolhe as seções e escreve os textos com os dados reais do seu negócio (produtos, horários, WhatsApp). Requer uma chave de IA conectada ou o teste gratuito.
document Documento JSON do editor (seções, elementos, tema e SEO), como retornado pelo GET.
locale es, en ou pt_BR. Por padrão, o idioma da sua conta.
publish true para publicá-la ao criar.
Requisição
curl -X POST "https://recaudo.app/api/v1/landing-pages" \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Promo limpieza dental",
    "ai_description": "Limpieza dental a $499 en Monterrey, agenda por WhatsApp",
    "publish": true
  }'
Resposta
{
  "object": "landing_page",
  "data": {
    "id": "8f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
    "object": "landing_page",
    "title": "Promo limpieza dental",
    "slug": "promo-limpieza-dental",
    "status": "published",
    "locale": "es",
    "template": "ai",
    "url": "https://tu-negocio.recaudo.app/p/promo-limpieza-dental",
    "is_home": true,
    "revision": 1,
    "has_unpublished_changes": false,
    "settings": {},
    "published_at": "2026-11-20T18:30:02+00:00",
    "document": { "version": 1, "locale": "es", "theme": { … }, "meta": { … }, "sections": [ … ] }
  }
}

Formulário usando um dos seus formulários

O elemento form pode usar seus próprios campos (source=page, o formulário rápido) ou um dos seus formulários do módulo Formulários (source=lead_form). Com lead_form a página mostra os campos desse formulário com o design da página e salva cada resposta nele.

Campo Descrição
props.source page (padrão) ou lead_form.
props.lead_form_id UUID de um formulário publicado da sua conta. Se não for da sua conta, POST e PATCH respondem 422 com code lead_form_not_found.
Requisição
{
  "id": "e4k2m9q7xa",
  "type": "form",
  "props": {
    "source": "lead_form",
    "lead_form_id": "3b6f0c1e-9d2a-4e5b-8c7d-1a2b3c4d5e6f",
    "submit_label": "Quiero mi cotización",
    "success_message": "¡Gracias! Te escribimos hoy mismo."
  },
  "items": [],
  "layout": { … },
  "style": { … }
}
  • Roda o mesmo que um envio na página do formulário: cria ou atualiza o cliente, aplica suas listas e etiquetas, registra o aceite dos termos, chama seu webhook e dispara "Formulário enviado" (form.submitted) com landing_page_id e UTM.
  • A página mantém sua contagem de contatos e a atribuição (UTM, fbclid, gclid) e envia um único evento Lead para a Meta com o mesmo event_id do pixel.
  • Os campos chegam como f[field_0], f[field_1]… na ordem do formulário; se pedir termos, também f[accept_terms]=1.
  • Se você despublicar o formulário, a página mostra um aviso e o envio responde 422 com uma mensagem clara.
  • Documento: é JSON, nunca HTML. Cada elemento tem type, props, style por dispositivo (desktop, tablet, mobile) e layout em colunas da grade. O mais fácil é lê-lo com GET, mudar o que precisa e enviá-lo inteiro com PATCH.
  • Revisões: cada PATCH com document aumenta revision. Se você enviar revision e alguém salvou depois (no editor ou pela API), responde 409 e não sobrescreve as alterações.
  • Segurança: o texto formatado passa por uma lista de tags permitidas, links só aceitam http, https, mailto e tel, e scripts são removidos. Campos desconhecidos são ignorados.
  • Limites do plano: publicar mais páginas do que o plano permite responde 403 com code limit_pages.
  • Erros de IA: ai_unavailable (nenhuma chave de IA conectada), ai_limit (o teste gratuito acabou) e ai_failed (a IA não respondeu bem; tente de novo).
  • Contatos: cada formulário enviado cria ou atualiza o cliente, dispara o evento lead.created para seus webhooks e o gatilho "Formulário de página de destino enviado" das suas automações, com UTM, fbclid e gclid.
  • MCP: as mesmas ações estão disponíveis como ferramentas (create_landing_page, publish_landing_page, get_landing_page_analytics…).
Esta página ajudou? Obrigado por avisar.
Esc