Pular para o conteúdo principal
POST
Save records

Descrição

Cria ou atualiza registros de memória de um usuário identificado por userReferenceId e botId. Aceita um máximo de 20 registros por solicitação.

Endpoint

Parâmetros do corpo

userReferenceId
string
obrigatório
Identificador de referência externo do usuário.
botId
string
obrigatório
Identificador do bot associado à memória.
values
object
obrigatório
Mapa de chave → estrutura de registro. A chave é o nome da variável. Máximo de 20 chaves por solicitação.Cada estrutura de registro contém:
  • value (obrigatório) — valor a armazenar. Pode ser qualquer tipo JSON.
  • ttl — TTL da variável em segundos. Máximo 86400 (24h).
  • contentType — tipo de conteúdo opcional do valor.
Cada valor deve ser enviado como um objeto { "value": ... }. Um valor simples (por exemplo "paso": "confirmacion") é salvo vazio.

Cabeçalhos opcionais

x-hash-ttl
integer
TTL em segundos para o hash completo da memória do usuário.

Autenticação

Todas as requisições devem incluir o cabeçalho x-api-key com uma API key que tenha o scope memory:write.

Exemplo de solicitação

cURL

Respostas

Exemplo de resposta

Autorizações

x-api-key
string
header
obrigatório

API key del proyecto de Jelou

Cabeçalhos

x-hash-ttl
integer

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

Corpo

application/json
userReferenceId
string
obrigatório

External reference identifier of the user.

botId
string
obrigatório

Identifier of the bot associated with the memory.

values
object
obrigatório

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

Resposta

Records saved successfully.