Introdução a expressões e variáveis

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.