Saltar al contenido principal
POST
Save records

Descripción

Crea o actualiza registros de memoria de un usuario identificado por userReferenceId y botId. Acepta un máximo de 20 claves por solicitud.

Endpoint

Parámetros del cuerpo

Debes enviar socketId, o bien userReferenceId junto con botId. Una de las dos formas es obligatoria.
string
Identificador de referencia externo del usuario.
string
Identificador del canal asociado a la memoria.
string
Identificador del socket del usuario (el flow_token de los WhatsApp Flows). Alternativa a userReferenceId + botId; no se puede combinar con ellos. Un socketId inexistente o de otra compañía responde 404.
object
requerido
Mapa de clave → estructura de registro. La clave es el nombre de la variable. Máximo 20 claves por solicitud.Cada estructura de registro contiene:
  • value (requerido) — valor a almacenar. Puede ser cualquier tipo JSON.
  • ttl — TTL de la variable en segundos. Máximo 86400 (24h).
  • contentType — tipo de contenido opcional del valor.
Cada valor debe enviarse como un objeto { "value": ... }. Un valor plano (por ejemplo "paso": "confirmacion") se guarda vacío.

Encabezados opcionales

integer
TTL en segundos para el hash completo de la memoria del usuario.

Autenticación

Todas las peticiones deben incluir el encabezado x-api-key con una API key que tenga el scope memory:write.

Ejemplo de solicitud

cURL

Respuestas

Ejemplo de respuesta

Autorizaciones

x-api-key
string
header
requerido

API key del proyecto de Jelou

Encabezados

x-hash-ttl
integer

TTL in seconds for the user's full memory hash. Optional.

Cuerpo

application/json
userReferenceId
string
requerido

External reference identifier of the user. Use together with botId. Cannot be combined with socketId.

botId
string
requerido

Identifier of the bot associated with the memory. Use together with userReferenceId. Cannot be combined with socketId.

values
object
requerido

Map of key to record structure. The key is the variable name. Maximum 20 keys per request.

socketId
string

Socket identifier of the user (the flow_token of WhatsApp Flows). Alternative to userReferenceId + botId. An unknown socketId, or one of another company, answers 404.

Respuesta

Records saved successfully.