Marca: cómo funciona

Marca le da a tu agente de ventas la personalidad de tu marca: quién es, cómo habla y cómo lleva la conversación hacia una compra. No guarda precios ni datos del catálogo: decide cómo se dicen las cosas, no qué se dice.

Por API la lees y la cambias desde tus propias herramientas, por ejemplo para ajustar el tono de una campaña o comprobar cómo queda descrito el agente antes de encenderlo.

También puedes hacerlo desde la consola: en el Estudio de un espacio con el módulo activo, el panel Marca tiene los apartados «Quién es tu agente», «Cómo habla», «Cómo lleva la conversación a una compra» y «Así queda descrito tu agente».

Antes de empezar

• El espacio tiene que tener el módulo Marca: marca sale en sus módulos en GET /api/companies. Si no, cada ruta responde 403 módulo no habilitado para este espacio.
• Cambiar la marca pide una clave escribe. Leerla vale con cualquier clave.
• Las rutas cuelgan de /api/mod/marca/{espacio}/, con la misma clave y los mismos límites que el resto de la API.
• No gasta créditos: ninguna ruta del módulo descuenta de tu bolsa.
• La marca se nota en las conversaciones de Ventas: el espacio necesita ese módulo con la personalidad de marca encendida (paso 4).

Paso a paso

1. Lee la marca. Si nunca se configuró, vienen los valores por defecto y name es el id del espacio.
2. Cámbiala: el nombre de tu marca y, enteros, los apartados que quieras tocar.
3. Mira cómo queda descrito tu agente: es el texto que Ventas lee antes de contestar.
4. En Ventas, enciende Personalidad de marca desde el Estudio, o manda {"marca_activa": true} a PATCH /api/mod/ventas/{espacio}/leads-config. Viene apagada.

Cómo cambia las respuestas

Con la marca encendida en Ventas y activo: true aquí, en cada mensaje Ventas cambia su descripción propia por la de tu marca. Desde ahí:

• Se presenta y habla como tu marca: con su nombre y su rol, en el tono que elegiste, con tus rasgos, el largo de max_lineas, en texto plano si lo pides y con tus emojis.
• Las cifras no cambian de origen: precios, totales, envíos y existencias siguen saliendo del catálogo y se comprueban antes de enviarse. La descripción termina siempre con unas reglas fijas que ninguna marca puede quitar: no inventar precios, totales, plazos, descuentos ni disponibilidad, no hablar de procesos internos y no ofrecer un asesor humano.
• Sugiere el combo si upsell_activo está encendido: cuando responde del catálogo sobre un producto que casa con una clave de upsell_combos, añade la frase de upsell_plantilla. No lo hace mientras cotiza, si el producto no tiene existencias, si la respuesta ya termina en pregunta o ya nombra el combo. Cada combo se sugiere una vez por conversación, y entre una sugerencia y otra deja pasar unos mensajes (lo ajustas en Ventas).
• Cierra con una pregunta si pregunta_cierre_obligatoria está encendida: si la respuesta no termina en pregunta, le añade una de preguntas_cierre, turnándolas. No lo hace al despedirse ni cuando la conversación pasa a una persona, y se salta las que piden la ciudad si ya la sabe.

upsell_combos     { "cafe de origen": "Combo Barista en Casa" }
upsell_argumento  "con la prensa francesa la taza sale mejor"
upsell_plantilla  "Si buscas un mejor resultado, te recomiendo el {combo}: {argumento}. ¿Te lo cotizo?"

El cliente pregunta por «Café de origen 500 g» → al final de la respuesta se añade:
Si buscas un mejor resultado, te recomiendo el Combo Barista en Casa: con la prensa
francesa la taza sale mejor. ¿Te lo cotizo?

Con activo: false, Ventas atiende con su descripción propia y sin tus tácticas. Si Marca no responde, usa la última marca que tenía o, si no tiene ninguna, la suya propia: la marca nunca deja una conversación sin respuesta. Un cambio tarda poco en llegar a las conversaciones, hasta un minuto.

Los tres apartados

Cada apartado se manda entero. Un PATCH con estilo reemplaza todo el estilo: lo que no vaya dentro vuelve a su valor por defecto. Lee la marca, cambia el dato y manda el apartado completo. Lo que no mandes (otro apartado, name, activo) se queda como estaba.

GET   …/config                → "estilo": { "tono": [...], "rasgos": [...], … }
PATCH …/config  { "estilo": { "tono": ["elegante", "directa"],
                              "rasgos": [...], "emojis_permitidos": [...],
                              "emojis_obligatorios": [], "max_lineas": 4,
                              "solo_texto_plano": true } }

Rutas