# Sintaxe de expressões 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.

Exemplo de sintaxe de expressão dentro de uma mensagem de texto.

{% hint style="warning" %} Por favor, note que **a sintaxe de expressão precisa ser habilitada na sua conta**. Para habilitar a sintaxe de expressão na sua conta, por favor [entre em contato com o suporte](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/support/get-in-touch).. {% endhint %} {% hint style="danger" %} Por favor, esteja também ciente sobre as [**mudanças que quebram compatibilidade**](#breaking-changes) ocorrendo para bots existentes. {% endhint %} 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. {% hint style="info" %} Neste artigo, o termo 'expressão' refere-se à combinação de identificadores usando funções, operadores, constantes e valores ao programar. Portanto, não deve ser confundido com o conceito de [expressões](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/intents) no seu modelo de PNL. {% endhint %} ## Como usar a sintaxe de expressão A sintaxe de expressão pode ser usada dentro de [Passos de Texto](#text-step) e [Condições](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins), usando [tipos de dados](#data-types), [operadores](#operators) e [funções](#functions). ### Use funções da sintaxe no seu bot Para usar a sintaxe de expressão no seu chatbot: 1. Abra seu [bloco](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state). 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.

Use funções da sintaxe de expressão dentro de um passo de Texto

Use variável da sintaxe de expressão dentro de um passo de Texto

#### **Bloco de Condição** Use a sintaxe de expressão dentro de uma [bloco de Condição](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins) declaração como um [variável](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/settings/secure-variables-gdpr).

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

Leia abaixo para exemplos de casos de uso: * [Obter a hora atual](#get-the-current-time) * [Converter para minúsculas](#downcase) * [Criar uma lista](#create-a-list) ### **Funções** Funções, sejam [internas](#built-in-functions) ou [personalizadas](#custom-functions), 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:

Nome	Resumo	Exemplo
ABS	Retorna o valor absoluto de um número.	operação: (n: any) => Math.abs(n)
APPEND	Adiciona um ou mais itens ao final de uma lista.	operação: (arr: any, ...items: any[]) => arr.concat(...items)
BASE64_DECODE	Decodifica texto codificado em Base64.	operação: (text: any) => Buffer.from(text, 'base64').toString('utf8')
BASE64_ENCODE	Codifica texto usando o algoritmo de codificação Base64.	operação: (text: any) => Buffer.from(text + '', 'utf8').toString('base64')
CAPITALIZE	Torna a primeira letra do texto maiúscula e converte os caracteres restantes para minúsculas.	operação: (value: any) => lodash.capitalize(value)
CEIL	Arredonda para cima e retorna o menor inteiro maior ou igual a um dado número.	operação: (n: any) => Math.ceil(n)
DAY	Retorna o dia a partir da data fornecida ou o dia atual se nenhuma data for fornecida (1-12).	operação: (d: any) => DateTime.fromMillis(d \|\| DateTime.now().toMillis()).day
DOWNCASE	Converte cada caractere do texto para minúsculo.	operação: (value: any) => lodash.toLower(value)
FIRST	Retorna o primeiro elemento de uma lista.	operação: (value: any) => lodash.first(value)
FLOOR	Arredonda para baixo e retorna o maior inteiro menor ou igual a um dado número.	operação: (n: any) => Math.floor(n)
FORMAT	Retorna a data formatada de acordo com a string de formato.	operação: (d: any, format: any, locale: any) => DateTime.fromMillis(d).toFormat(format, { locale: locale \|\| 'en' })
HOUR	Retorna a hora a partir da data fornecida ou a hora atual se nenhuma data for fornecida (0-23).	operação: (d: any) => DateTime.fromMillis(d \|\| DateTime.now().toMillis()).hour
INCLUDES	Retorna TRUE se o alvo (que pode ser texto, um objeto ou um array) inclui o valor, caso contrário retorna FALSE.	operação: (haystack: any, needle: string) => lodash.includes(haystack, needle)
JSON_PARSE	Analisa um valor JSON serializado.	operação: (value: any) => JSON.parse(value)
LAST	Retorna o último elemento de uma lista.	operação: (value: any) => lodash.last(value)
MAX	Retorna o valor máximo a partir dos argumentos fornecidos.	operação: (...args: any) => Math.max(...args)
MD5	Calcula o hash MD5 codificado em hexadecimal de um texto.	operação: (t: any) => crypto.createHash('md5').update(t + '').digest('hex')
MINUTE	Retorna o minuto a partir da data fornecida ou o minuto atual se nenhuma data for fornecida (0-59).	operação: (d: any) => DateTime.fromMillis(d \|\| DateTime.now().toMillis()).minute
MONTH	Retorna o mês a partir da data fornecida ou o mês atual se nenhuma data for fornecida (1-12).	operação: (d: any) => DateTime.fromMillis(d \|\| DateTime.now().toMillis()).month
NOW	Retorna a data e hora atuais.	operação: () => DateTime.now().toMillis()
PARSE	Analisa uma data formatada de acordo com a string de formato.	operação: (d: string, format: any, locale: any) => DateTime.fromFormat(d, format, { locale }).toMillis()
ROUND	Retorna o valor de um número arredondado para a precisão mais próxima.	operação: (n: any, precision = 0) => Math.round(n * Math.pow(10, precision)) / Math.pow(10, precision)
SPLIT	Divide o texto de entrada em uma lista usando o delimitador como separador.	operação: (text: any, delimiter: any) => (text + '').split(delimiter + '')
STRINGIFY	Serializa um valor em uma string JSON.	operação: (value: any) => stringify(value, null, 0)
TODAY	Retorna a data de hoje com a hora definida para 00:00.	operação: () => DateTime.now().startOf('day').toMillis()
TOMORROW	Retorna a data de amanhã com a hora definida para 00:00.	operação: () => DateTime.now().startOf('day').plus({ days: 1 }).toMillis()
TO_NUMBER	Converte um valor para número.	operação: (value: any) => value - 0
TO_STRING	Converte um valor para string.	operação: (value: any) => value?.toString()
UUID	Gera um identificador único universal (V4).	operação: () => uuid()
WEEKDAY	Obtém o dia da semana. 1 é segunda-feira e 7 é domingo.	operação: (d: any) => DateTime.fromMillis(d \|\| DateTime.now().toMillis()).weekday
YEAR	Retorna o ano da data fornecida ou o mês atual se nenhuma data for fornecida.	operação: (d: any) => DateTime.fromMillis(d \|\| DateTime.now().toMillis()).year
YESTERDAY	Retorna a data de ontem com a hora definida para 00:00.	operação: () => DateTime.now().startOf('day').plus({ days: -1 }).toMillis()

#### **Funções personalizadas** Você pode criar suas próprias [funções](#functions) como desejar, usando as [operadores](#operators). 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.

Precedência	Operador	Descrição	Associatividade
1	()	Chamada de função	Esquerda-para-direita
	.	Nome qualificado ou acesso a campo
	[]	Indexação
2	- (unário)	Negação	Direita-para-esquerda
	!	NOT lógico
3	*	Multiplicação	Esquerda-para-direita
	/	Divisão
	%	Resto
4	+	Adição
	- (binário)	Subtração
5	== != < > <= >=	Relações
6	&&	E lógico
7	?:	Condicional	Direita-para-esquerda

### **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: ```javascript {FORMAT(NOW(), "T")} ``` {% hint style="info" %} Para saber mais sobre formatação de tempo, dê uma olhada em [esta tabela](https://moment.github.io/luxon/#/formatting?id=table-of-tokens). {% endhint %}

Use a sintaxe de expressão para retornar a hora atual dentro de uma conversa.

#### 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: ```jsx {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.

Use uma expressão personalizada para obter a hora atual no fuso horário do seu cliente.

### 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: ```javascript DOWNCASE(@userName) ```

Use a sintaxe de expressão para padronizar a entrada do usuário.

### 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: ```javascript "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: ```jsx {FIRST(SPLIT("Apple Banana Orange"," "))} {LAST(SPLIT("Apple Banana Orange"," "))} ```

Recupere elementos de lista usando a sintaxe de expressão.

## 🚨 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.

Exemplos de nomes de variáveis que não são mais compatíveis com a 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](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Grammar_and_types) 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.