Usando Variáveis no Flow

No flow designer, em qualquer lugar onde seja possível escrever um texto (descrições, títulos, botões, checklists, condições, etc.) você pode usar variáveis que existem no seu fluxo e outra variáveis avançadas. Se você tiver um painel onde pergunta o nome da pessoa, por exemplo, e o identificador dessa informação é NAME. Você pode fazer referência à esse identificador em qualquer outro painel seguinte.

VARIÁVEIS DE AMBIENTE TO FLOW

Além das variáveis que você cria no próprio flow, você também pode usar variáveis avançadas. Vamos começar com as variáveis de ambiente do flow.

$FLOWPARAMETER
Essa variável contém o valor que for passado na URL com “par”. Vamos supor que você esteja rodando uma campanha de anúncios pagos no Facebook e no Google ao mesmo tempo e você queira saber qual foi a origem do clique. Você pode colocar na URL que chama o seu site conversacional, a origem no parâmetro “par”. Se o sua URL for https://cs.tyo.ai/meuanuncio, você teria no anúncio do Facebook https://cs.tyo.ai/meuanuncio?par=FACEBOOK e no anúncio do Google https://cs.tyo.ai/meuanuncio?par=GOOGLE. No seu flow você pode usar essa variável para adicionar uma tag no lead, por exemplo.

$FLOWSESSION
Essa variável contém um identificador único (UID) para a sessão do flow. A cada vez que alguém acessa o site conversacional uma nova sessão é criada. Você pode controlar a criação das sessões no painel de configuração do site conversacional. A FLOWSESSION pode ser usada para transferir uma sessão de um site conversacional para outro (desde que os 2 sites conversacionais estejam na mesma conta). Isso é útil quando você quer que o visitante passe para outro site conversacional, mas você queira usar informações que ele tenha respondido no site inicial. Para usar a FLOWSESSION, você deve criar uma ação de redirecionamento de URL no seu flow e passar a variável com o parâmetro “ses”. Exemplo: https://cs.tyo.ai/meusite2?ses=$FLOWSESSION.

$FLOWPOINTS
A FLOWPOINTS acumula o número de pontos que forem atribuídos nas respostas das interações. É muito útil para fazer um Quiz, por exemplo, e dar um resultado no final com base no total de pontos.


VARIÁVEIS CRMDATA

As variáveis CRMDATA são bastante úteis para uso em conteúdo que precise de dados do lead que estão no CRM. Essas variáveis podem até mesmo mostrar dados que ainda não foram efetivamente salvos no CRM. Inclusive é altamente recomendável usar o CRMDATA sempre que possível por causa da flexibilidade.

$CRMDATA.NAME
Contém o nome completo do lead quando disponível.

$CRMDATA.FNAME
Contém o primeiro nome do lead quando disponível. Mesmo que vc capture o nome do lead com um identificador NOME, por exemplo, e o lead forneça o nome completo, a CRMDATA.FNAME trará apenas o primeiro nome. Isso é importante para casos em que você queira chamar o lead apenas pelo primeiro nome em conversas, emails, etc.

$CRMDATA.LNAME
Contém o sobrenome do lead quando disponível.

$CRMDATA.EMAIL
Contém o email do lead quando disponível.

$CRMDATA.PHONE
Contém o telefone do lead quando disponível.

$CRMDATA.BUSINESS
Contém o nome da empresa do lead quando disponível.

$CRMDATA.ADDRESS
Contém o endereço do lead quando disponível.

$CRMDATA.CITY
Contém a cidade do lead quando disponível.

$CRMDATA.STATE
Contém o estado do lead quando disponível.

$CRMDATA.ZIPCODE
Contém o CEP do lead, quando disponível.

$CRMDATA.BIRTHDATE
Contém a data completa de nascimento do lead, quando disponível.

$CRMDATA.BIRTHDAY
Contém o dia de nascimento do lead, quando disponível.

$CRMDATA.BIRTHMONTH
Contém o mês de nascimento do lead, quando disponível.

