Pular para o conteúdo principal
A Memory API permite gerenciar o armazenamento chave-valor por usuário do Jelou a partir de serviços externos. É a mesma memória que você vê como $memory no builder e que o ctx.memory usa em Functions — uma única memória por usuário, não uma cópia paralela. Use-a para persistir o estado da conversa entre turnos: fluxos multipasso, carrinhos, contadores, preferências e dados temporários sem um banco de dados externo.
Para o uso a partir de Functions com o SDK (ctx.memory), consulte o guia Memória de sessão. Esta seção documenta os endpoints REST diretos da Memory API v2.

​
Modelo de dados

Cada registro pertence a um usuário e tem:
  • Chave — nome da variável.
  • Valor — qualquer tipo JSON.
  • TTL por variável — quando essa variável individual expira (máximo 24h).
  • hashTTL — quando a memória completa do usuário expira. Por padrão, a plataforma aplica 30 dias; você pode sobrescrevê-lo por solicitação com o cabeçalho x-hash-ttl.

​
Identificação do usuário

A memória de um usuário é identificada pelo seu userReferenceId junto com o botId. Esses parâmetros são enviados no corpo de cada solicitação para ler ou gravar a memória pela referência externa do usuário.

​
Autenticação

Todas as requisições são autenticadas com uma API key no cabeçalho x-api-key e são realizadas através do gateway do Jelou.
A API key deve ter os scopes correspondentes: memory:read para leitura e memory:write para escrita. Consulte Chaves API para criar e administrar suas chaves.

​
Recursos

1

Ler memória

Obtenha todos os registros de um usuário ou um registro pontual por chave.Ver obter registros → · Ver obter um registro →
2

Escrever memória

Salve um ou vários registros pela referência do usuário (até 20 chaves por solicitação).Ver salvar registros →