GET/api/mod/marca/{espacio}/config

La marca de tu agente

Quién es tu agente, cómo habla y cómo lleva la conversación a una compra, tal como está guardado. Es lo que usa Ventas para dar su voz a las respuestas.

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
name	string	El nombre de tu marca: el agente se presenta como «… de `name`».
activo	boolean	El interruptor general. En false, Ventas responde con su descripción propia.
identidad	object	Quién es: ver identidad.
estilo	object	Cómo habla: ver estilo.
tacticas	object	Cómo lleva la conversación a una compra: ver tacticas.

IDENTIDAD

CAMPO	TIPO	QUÉ ES
nombre_agente	string	El nombre con el que se presenta. Vacío (por defecto): sin nombre propio.
rol	string	A qué se dedica, en una frase. Por defecto «asesor comercial».
linea	string	En qué se especializa. Vacío (por defecto) si atiende todo lo que ofreces.

ESTILO

CAMPO	TIPO	QUÉ ES
tono	string[]	Adjetivos, el más importante primero. Por defecto cordial, breve y claro.
rasgos	string[]	Frases cortas sobre su manera de ser; cada una entra tal cual en su descripción. Escríbelas sin comillas.
emojis_permitidos	string[]	Los que puede usar, con moderación.
emojis_obligatorios	string[]	Los que lleva siempre en cada respuesta.
max_lineas	integer	El largo máximo de una respuesta, en líneas. 0 (por defecto): sin límite.
solo_texto_plano	boolean	Sin viñetas, negritas ni formato: se lee natural en WhatsApp. Por defecto true.

TACTICAS

CAMPO	TIPO	QUÉ ES
upsell_activo	boolean	Sugerir el combo completo cuando encaja. Por defecto false.
upsell_combos	{ producto: combo }	Qué combo sugerir para qué producto. La clave es una palabra o parte del nombre del producto (da igual mayúsculas o tildes); el valor, el nombre del combo tal como está en tu catálogo.
upsell_argumento	string	Por qué lo recomienda, sin precios ni cifras. Por defecto «llevarlo completo da mejores resultados».
upsell_plantilla	string	La frase de la sugerencia, con `{combo}` y `{argumento}`. Por defecto «Si buscas un mejor resultado, te recomiendo el {combo}: {argumento}. ¿Te lo cotizo?».
pregunta_cierre_obligatoria	boolean	Si una respuesta no termina en pregunta, se le añade una de preguntas_cierre. Por defecto false.
preguntas_cierre	string[]	Las preguntas con las que puede cerrar. Se turnan de un mensaje a otro.

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

Si nunca se configuró, responde con los valores por defecto y name igual al id del espacio: cámbialo por el nombre de tu marca.