🆕Sintaxe de expressão

A sintaxe de expressão refere-se à estrutura de declarações na linguagem de código usada para incorporar conteúdo dinâmico, variáveis ou funções internas específicas no seu chatbot.

Ao contrário das ações de código tradicionais, que requerem conhecimento de JavaScript e podem consumir muitos recursos, a sintaxe de expressão no Chatlayer torna funcionalidades avançadas acessíveis sem a necessidade de habilidades extensas de codificação.

Como usar a sintaxe de expressão

A sintaxe de expressão pode ser usada dentro de Passos de Texto e Condições, usando tipos de dados, operadores e funções.

Use funções da sintaxe no seu bot

Para usar a sintaxe de expressão no seu chatbot:

1. Abra seu bloco.

2. Vá para o seu campo de texto.

3. Digite '{' dentro de um campo de texto ou digite o nome de uma função interna. Alguns casos de uso são mostrados abaixo.

Passo de Texto

Use a sintaxe de expressão dentro de um passo de texto para exibir o resultado dentro da mensagem do seu bot.

Bloco de Condição

Use a sintaxe de expressão dentro de uma bloco de Condição declaração como um variável.

Leia abaixo para exemplos de casos de uso:

• Obter a hora atual

• Converter para minúsculas

• Criar uma lista

Funções

Funções, sejam internas ou personalizadas, formam a espinha dorsal da sintaxe de expressão. Elas executam tarefas e operações específicas dentro do fluxo conversacional do seu chatbot.

Funções internas

Aqui está a lista de funções internas que você pode usar:

Funções personalizadas

Você pode criar suas próprias funções como desejar, usando as operadores.

Alguns exemplos de funções personalizadas:

• 1 + 2

• 1 + (2 * 3)

• MAX(1,2)

• a ? b : c

• a.b.c.d

Operadores

Operações englobam uma variedade de ações, cálculos e manipulações de dados no código. Usar operadores proporciona respostas mais dinâmicas e contextualmente conscientes ao seu chatbot.

Tipos de dados

Nós suportamos um subconjunto de tipos JavaScript para fornecer flexibilidade na sua jornada de criação de bots:

• número

• string

• booleano

• mapa

• lista

• nulo

Casos de uso da sintaxe de expressão

Nesta seção, encontre alguns exemplos de casos de uso onde a sintaxe de expressão é utilizada

Obter a hora

Existem várias maneiras de retornar informações sobre o tempo com funções da sintaxe de expressão.

Obter a hora atual

Imagine que você quer que seu bot saiba ou exiba a hora atual. A hora é fácil de obter com as seguintes funções:

• FORMAT() retorna a hora de acordo com uma string.

• NOW() retorna a data e hora atuais com base no fuso horário UTC.

Combine estas para criar uma função que retorne a hora com horas e minutos:

 {FORMAT(NOW(), "T")}

Obter um fuso horário UTC+1

Imagine um cenário em que seus usuários finais estão localizados em um fuso horário UTC+1. Para que eles saibam se sua loja está aberta agora, seu bot precisa determinar que horas são na Bélgica.

Você pode usar as funções:

• NOW() retorna a data e hora atuais com base no fuso horário UTC.

• HOUR() extrai a hora do horário atual.

• HOUR(NOW()) extrai o componente de hora do fuso horário UTC atual.

• +1 adiciona 1.

Combine essas funções na seguinte expressão personalizada:

{HOUR(NOW())+1}

Esta expressão extrai a hora do fuso horário UTC atual e adiciona 1 a ela para que corresponda ao horário belga.

Converter para minúsculas

Digamos que seu cliente forneceu seu nome em letras maiúsculas. Você quer converter todos os caracteres de entrada para minúsculas para que possa seguir um processo padronizado.

• DOWNCASE() converte todos os caracteres em um texto dado para minúsculas.

• @username é o nome da variável sob o qual o nome do seu cliente é salvo.

Combine esses elementos em uma função personalizada que transforma todos os caracteres do nome do usuário em minúsculas:

DOWNCASE(@userName)

Criar uma lista

Digamos que você tem uma mensagem que consiste em uma lista de elementos que você gostaria de tratar separadamente, por exemplo, uma lista de frutas.

Sua mensagem de exemplo seria a seguinte string:

"Apple Banana Orange"

• SPLIT() divide uma string em uma lista

• FIRST() e LAST() recuperam, respectivamente, o primeiro e o último elementos de uma lista

Combine essas funções para retornar o primeiro e o último elemento da lista de frutas:

{FIRST(SPLIT("Apple Banana Orange"," "))}
{LAST(SPLIT("Apple Banana Orange"," "))}

🚨 Mudanças que quebram compatibilidade

Para garantir uma transição suave para a sintaxe de expressão, é crucial abordar algumas mudanças que quebram compatibilidade e que podem impactar os fluxos atuais do seu bot.

Restrição de nomes de variáveis

Nomes de variáveis existentes como a-b, a b, número ou uso de '-' em Ir para variáveis não são mais compatíveis.

Por favor, certifique-se de ajustar seus nomes de variáveis de acordo com a nova sintaxe de expressão.

Requisito de identificador JavaScript

Apenas identificadores JavaScript válidos são suportados. Se suas variáveis não estiverem em conformidade, ajuste-as agora para evitar problemas. Consulte esta documentação para diretrizes detalhadas.

Remoção do| operador

O | o operador não é mais suportado. Se ele fizer parte do fluxo do seu bot, faça os ajustes necessários para alinhar-se com a nova sintaxe.

Antes da atualização, se o fluxo do seu bot envolvia o uso do operador |, ele poderia ser assim:

notUnderstoodCounter|increment

Com a atualização da sintaxe de expressão, o | operador não será mais suportado. Por favor, modifique o nome da sua variável.

JSON.stringif não mais compatível

Certifique-se de revisar suas variáveis anteriores e confirmar que nenhuma delas dependa de JSON.stringify. Por favor, use STRINGIFY ou TO_STRING em vez disso.