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

Cambia la configuración del agente

Mandas solo los campos que cambian; el resto se queda como estaba. Los cambios valen desde el siguiente mensaje.

PERMISOescribe
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.

CUERPO · JSON

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

RESPUESTA 200

La configuración entera, ya guardada: la misma forma que GET leads-config.

CAMPO	TIPO	QUÉ ES
name · saludo · …		Todos los campos, con tus cambios aplicados.

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.
403	La clave es de solo lectura	Tu cuenta es de solo lectura en este espacio.
422	Falta un campo obligatorio o uno no es de su tipo (detail es una lista)	—

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 conexiones y los interruptores de las tablas de abajo se cambian igual: mándalos con true o false.
Un campo que no existe se ignora sin error, y uno con null no cambia nada. Las listas y los objetos (campos_captura, metodo_frases) se reemplazan enteros.
Respeta las {variables} de cada frase. Una llave sin cerrar o una variable que la frase no conoce puede dejarla sin enviar o con la llave a la vista.