Saltar al contenido principal
La Memory API te permite gestionar el almacenamiento clave-valor por usuario de Jelou desde servicios externos. Es la misma memoria que ves como $memory en el builder y que usa ctx.memory en Functions — una sola memoria por usuario, no una copia paralela. Úsala para persistir estado de conversación entre turnos: flujos multi-paso, carritos, contadores, preferencias y datos temporales sin una base de datos externa.
Para el uso desde Functions con el SDK (ctx.memory), consulta la guía Memoria de sesión. Esta sección documenta los endpoints REST directos de la Memory API v2.

​
Modelo de datos

Cada registro pertenece a un usuario y tiene:
  • Clave — nombre de la variable.
  • Valor — cualquier tipo JSON.
  • TTL por variable — cuándo caduca esa variable individual (máximo 24h).
  • hashTTL — cuándo caduca la memoria completa del usuario. Por defecto la plataforma aplica 30 días; puedes sobrescribirlo por solicitud con el encabezado x-hash-ttl.

​
Identificación del usuario

La memoria de un usuario se identifica por su userReferenceId junto con el botId. Estos parámetros se envían en el cuerpo de cada solicitud para leer o escribir la memoria por referencia externa del usuario.

​
Autenticación

Todas las peticiones se autentican con una API key en el encabezado x-api-key y se realizan a través del gateway de Jelou.
La API key debe tener los scopes correspondientes: memory:read para lectura y memory:write para escritura. Consulta Claves API para crear y administrar tus claves.

​
Recursos

1

Leer memoria

Obtén todos los registros de un usuario o un registro puntual por clave.Ver obtener registros → · Ver obtener un registro →
2

Escribir memoria

Guarda uno o varios registros por referencia de usuario (hasta 20 claves por solicitud).Ver guardar registros →