Variáveis

Variáveis ​​são placeholders para conteúdo que você pode usar em qualquer lugar no Blubot. É um conceito crucial a ser compreendido para criar uma experiência personalizada ao usuário.

Salvar uma resposta em uma variável

Você pode dizer ao seu bloco de entrada para salvar a resposta em uma variável e reutilizá-la em outra bolha, por exemplo:

Usar variáveis

Uma vez que suas variáveis ​​são declaradas, você pode usar o tema em qualquer lugar do seu bot.

Por exemplo, você pode exibi-lo em um balão de texto com a seguinte sintaxe: {{My variable}}onde “Minha variável” é o nome da sua variável.

Formatação de variáveis ​​em linha

Você também pode decidir formatar sua variável diretamente no balão de texto. Por exemplo, se você quiser exibir a variável “Primeiro nome” em letras maiúsculas, você pode usar a seguinte sintaxe:

{{={{Minha variável}}.toUpperCase()=}}

Quando você insere {{= ... =}}, significa que o que está dentro será avaliado como JavaScript. Então você pode usar qualquer função inline JavaScript dentro. O comportamento é similar ao valor personalizado no bloco Definir variável.

Se você quiser obter o primeiro item de uma lista:

{{={{Minha variável}}[0]=}}ou{{={{Minha variável}}.at(0)=}}

Da mesma forma para o último item:

{{={{Minha variável}}.at(-1)=}}

Variáveis ​​ocultas

As variáveis ​​do seu Blubot não precisam ser exibidas para o usuário. Você pode criar variáveis ​​que são usadas apenas internamente pelo bot e exibidas em seus resultados. Isso permite que você adicione algum contexto a uma sessão, por exemplo, um ID de usuário, um parâmetro ou qualquer outra coisa.

Você só precisa ter certeza de que as variáveis ​​existem no menu suspenso de variáveis:

(Este menu suspenso pode ser encontrado em qualquer lugar onde você possa adicionar variáveis. Ele é global para o fluxo do seu bot.)

Tipos de valores válidos

O conteúdo das variáveis ​​pode ser um texto ( string) ou uma lista de textos ( string[]).

// ✅ Good
'Hello', ['item 1', 'item 2']

// ❌ Not good
2, true, { foo: 'bar' }
// Will automatically converted into
'2', 'true', '{ foo: "bar" }'

Se você fornecer um objeto, número ou booleano. Ele sempre será convertido em um texto ou uma lista de textos antes que a variável seja salva no banco de dados.

Essa limitação é intencional. Variáveis ​​devem ter conteúdo simples. Isso força você a ter uma estrutura de bot mais limpa e a usar o conteúdo da variável de uma forma mais significativa.

Em alguns casos, o conteúdo da variável será analisado dinamicamente para corresponder ao seu tipo pretendido. Por exemplo, se você fornecer um texto que se parece com um número em um bloco de condição, ele será convertido em um número durante a execução da condição.

Se você realmente precisa salvar um conteúdo complexo em uma variável, por exemplo, um objeto, você pode usar a JSON.stringifyfunção para convertê-lo em um texto. E sempre que você estiver usando a variável, você pode analisá-la dinamicamente de volta em um objeto usando JSON.parseum formato inline :

{{=JSON.parse({{My object variable}})=}}