Variável

O bloco "Variável" é um componente fundamental da lógica, permitindo armazenar informações, manipular dados e personalizar o fluxo de conversa.

O bloco variável é um componente lógico que permite:

• Criar e atribuir valores a variáveis

• Manipular dados coletados durante a conversa

• Executar cálculos e formatações

• Preparar informações para uso em outros blocos

Custom

Você pode definir sua variável com qualquer valor usando o recurso Custom. O valor pode ser qualquer tipo de texto simples.

Expressões com variáveis existentes

Isso significa que você pode realizar operações com variáveis já existentes. Por exemplo, adicione um valor à sua variável:

{{Score}} + 5

Calcula a soma de variáveis:

{{Score}} + {{Answer}}

Multiplique os valores das variáveis:

{{Score}} * {{Multiplier}}

Calcule uma porcentagem:

{{Score}} * 100 / {{Max Score}}

Extraia o primeiro nome de um nome completo:

{{Full name}}.split(' ')[0]

Converta o valor de uma variável para maiúsculas ou minúsculas:

{{Name}}.toUpperCase()

{{Name}}.toLowerCase()

isso também pode ser feito em JavaScript. O valor retornado pelo código será lido e atribuído à variável.

const name = 'John' + 'Smith'
return name

Se você não fornecer a palavra-chave return, ela será automaticamente adicionada ao início do seu código.

'John' + 'Smith'

É o mesmo que:

return 'John' + 'Smith'

Obs: Variáveis em scripts não são analisadas, elas são avaliadas. Portanto, devem ser tratadas como variáveis reais do JavaScript. Se você escrever {{My variable}}, ele analisará o ID da variável (algo como vclfqgqkdf000008mh3r6xakty). Para obter corretamente o valor do conteúdo da variável, é necessário remover as aspas duplas. Por exemplo:

❌ {{URL base}}/path → vclfqgqkdf000008mh3r6xakty/path

✅ {{URL base}} + '/path' → https://domain.com/path

✅ ${{{URL base}}}/path → https://domain.com/path

Obs: O conteúdo das variáveis pode ser uma string ou uma lista de strings. Consulte "Tipos de valores válidos" para mais informações.

Empty

Redefine a variável como se ela nunca tivesse sido inicializada (resetando a variável).

Append value(s)

Transforma automaticamente a variável em uma lista de strings, anexando os valores fornecidos. São três cenários possíveis:

• Se a variável estiver vazia: é criado um novo array com os valores fornecidos.

• Se a variável não for uma matriz: é criada uma nova matriz que contém o valor existente seguido dos valores fornecidos.

• Se a variável já for uma matriz: os valores fornecidos são concatenados à matriz existente.

Transcript

Salva toda a transcrição da conversa em uma variável. Esse recurso é muito útil para fornecer contexto a um bloco de IA ou para enviar uma recapitulação utilizando o bloco "Enviar e-mail".

Now, Yesterday, Tomorrow

Define a variável com a data e hora especificadas, no formato ISO. Opcionalmente, um fuso horário pode ser fornecido para converter a data conforme necessário.

Random ID

Atribui à variável um ID aleatório, gerado com o algoritmo CUID.

Moment of the Day

Define a variável com um dos seguintes valores, de acordo com a hora atual do usuário: morning, afternoon, evening, night.

Essa variável pode ser utilizada para exibir conteúdo de forma condicional.

Map item with same index

Este é um bloco de valor prático que permite extrair facilmente um item de uma lista com base no índice de um item em outra lista.

Ao integrar dados de um serviço externo, você frequentemente obtém duas listas:

• Labels: os rótulos que serão exibidos ao usuário;

• Ids: os identificadores usados para requisições subsequentes.

Este bloco de valores possibilita localizar o ID na lista de Ids que corresponde ao mesmo índice do rótulo na lista de Labels.

Pop/Shift

O método Pop remove o último item da lista fornecida e armazena o valor removido na variável "Item popped". Por sua vez, o método Shift executa a mesma operação, porém removendo o primeiro item da lista. Esses métodos são especialmente úteis para criar loops que processam cada elemento de uma lista.