Ir al panel

Fuentes de datos

Cómo conectar una lista externa que cambia (cobertura, tarifas, disponibilidad) para que Hermes la consulte en vivo y responda con datos actualizados.

15 minNecesitas: La dirección web (https) donde está tu información, en JSON o en una tabla HTMLSe hace en: Hermes

Qué hace

Una fuente de datos es una lista que vive fuera de Hermes y cambia con frecuencia: la cobertura de envíos por ciudad, las tarifas, la disponibilidad por sede. Hermes la lee desde su dirección web, la guarda y la consulta en vivo cuando un cliente pregunta («¿envían a Cali y cuánto cuesta?»). Así no tienes que actualizar nada a mano. Lo encuentras en el menú del panel, dentro de Conocimiento, como Fuentes de datos.

1234
Pantalla Fuentes de datos sin ninguna fuente: mensaje «Conecta tu primera fuente», botón Nueva fuente y ejemplos como Inventario de productos, Tarifas y precios y Cobertura por zona.

¿Fuente de datos o documento?

Un documento es texto que tú escribes y que casi no cambia (políticas, preguntas frecuentes). Una fuente de datos es una lista de filas que se actualiza sola desde internet: ciudades, precios, existencias. Si el dato cambia seguido, conviene una fuente.

Antes de empezar

  • Necesitas una dirección web (https) que devuelva tus datos. Pueden ser un archivo JSON (el formato que usan la mayoría de sistemas) o una página con una tabla HTML.
  • Solo se permite https: Hermes rechaza direcciones sin candado y direcciones internas.
  • Pídele a quien maneja tu sistema o tu página que te confirme esa dirección. Si no la tienes, usa Crear con IA (abajo) con la dirección de tu página.
  • Para productos con sus precios no uses una fuente: usa Productos.

Cómo se usa

Crear una fuente a mano

Pulsa Nueva fuente. En Información básica escribe el Nombre (slug) (empieza con una letra; solo minúsculas, números y guion bajo, sin espacios: cobertura_envios), cada cuántas horas se actualiza (Refresco (horas)) y una Descripción.

12345
Formulario Nueva fuente de datos con nombre cobertura_envios, refresco de 24 horas, una descripción, la dirección del servicio, el dominio permitido y el tipo de extracción JSON con la ruta cobertura.

La descripción importa: Hermes la lee para saber cuándo consultar esta fuente. Escríbela como se lo explicarías a un compañero nuevo («Ciudades a las que enviamos, días de entrega, costo y si hay pago contraentrega»).

En Conexión pega la Endpoint / URL (https). Al salir del campo, Hermes rellena solo Dominios permitidos con el dominio de esa dirección. Es una protección: solo se descarga de los dominios que aquí aparezcan. Si usas varios, sepáralos con espacios.

En Extracción le dices a Hermes cómo encontrar las filas dentro de la respuesta:

  • JSON: en Path (opcional) escribe el nombre de la lista dentro del archivo (por ejemplo, cobertura o data.items). Si la lista está al inicio, déjalo vacío.
  • Tabla HTML: en Selector CSS (opcional) indica la tabla; vacío significa la primera tabla de la página.
  • Regex: para casos avanzados, con un patrón que captura los datos. Si no sabes qué es, usa Crear con IA.

En Campos consultables declara las columnas que Hermes puede usar para buscar, con Agregar campo: el nombre (igual al de tu archivo, por ejemplo ciudad), el tipo (texto, número o booleano, es decir, sí o no) y cómo se compara (igual, máx o mín). Activa Opcional en una columna si a veces viene vacía y no quieres perder la fila entera.

Pulsa Probar conexión. Hermes descarga la dirección y te muestra si funcionó (conexión ok), cuántas filas válidas encontró y una muestra. Si falla, aparece falló con el motivo.

123456
Campos consultables ciudad, envio_dias, costo_envio y contraentrega con su tipo y comparación, y debajo el resultado de Probar conexión: conexión ok, 5 filas válidas y una tabla de muestra con Bogotá, Medellín, Cali y Barranquilla.
Cuando la prueba salga bien, pulsa Crear fuente. Aparece el aviso Fuente creada y Hermes hace la primera lectura.

El ejemplo usa un servicio de pruebas

Las capturas leen un archivo de prueba de un servicio público, solo para mostrar el proceso. En tu caso la dirección será la de tu sistema o tu página.

Crear una fuente con ayuda de la IA

Si no sabes qué poner en Extracción o en los campos, pulsa Crear con IA: pega la URL del endpoint (https) y describe ¿Qué datos quieres consultar? («Inventario por sede: nombre de la sede, producto y unidades disponibles»). Pulsa Proponer config: la IA propone la configuración una sola vez. Tú la revisas en el formulario, corriges lo que haga falta y guardas. La IA no guarda nada por su cuenta.

Ver y mantener tus fuentes

Cada fuente aparece en la lista con su estado, el número de filas y la última sincronización.

123
Lista de fuentes con cobertura_envios en estado Conectada, 5 filas, modo automático y la hora de la última sincronización.
EstadoQué significa
ConectadaLa última lectura salió bien
ParcialSe guardó, pero algunas filas no cumplían el formato y se omitieron
Con errorLa última lectura falló; Hermes sigue usando la última lectura buena
Sin sincronizarTodavía no se ha leído

Haz clic en una fuente para abrir su detalle: ahí ves la dirección, los Datos disponibles que Hermes puede consultar (con buscador) y puedes Editar, Sincronizar ahora, Probar o eliminar.

123
Detalle de la fuente cobertura_envios con su descripción, la dirección, los botones Editar y Sincronizar ahora y la tabla de datos disponibles con cinco ciudades, sus días de envío, costo y si hay contraentrega.

Sabrás que terminaste cuando…

La fuente aparece como Conectada, con sus filas, y al preguntarle a Hermes en el Banco de pruebas por una ciudad de tu lista, responde con esos datos.

Qué cuidar

Hermes responde con lo que está en la fuente

Si tu archivo tiene un dato viejo o equivocado, Hermes lo repetirá. Revisa Datos disponibles después de crear o editar la fuente.

  • La lectura tiene límites: responde en 10 segundos como máximo y el archivo no puede pesar más de 2 MB. Para listas muy grandes, publica solo lo necesario.
  • Cada consulta de Hermes devuelve hasta 25 filas. Declara como campos consultables los que usan tus clientes para preguntar (ciudad, sede, producto), así Hermes filtra y no trae todo.
  • Si una lectura falla, la fuente queda Con error pero no se pierde lo anterior: Hermes sigue usando la última lectura buena. Corrige la dirección o el formato y pulsa Sincronizar ahora.
  • Al eliminar una fuente, Hermes deja de consultarla. Te pide confirmación.

Preguntas frecuentes

¿Cada cuánto se actualiza?

Según las horas que pusiste en Refresco (horas). También puedes forzarlo con Sincronizar ahora.

¿Puedo conectar un Google Sheets o un sistema con contraseña?

Hermes lee direcciones https públicas que devuelvan JSON o HTML. Si tu sistema pide inicio de sesión, la dirección no servirá tal cual. Revisa Integraciones por si tu tienda ya tiene un conector listo.

¿Qué pasa si el cliente pregunta algo que la fuente no tiene?

Hermes no inventa: si no encuentra resultados, ofrece pasarte la conversación para que una persona la atienda.