Encontre a resposta que está procurando

Node Cache

O node Cache, disponível na categoria Storage, permite armazenar dados temporariamente na memória cache para recuperá-los posteriormente a partir de qualquer ponto da integração.

Diferentemente dos dados associados a um fluxo, os valores armazenados em cache permanecem disponíveis mesmo depois de alcançar o node Step Close. Além disso, você pode configurar se os dados serão exclusivos de uma sessão ou estarão disponíveis para todas as sessões da instância.

⚙ Configuração do node
A seguir, você encontrará a descrição dos campos disponíveis para configurar o node:

1. Name:
Permite personalizar o nome do node, que ficará visível no workspace do Studio.
2. Key (obrigatório):
Define o nome da chave com a qual o dado será armazenado em cache e que você usará posteriormente para recuperá-lo.
ℹ Este campo aceita a sintaxe Mustache {{varExample}} para acessar propriedades do objeto msg, por exemplo, msg.varExample.
3. Global:
Define o escopo dos dados armazenados:

  • False: o valor ficará disponível somente na sessão do usuário em que foi armazenado.
  • True: o valor ficará disponível para todas as sessões da instância.

4. Method:
Permite selecionar um dos quatro métodos disponíveis para operar sobre os dados armazenados em cache: GET, SET, INCREMENT e DELETE.

1⃣ GET
Permite recuperar um dado armazenado previamente em cache. A disponibilidade do dado dependerá do valor configurado em Global no momento em que foi armazenado:

  • True: ficará disponível para todas as sessões, como um cache compartilhado do bot.
  • False: ficará disponível somente na sessão em que foi salvo.

ℹ Se o valor não existir, o resultado será null.

Este método inclui os seguintes campos:

  • Output: define o nome da variável em que o valor recuperado será armazenado. Você pode usar uma variável existente ou criar uma nova.
  • Decrypt: permite descriptografar os dados armazenados previamente por meio da opção Encrypt.

2⃣ SET
Permite armazenar informações em cache por meio de uma chave para recuperá-las posteriormente.
Inclui os seguintes campos:

  • Input: indica o nome da variável de msg, string ou JSON que você deseja armazenar.
  • Expires: define o tempo de permanência dos dados em cache, expresso em minutos. O valor padrão é 60 minutos. Você pode configurar no mínimo 1 minuto e no máximo 1440 minutos (24 horas).
  • Encrypt: permite criptografar os dados antes de armazená-los. Se você habilitar esta opção, deverá ativar Decrypt ao recuperá-los para poder ler o conteúdo.

3⃣ INCREMENT
Funciona como um contador e, a cada execução, incrementa o valor armazenado em 1. Se a variável não existir, ela é inicializada automaticamente em 1.
ℹ Neste método, você deverá preencher o campo Output, assim como no GET, para definir onde o resultado será armazenado.

4⃣ DELETE
Permite excluir uma chave e o valor associado armazenados previamente em cache. Para isso, você deverá informar a chave correspondente no campo Key.
ℹ Quando um dado armazenado em cache expira ou é excluído, seu valor passa a ser null.
ℹ O valor de Global deve coincidir com o utilizado ao salvar o dado. Por exemplo, se foi armazenado com Global = True, o node DELETE também deverá ser configurado com Global = True. O mesmo vale quando se usa False.

✅ Dados-chave
Para garantir o funcionamento correto do node, leve em conta as seguintes considerações:

1. Propriedade msg._studio
Você não deve excluir nem modificar essa propriedade, pois ela é necessária para o funcionamento do node.
O agentbot user id deve estar armazenado na propriedade msg._studio.sessionId. As configurações existentes que utilizem outros identificadores de sessão continuarão funcionando normalmente.
2. Variáveis vazias ou não definidas
Se você tentar armazenar um dado de uma variável do objeto msg cujo valor esteja vazio, seja null ou não esteja definido, será exibido um aviso no console Debug com o seguinte formato:
"Warning: {{msg property name}} maybe empty or undefined."
3. Ausência do agentbot user id
Se você utilizar qualquer um dos métodos disponíveis (GET, DELETE, INCREMENT ou SET) com Global = False e o agentbot user id não estiver presente quando o node receber a requisição, será exibida a seguinte mensagem de aviso na janela Debug do Studio:
"The agentbot user ID is not present in the msg object, and global is false. Stored data may be unreachable."
ℹ Nesse cenário, o dado será armazenado de forma global e você deverá recuperá-lo utilizando também Global = True.
4. Uso do node Cache com HTTP_IN
Se você utilizar o node Cache junto com um node HTTP_IN, deverá definir manualmente o ID de sessão. Você pode fazer isso em qualquer uma das seguintes propriedades, respeitando esta ordem de precedência:

  1. msg._studio.sessionId
  2. msg.payload.agentbot_user.id
  3. msg.payload.id

📥 Você pode baixar o fluxo de exemplo neste link.

▶ No vídeo a seguir, mostramos como configurar o node:

Este site armazena cookies em seu computador. Estes cookies são utilizados para coletar informações de como você interage com o nosso site e nos permite lembrar de você. Nós usamos essa informação para melhorar e personalizar sua experiência de navegação e para obter estatísticas e métricas sobre nossos visitantes, tanto neste site quanto em outros meios. Para obter mais informações sobre os cookies que utilizamos, consulte nossa Política de Privacidade.

Se você recusar, sua informação não será rastreada quando você visitar este site. Será utilizado somente um cookie em seu navegador para lembrá-lo de sua preferência de não ser rastreado.