Índice
Introdução a expressões e variáveis
Atualizado
por Sarah Pinheiro
A criação de um fluxo é feita com o objetivo de conectar um conjunto de ações por completo afim de obter algum resultado.
As variáveis servem justamente para armazenar os valores e resultados dessas etapas, de forma a persistir os dados. Por exemplo, a opção Wait for Response (Aguardar Resposta) abaixo gerará uma variável de fluxo denominada name como resposta do contato. Além disso, a variável será usada para salvar os dados no campo de contato Name.

Variá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.
Ao usar variáveis de fluxo, também é possível especificar sub-tópicos que você deseja. Veja o exemplo abaixo:
@results.gender.category
retorna a categoria em que a resposta dos contatos foi localizada;@results.gender.value
retorna a resposta completa dada pelo usuário;
Todas 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 formula errada será exibida ao usuário.
Outras variáveis
Além da expressão @results
existem também outras expressões que usamos bastante, são elas:
@contact
Essa 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:
@contact.name:
Nome do contato@contact.first_name:
Primeiro nome do contato
@fields
Essa expressão é usada para resgatar valores salvos em campos de contatos que não são padrão 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:
@fields.idade:
Idade do contato@fields.email:
Email do contato, caso esteja sendo salvo em campo de contato ao invés de URN
@urns
Essa 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:
@urns.whatsapp:
Número do Whatsapp@urns.mailto:
Email do contato
@webhook
Essa expressão é usada para resgatar valores retornados da ultima chamada webhook feita no fluxo, por exemplo:
@webhook.results.cliente:
Nome do cliente retornado da API, caso retorne somente 1 objeto@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.
Para entender mais sobre expressões, assista nosso Weni Responde sobre esse assunto.