{"section":"tutorials","requestedLocale":"pt","requestedSlug":"introducao-a-expressoes-e-variaveis","locale":"pt","slug":"introducao-a-expressoes-e-variaveis","path":"docs/pt/tutorials/weni-by-vtex/fluxos/introducao-a-expressoes-e-variaveis.md","branch":"main","content":"A criação de um fluxo é feita visando conectar um conjunto de ações por completo a fim de obter algum resultado.\n\nAs variáveis servem justamente para armazenar os valores e resultados dessas etapas, para persistir os dados. Por exemplo, a opção **Aguarde por Resposta** abaixo gerará uma variável de fluxo denominada _nome_ como resposta do contato. Além disso, a variável será usada para salvar os dados no campo de contato _Nome_.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/fluxos/introducao-a-expressoes-e-variaveis_1.png)\n\nVariáveis começam com o símbolo @. Porém, você também pode avançar para as expressões de uso mais complexo, utilizando `@( `. As expressões são modeladas dentro de sintaxes específicas e a sua ideia é tratar dados para manipular as variáveis salvas pela plataforma.\n\nAo usar variáveis de fluxo, também é possível especificar sub-tópicos que você deseja. Veja o exemplo abaixo:\n\n- `@results.gender.category` retorna a categoria em que a resposta dos contatos foi localizada;\n- `@results.gender.value` retorna a resposta completa dada pelo usuário;\n\nTodas as variáveis e expressões apresentam o seu real valor quando o contato está ativo no fluxo. Se você digitar uma variável ou expressão de forma incorreta, a mensagem não será substituída e a fórmula errada será exibida ao usuário.\n\n## Outras variáveis\n\nAlém da expressão `@results` existem também outras expressões que usamos bastante, são elas:\n\n### `@Contact`\n\nEssa expressão é usada para resgatar valores salvos em campos de contatos **padr ão** na Weni Plataforma e são atualizados através do cartão Update Contact (Atualizar o Contato). Exemplos:\n\n- `@contact.name:`Nome do contato\n- `@contact.first_name:`Primeiro nome do contato\n\n### `@Fields`\n\nEssa expressão é usada para resgatar valores salvos em campos de contatos que **n ão são padrões** na Weni Plataforma, através do cartão Update Contact (Atualizar o Contato). Campos de contato são muito utilizados para armazenar informações gerais sobre o contato, pois essas informações podem ser resgatadas em qualquer fluxo usando a expressão `@fields.`⁣, por exemplo:\n\n- `@fields.idade:`Idade do contato\n- `@fields.email:`Email do contato, caso esteja sendo salvo em campo de contato ao invés de URN\n\n### `@Urns`\n\nEssa expressão é usada para resgatar o identificador do canal principal do contato na Weni Plataforma (se o projeto não for anônimo), por exemplo:\n\n- `@urns.whatsapp:`Número do WhatsApp\n- `@urns.mailto:`Email do contato\n\n### `@Webhook`\n\nEssa expressão é usada para resgatar valores retornados da última chamada webhook feita no fluxo, por exemplo:\n\n- `@webhook.results.cliente:`Nome do cliente retornado da API, caso retorne somente 1 objeto\n- `@webhook.results.0.cliente:`Nome do cliente retornado da API. Caso retorne em array é necessário dizer a posição do array que deseja na expressão, usando 0, 1, 2 e assim por diante.\n\nPara entender mais sobre expressões, assista nosso [Weni Responde sobre esse assunto](https://comunidade.weni.ai/t/expressoes-e-variaveis/248)."}