GET
/api/mod/ventas/{espacio}/leads/{lead}Un lead
El lead con su estado, el producto que le interesó y cuántas cotizaciones recibió.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Ventas. |
| lead | string | SÍ | El id del lead (32 caracteres hexadecimales): sale en la lista de leads y en lead_id al conversar. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | El id del lead. |
| estado | "nuevo" | "contactado" | "ganado" | "cerrado" | Dónde está en tu embudo: ver leads. |
| producto_interes | string | null | Lo que quería comprar. |
| contacto_masked | string | null | Qué datos dejó, seudonimizados: nombre=<PERSON>; telefono=<PHONE>. El contacto nunca sale en claro. null si no dio consentimiento. |
| cotizaciones_emitidas | integer | Cuántas cotizaciones recibió. |
| consent · consent_ts | boolean · number | null | Si autorizó el seguimiento comercial, y cuándo (segundos desde 1970). |
| created_at · updated_at | number | Segundos desde 1970, con decimales. |
| tenant_id | string | El espacio. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Ventas | módulo no habilitado para este espacio. |
| 404 | No hay un lead con ese id en el espacio | Lead no encontrado: … |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.