Cache do usuário

​

Descrição

• Associar dados operacionais, como um número de pedido, a um user.
• Permitir que o bot conheça as propriedades do usuário antes do início da conversa.
• Armazenar informações necessárias para consultar serviços internos ou externos de workflows específicos.

• Definir reações ou executar um fluxo antes que o usuário inicie a conversa (em breve).

​

Obter Cache do Usuário

​

Endpoint

GET https://api.jelou.ai/v1/users/{userId}/cache

​

Parâmetros de Path

​

Parâmetros de Query

​

Exemplo de Requisição

curl --request GET \
  --url 'https://api.jelou.ai/v1/users/{userId}/cache?botId=BOT_ID' \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json'

​

Exemplo de Resposta

{
  "groupId": "grp-67890",
  "orderNumber": "ORD-12345"
}

​

Definir cache do usuário

​

Endpoint

POST https://api.jelou.ai/v1/users/{userId}/cache

​

Parâmetros de Path

​

Corpo da Requisição

​

Exemplo de Requisição

curl --request POST \
  --url https://api.jelou.ai/v1/users/{userId}/cache \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "params": {
      "groupId": "grp-67890",
      "orderNumber": "ORD-12345"
    },
    "botId": "bot-12345"
  }'

​

Exemplo de Resposta

{
  "message": [
    "User cache set successfully."
  ],
  "status": "success"
}

​

Erros Comuns

• 400 - Não foi possível obter ou atualizar o status do usuário.
• 401 - Credenciais inválidas ou ausentes.
• 404 - Usuário ou bot não encontrado.
• 200 - Erro lógico ao obter o cache (quando o status é “failed”).