Carpetas de soluciones

Una carpeta agrupa soluciones relacionadas. Toda solución pertenece al menos a una carpeta, y la carpeta ofrece tres cosas además del orden: memoria compartida, una API key única y un endpoint de integración que atiende a todas las soluciones miembro.

Abre la carpeta con el icono de configuración junto a ella en la barra lateral, o con Configurar Carpeta en la lista de soluciones.

General

Nombre, slug y el estado Activo. Una carpeta inactiva desaparece de la barra lateral y deja de atender llamadas en su endpoint.

Soluciones

La pestaña tiene dos listas:

• Soluciones en esta carpeta: las soluciones miembro, con nombre, slug, modo, estado y fecha de incorporación.
• Soluciones disponibles: las demás, con el botón Agregar.

La carpeta principal es la red de seguridad

Las soluciones que pertenecen solo a la carpeta principal no se pueden quitar de ella. Para sacarlas, agrégalas antes a otra carpeta: así ninguna solución queda huérfana.

Integración

Aquí la carpeta gana un punto de entrada único para sistemas externos:

Elemento	Qué es
Endpoint de API de Entrada	La dirección que llama el sistema externo, con el botón Copiar URL
Gestión de API Key	Crear clave genera la clave de la carpeta; se muestra una sola vez
Ejemplo de uso	Un ejemplo listo de solicitud, con headers y cuerpo

El cuerpo de la solicitud trae un campo solutionKey, y es el que decide qué solución de la carpeta atenderá el mensaje. Es decir: una sola dirección y una sola clave, con enrutamiento por solución.

La clave aparece una sola vez

Guarda la clave en cuanto la crees. Generar una nueva invalida la anterior: acuerda el cambio con quien consume el endpoint antes de rotarla.

Memoria

Las memorias creadas aquí están disponibles para todas las soluciones y agentes de la carpeta. Es el lugar adecuado para el conocimiento común a varias soluciones: la política de cambios de la empresa, por ejemplo, usada tanto por atención como por posventa.

En las soluciones miembro esas memorias aparecen marcadas como Heredada. Consulta Memoria para los tipos, alcances y permisos.

Cuándo crear una carpeta nueva

• Cuando varias soluciones comparten conocimiento y conviene mantenerlo en un solo lugar.
• Cuando un sistema externo necesita hablar con varias soluciones sin gestionar una clave por cada una.
• Cuando la lista de soluciones creció tanto que estorba la navegación.