GET/api/mod/ventas/{espacio}/leads-config

La configuración del agente

Todo lo que define cómo vende tu agente: su nombre, su saludo, sus instrucciones, con qué módulos se conecta y cada frase que dice. Si el espacio nunca la tocó, la crea con los valores por defecto.

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.

RESPUESTA 200

La configuración entera. Los campos que te sirven:

CAMPO	TIPO	QUÉ ES
name	string	El nombre de tu negocio. Sustituye `{name}` en el saludo y en las instrucciones. Por defecto, el id del espacio.
saludo	string	El primer mensaje de cada conversación. Admite `{name}`.
modo_venta	boolean	false: atiende y resuelve dudas. true: asesor de venta consultiva que propone siempre el siguiente paso. Por defecto false.
system_prompt	string	Las instrucciones del asistente cuando modo_venta es false.
system_prompt_venta	string	Las instrucciones cuando modo_venta es true.
aviso_privacidad	string	El aviso que acompaña al primer turno (aviso_privacidad en la respuesta).
moneda	string	Cómo se escriben las cifras en los mensajes. Por defecto "COP". No cambia el cálculo.
campos_captura	string[]	Los datos de contacto que pide al registrar un lead. Por defecto ["nombre", "telefono"].
cotiza_sin_contacto	boolean	Si cotiza antes de tener el contacto del cliente. Por defecto true.
cantidad_default	integer	La cantidad que asume si el cliente no la dice. Por defecto 1.
cantidad_max_por_linea	integer	Desde esta cantidad por producto, en vez de cotizar, pregunta si es un pedido al por mayor. Por defecto 12.
mensaje_handoff	string	Lo que dice cuando pasa la conversación a una persona.
refusal_fuera_dominio	string	Lo que dice cuando no tiene información (status_code 1001).
catalogo_url	string	El enlace a tu catálogo (tienda, PDF, catálogo de WhatsApp). Vacío: no lo ofrece. Lo entrega con mensaje_catalogo.
mensaje_* · msg_* · cta_*	string	Las frases del agente para cada situación (precio, carrito, pago, envío, stock, posventa) y las `pregunta_*`. Respeta sus `{variables}`: ver frases.
tenant_id	string	El espacio.

CONEXIONES CON OTROS MÓDULOS (TIPO · POR DEFECTO)

CAMPO	TIPO	QUÉ ES
cerebro_activo	boolean · true	Responde las preguntas con los documentos del espacio. Apagado, contesta que no tiene esa información.
comercial_activo	boolean · false	Envíos, recargos y métodos de pago con las reglas del módulo Comercial. Apagado, usa tus tablas de tarifas.
marca_activa	boolean · false	Habla con la voz, el tono y las tácticas del módulo Marca.
comprension_activa	boolean · false	Entiende cada mensaje con el módulo Comprensión.
facturacion_activo	boolean · false	Crea la orden y el cobro cuando el cliente confirma, y recibe el comprobante. Sin él, no cierra pedidos ni acepta comprobantes.
inventario_activo	boolean · false	Mira el stock antes de ofrecer y avisa si algo está agotado.
inventario_delegado	boolean · false	El stock lo lleva el módulo Productos. Apagado, usa el inventario propio de Ventas (las rutas de inventario de esta guía).

COMPORTAMIENTO (TIPO · POR DEFECTO)

CAMPO	TIPO	QUÉ ES
carrito_activo	boolean · false	El cliente suma varios productos en varios mensajes y el pedido se crea al confirmar. Apagado, cada compra es un pedido de un producto.
foco_activo	boolean · false	Recuerda de qué producto se habla («¿y cuánto vale?») y saca su precio del catálogo de Productos.
soporte_activo	boolean · true	Estado de pedido, devoluciones, garantías y quejas: responde con sus frases msg_soporte_* y pasa a una persona.
vision_imagen_activo	boolean · false	Mira las imágenes que llegan sin un pedido abierto: una foto de producto sigue la conversación; un pago lo reconoce.
whatsapp_botones_combo_activo	boolean · false	Devuelve opciones (botones) cuando duda entre 2 o 3 productos parecidos.
mostrar_stock_bajo	boolean · true	Puede decir «quedan pocas unidades» cuando el stock está en su umbral.
sugerir_alternativas	boolean · true	Si algo está agotado, ofrece otros productos que sí hay.
despacho_confirma_metodo	boolean · false	Con los datos de envío completos, confirma el método de pago antes de cerrar.
metodo_frases	{ contra, transferencia, mixto }	Cómo nombra cada método de pago en `{metodo_frase}`.

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.

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

La respuesta trae además ajustes de afinado del agente que no aparecen aquí. No te apoyes en ellos ni los cambies.
En la consola, el panel de Ventas del Estudio edita estas mismas frases.