Leads

Los leads son prospectos de venta que pueden convertirse en contactos.

Listar leads

GET /admin/crm/leads

Parámetros:

Nombre	Tipo	Descripción
status	string	Estado del lead
q	string	Búsqueda
owner	uuid	Responsable
tag	string	Tag
source	string	Origen
score_min	int	Score mínimo
sort	string	recent, oldest, score_high

---

Crear lead

POST /admin/crm/leads

Campo	Requerido	Tipo	Descripción
email	sí	string	Email
first_name	sí	string	Nombre
last_name	no	string	Apellido
doc_type	no	string	DNI, RUC
doc_number	no	string	Número de documento
phone	no	string	Teléfono
company	no	string	Empresa
title	no	string	Cargo
city	no	string	Ciudad
country	no	string	País
source	no	string	Origen del lead
owner_id	no	uuid	Responsable
tags	no	[]string	Tags

---

Detalle de lead

GET /admin/crm/leads/:id

---

Eliminar lead

DELETE /admin/crm/leads/:id

---

Importar leads desde CSV

POST /admin/crm/leads/import

Sube un archivo CSV. Descarga la plantilla con:

GET /admin/crm/leads/import/template.csv

---

Captura pública de leads

Endpoint público para capturar leads desde formularios externos.

POST /leads/capture/:tid

Headers:

Header	Requerido	Descripción
X-Api-Key	sí	API key generada en configuración
Content-Type	sí	application/json o application/x-www-form-urlencoded

Body:

{
  "email": "[email protected]",
  "first_name": "María",
  "last_name": "García",
  "doc_type": "DNI",
  "doc_number": "12345678",
  "phone": "+51987654321",
  "company": "Empresa SAC",
  "title": "Gerente",
  "source": "landing-page"
}

Configuración (Admin):

• GET /admin/crm/leads/capture — Ver configuración de captura
• POST /admin/crm/leads/capture/regenerate — Regenerar API key
• POST /admin/crm/leads/capture/origins — Guardar orígenes CORS permitidos