> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestão de Memória

> Leia e escreva a memória de sessão por usuário através da Memory API v2

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.

<Note>
  Para o uso a partir de Functions com o SDK (`ctx.memory`), consulte o guia [Memória de sessão](/pt/guias/funcoes/memoria). Esta seção documenta os endpoints REST diretos da Memory API v2.
</Note>

***

## 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.

```
x-api-key: API_KEY
```

<Warning>
  A API key deve ter os scopes correspondentes: `memory:read` para leitura e `memory:write` para escrita. Consulte [Chaves API](/pt/guias/configuracao/chaves-api) para criar e administrar suas chaves.
</Warning>

***

## Recursos

<Steps>
  <Step title="Ler memória">
    Obtenha todos os registros de um usuário ou um registro pontual por chave.

    [Ver obter registros →](/pt/api/memoria/obtener-registros) · [Ver obter um registro →](/pt/api/memoria/obtener-registro)
  </Step>

  <Step title="Escrever memória">
    Salve um ou vários registros pela referência do usuário (até 20 chaves por solicitação).

    [Ver salvar registros →](/pt/api/memoria/guardar-registros)
  </Step>
</Steps>