GET
/api/mod/marca/{espacio}/personaCómo queda descrito tu agente
La descripción que Ventas lee antes de contestar, armada con tu identidad y tu estilo, y las tácticas que aplica después. Sirve para ver cómo queda la marca antes de que hable con nadie.
- 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 Marca. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| activo | boolean | El interruptor general de la marca. |
| persona | string | La descripción del agente, en prosa: quién es, su tono, sus rasgos, su largo y sus emojis. Termina siempre con unas reglas fijas que no se pueden quitar (ver la guía). |
| digest | string | Una huella de la configuración (64 caracteres): cambia en cuanto cambia cualquier dato. |
| upsell | { activo, combos, argumento, plantilla } | Las tácticas de combo, como en tacticas.upsell_*. |
| pregunta_cierre | { obligatoria, pool } | La pregunta de cierre: pregunta_cierre_obligatoria y preguntas_cierre. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Marca | módulo no habilitado para este espacio. |
| 502 | El módulo no está disponible en este momento: reintenta en unos minutos | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Las tácticas no van en
persona: Ventas las añade después de redactar, para no ofrecer dos veces el mismo combo ni hacer dos preguntas seguidas. - Para saber si algo cambió sin comparar el texto entero, guarda el
digesty compáralo.