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.