Glossário de Variáveis

Giovana Borges Feitosa Atualizado por Giovana Borges Feitosa

Visão geral

As variáveis são locais criados para armazenar valores na plataforma, permitindo assim que os dados persistam mesmo após a finalização de um fluxo.

Para utilizar uma variável deve se colocar o @ e a expressão digitada será substituída pelo real valor da variável, desde que seja criada de forma adequada.

Abaixo, faremos uma lista de como se referenciar a todos os tipos de variáveis existentes no push, sendo eles:

  • Contatos e campos de contato
  • Resultados e fluxos
  • Globals

Contatos e campos de contato

  • @contact: variáveis para salvar valores ligados diretamente com o contato. Abaixo, segue a lista de sub-variáveis mais utilizadas:
    • @contact.name: Nome completo do contato;
    • @contact.first_name: Primeiro nome do contato;
    • @contact.urns: Lista de URNs do contato. Também pode ser acessado pelo @urns;
    • @contact.uuid: ID único do contato;
    • @contact.created_on: Data em que o contato foi criado;
    • @contact.language: Língua preferencial do contato;
    • @contact.channel: Nome do canal preferencial do contato;
    • @contact.groups: Nome dos grupos que o contato participa;
    • @contact.fields: Campos de contato personalizados do contato. Para acessar basta utilizar @contact.fields.nome_do_campo ou @fields.nome_do_campo.

Resultados e fluxos

  • @results: variáveis para salvar valores ligados diretamente aos resultados de fluxo. Para acessar um resultado basta utilizar @results.nome_do_resultado. Abaixo, segue a lista de sub-variáveis mais utilizadas:
    • @results.nome_do_resultado.category: categoria/rota a qual aquele resultado pertence;
    • @results.nome_do_resultado.value: valor de texto exato do resultado;
    • @results.nome_do_resultado.extra: valores além de texto que um resultado pode possuir, como anexos ou informações de requisição.
  • @input: variáveis que contêm o valor de entrada do contato. Abaixo, segue a lista de sub-variáveis mais utilizadas:
    • @input.text: Valor de texto inserido pelo contato em sua última interação com a plataforma.
    • @input.attachments: Anexos inseridos pelo contato em sua última interação com a plataforma.
  • @child: permite referenciar todas as variáveis do fluxo filho, ou seja, o fluxo que foi chamado pela carta de ação Enter a flow, dentro do fluxo pai. Caso você queira acessar um resultado do fluxo filho após a sua finalização, por exemplo, basta utilizar @child.results.nome_do_resultado. Ao utilizar outra carta de Enter a flow, o valor de @child é sobrescrito.

  • @parent: permite referenciar todas as variáveis do fluxo pai, ou seja, o fluxo que chamou a carta de ação Enter a flow, dentro do fluxo filho. Caso você queira acessar um resultado do fluxo pai durante a execução do fluxo filho, por exemplo, basta utilizar @parent.results.nome_do_resultado.

Globals

Variáveis globais, ou globals, são variáveis criadas que podem ser acessadas de qualquer fluxo, a qualquer momento, porém não podem ter o seu valor modificado durante uma execução de fluxo. São muito utilizadas quando precisamos mandar a mesma informação para vários fluxos diferentes, e depois precisamos modificar esse valor de forma prática para todos os fluxos onde ela está inserida.

Para criar uma global, basta ir para as configurações gerais de sua organização e descer até o fim da página, onde você irá encontrar a aba para as globals.

Após isso, basta clicar em Criar Global, digitar o nome da global que você deseja juntamente com o valor.

Assim, ela vai se tornar acessível em qualquer fluxo através da variável @globals.nome_da_global

Como a gente se saiu?

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

Glossário de Expressões

Contato