$CRMDATA.BIRTHYEAR
Contém o ano de nascimento do lead, quando disponível.

$CRMDATA.MEMBERNAME
Contém o nome do membro do time (vendedor ou pessoa responsável pelo lead) quando disponível.

$CRMDATA.MEMBEREMAIL
Contém o email do membro do time (vendedor ou pessoa responsável pelo lead) quando disponível.

$CRMDATA.MEMBERPHONE
Contém o telefone do membro do time (vendedor ou pessoa responsável pelo lead) quando disponível.

$CRMDATA.QUALITY
Contém a qualidade do lead quando disponível.

$CRMDATA.STAGE
Contém o estágio do lead quando disponível.

$CRMDATA.TAGS
Contém as tags associadas ao lead quando disponível. As tags estarão separadas por vírgulas.

$CRMDATA.SNAPSHOT
Contém o resumo do campo “snapshot” do CRM quando disponível.

$CRMDATA.UID
Contém o identificador único do lead quando disponível. Este valor pode ser usado para passar o UID do lead para um flow com o parâmetro “ctt” e evitar que o lead tenha que informar dados de contato novamente. Um exemplo seria quando o lead se cadastra em um dos seus flows de captura de leads e depois você envia um email oferecendo para agendar uma consulta com você. Para agendar a consulta, você vai precisar dos dados de contato do lead. Neste caso, no link que você colocar no email o UID do contato é passado junto:

https://cs.tyo.ai/meuagendamento?ctt=$CRMDATA.UID

Quando o email é enviado, a variável $CRMDATA.UID é trocada pelo identificador do lead e você pode colocar uma lógica no seu flow de agendamento para checar se o lead já existe no CRM:

Neste caso, você terá acesso à todos os dados do lead no CRM para usar no seu flow como desejar.

VARIÁVEIS DA CONTA TAYON

Alguns dados da sua conta Tayon também estão disponíveis em variáveis. Essas informações podem ser úteis quando você cria flows que podem ser copiados para outras contas, como contas para clientes de agências. É uma forma de personalizar os flows com dados de contato, assinatura de emails, etc, sem precisar editar o flow após a cópia para uma nova conta.

$ACCOUNTNAME
Nome completo associado à conta.

$ACCOUNTFIRSTNAME
Primeiro nome associado à conta.

$ACCOUNTLASTNAME
Sobrenome associado à conta.

$ACCOUNTEMAIL
Email associado à conta.

$ACCOUNTPHONE
Telefone associado à conta.

$ACCOUNTSMSCREDITS
Quantidade de créditos disponíveis para envio de SMS ou mensagens de WhatsApp pela API oficial. Pode ser usado para lógica no flow, como por exemplo, se não houver créditos suficientes não programar o envio da mensagem para não gerar erro de envio.

VARIÁVEIS UTM

Variáveis do tipo UTM são enviadas por plataformas de anúncios como Google Ads ou Facebook Ads (Meta). As UTMs são um padrão de mercado e a Tayon permite que você receba esses valores em seus sites conversacionais e use para colocar tags ou realizar outras ações com seus leads.

As variáveis UTM disponíveis são:
$UTM_SOURCE
$UTM_CAMPAIGN
$UTM_CONTENT
$UTM_MEDIUM
$UTM_TERM

VARIÁVEIS FLOWASSIGNED

As variáveis FLOWASSIGNED representam os dados do Membro do Time que o lead estiver associado. Você pode usar, por exemplo, para personalizar envio de mensagens ou textos de painéis no seu flow.

As variáveis FLOWASSIGNED disponíveis são:

$FLOWASSIGNED.FNAME
Contém o primeiro nome do membro do time.

$FLOWASSIGNED.LNAME
Contém o sobrenome do membro do time.

$FLOWASSIGNED.EMAIL
Contém o email do membro do time.

$FLOWASSIGNED.PHONE
Contém o telefone do membro do time.