Guardar registros

Save records

curl --request POST \
  --url https://gateway.jelou.ai/workflows/v2/memory/users/set \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userReferenceId": "<string>",
  "botId": "<string>",
  "values": {}
}
'

import requests

url = "https://gateway.jelou.ai/workflows/v2/memory/users/set"

payload = {
    "userReferenceId": "<string>",
    "botId": "<string>",
    "values": {}
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({userReferenceId: '<string>', botId: '<string>', values: {}})
};

fetch('https://gateway.jelou.ai/workflows/v2/memory/users/set', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.jelou.ai/workflows/v2/memory/users/set",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'userReferenceId' => '<string>',
    'botId' => '<string>',
    'values' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.jelou.ai/workflows/v2/memory/users/set"

	payload := strings.NewReader("{\n  \"userReferenceId\": \"<string>\",\n  \"botId\": \"<string>\",\n  \"values\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://gateway.jelou.ai/workflows/v2/memory/users/set")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userReferenceId\": \"<string>\",\n  \"botId\": \"<string>\",\n  \"values\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway.jelou.ai/workflows/v2/memory/users/set")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userReferenceId\": \"<string>\",\n  \"botId\": \"<string>\",\n  \"values\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

POST

memory

users

set

Save records

curl --request POST \
  --url https://gateway.jelou.ai/workflows/v2/memory/users/set \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userReferenceId": "<string>",
  "botId": "<string>",
  "values": {}
}
'

import requests

url = "https://gateway.jelou.ai/workflows/v2/memory/users/set"

payload = {
    "userReferenceId": "<string>",
    "botId": "<string>",
    "values": {}
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({userReferenceId: '<string>', botId: '<string>', values: {}})
};

fetch('https://gateway.jelou.ai/workflows/v2/memory/users/set', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.jelou.ai/workflows/v2/memory/users/set",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'userReferenceId' => '<string>',
    'botId' => '<string>',
    'values' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.jelou.ai/workflows/v2/memory/users/set"

	payload := strings.NewReader("{\n  \"userReferenceId\": \"<string>\",\n  \"botId\": \"<string>\",\n  \"values\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://gateway.jelou.ai/workflows/v2/memory/users/set")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userReferenceId\": \"<string>\",\n  \"botId\": \"<string>\",\n  \"values\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway.jelou.ai/workflows/v2/memory/users/set")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userReferenceId\": \"<string>\",\n  \"botId\": \"<string>\",\n  \"values\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

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

POST https://gateway.jelou.ai/workflows/v2/memory/users/set

Parámetros del cuerpo

string

requerido

Identificador de referencia externo del usuario.

string

requerido

Identificador del canal asociado a la memoria.

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.

x-api-key: API_KEY

Ejemplo de solicitud

cURL

curl --request POST \
  --url https://gateway.jelou.ai/workflows/v2/memory/users/set \
  --header 'x-api-key: API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "userReferenceId": "USER_REFERENCE_ID",
    "botId": "BOT_ID",
    "values": {
      "paso": { "value": "confirmacion", "ttl": 3600 },
      "idioma": { "value": "es" }
    }
  }'

Respuestas

Código	Estado	Descripción
201	Created	Registros guardados correctamente.
401	Unauthorized	Credenciales de autenticación inválidas o faltantes.
403	Forbidden	La API key no tiene el scope `memory:write`.
422	Unprocessable Entity	Faltan campos requeridos, el formato es inválido o se superó el máximo de 20 claves por solicitud.
500	Internal Server Error	Error interno del servidor.

Ejemplo de respuesta

{
  "status": "success",
  "message": "Records created successfully",
  "data": "OK"
}

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.

botId

string

requerido

Identifier of the bot associated with the memory.

values

object

requerido

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

Show child attributes

Respuesta

Records saved successfully.

⌘I

API reference

Envío de mensajes

Campañas

Conversaciones

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Canal Personalizado

Gestión de Memoria

Descripción

Endpoint

Parámetros del cuerpo

Encabezados opcionales

Autenticación

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta

Autorizaciones

Encabezados

Cuerpo

Respuesta

​Descripción

​Endpoint

​Parámetros del cuerpo

​Encabezados opcionales

​Autenticación

​Ejemplo de solicitud

​Respuestas

​Ejemplo de respuesta

Autorizaciones

Encabezados

Cuerpo

Respuesta

Descripción

Endpoint

Parámetros del cuerpo

Encabezados opcionales

Autenticación

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta