{"id":899,"date":"2024-11-01T20:49:55","date_gmt":"2024-11-01T20:49:55","guid":{"rendered":"https:\/\/tutoriais.tayon.ai\/?post_type=tesserakb&#038;p=899"},"modified":"2024-11-13T00:32:14","modified_gmt":"2024-11-13T00:32:14","slug":"usando-variaveis-no-flow","status":"publish","type":"tesserakb","link":"https:\/\/tutoriais.tayon.ai\/?tesserakb=usando-variaveis-no-flow","title":{"rendered":"Usando Vari\u00e1veis no Flow"},"content":{"rendered":"\n<p>No flow designer, em qualquer lugar onde seja poss\u00edvel escrever um texto (descri\u00e7\u00f5es, t\u00edtulos, bot\u00f5es, checklists, condi\u00e7\u00f5es, etc.) voc\u00ea pode usar vari\u00e1veis que existem no seu fluxo e outra vari\u00e1veis avan\u00e7adas. Se voc\u00ea tiver um painel onde pergunta o nome da pessoa, por exemplo, e o identificador dessa informa\u00e7\u00e3o \u00e9 NAME. Voc\u00ea pode fazer refer\u00eancia \u00e0 esse identificador em qualquer outro painel seguinte.<br><br><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"637\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/usodevariaveis-1024x637.jpg\" alt=\"\" class=\"wp-image-900\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/usodevariaveis-1024x637.jpg 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/usodevariaveis-300x187.jpg 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/usodevariaveis-768x478.jpg 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/usodevariaveis-1536x955.jpg 1536w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/usodevariaveis-2048x1274.jpg 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">VARI\u00c1VEIS DE AMBIENTE TO FLOW<\/h2>\n\n\n\n<p>Al\u00e9m das vari\u00e1veis que voc\u00ea cria no pr\u00f3prio flow, voc\u00ea tamb\u00e9m pode usar vari\u00e1veis avan\u00e7adas. Vamos come\u00e7ar com as vari\u00e1veis de ambiente do flow.<br><br>$<strong>FLOWPARAMETER<\/strong><br>Essa vari\u00e1vel cont\u00e9m o valor que for passado na URL com &#8220;par&#8221;. Vamos supor que voc\u00ea esteja rodando uma campanha de an\u00fancios pagos no Facebook e no Google ao mesmo tempo e voc\u00ea queira saber qual foi a origem do clique. Voc\u00ea pode colocar na URL que chama o seu site conversacional, a origem no par\u00e2metro &#8220;par&#8221;. Se o sua URL for https:\/\/cs.tyo.ai\/meuanuncio, voc\u00ea teria no an\u00fancio do Facebook https:\/\/cs.tyo.ai\/meuanuncio?par=FACEBOOK e no an\u00fancio do Google https:\/\/cs.tyo.ai\/meuanuncio?par=GOOGLE. No seu flow voc\u00ea pode usar essa vari\u00e1vel para adicionar uma tag no lead, por exemplo.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"753\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowparameter-1024x753.jpg\" alt=\"\" class=\"wp-image-901\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowparameter-1024x753.jpg 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowparameter-300x221.jpg 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowparameter-768x564.jpg 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowparameter.jpg 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>$<strong>FLOWSESSION<\/strong><br>Essa vari\u00e1vel cont\u00e9m um identificador \u00fanico (UID) para a sess\u00e3o do flow. A cada vez que algu\u00e9m acessa o site conversacional uma nova sess\u00e3o \u00e9 criada. Voc\u00ea pode controlar a cria\u00e7\u00e3o das sess\u00f5es no painel de configura\u00e7\u00e3o do site conversacional. A FLOWSESSION pode ser usada para transferir uma sess\u00e3o de um site conversacional para outro (desde que os 2 sites conversacionais estejam na mesma conta). Isso \u00e9 \u00fatil quando voc\u00ea quer que o visitante passe para outro site conversacional, mas voc\u00ea queira usar informa\u00e7\u00f5es que ele tenha respondido no site inicial. Para usar a FLOWSESSION, voc\u00ea deve criar uma a\u00e7\u00e3o de redirecionamento de URL no seu flow e passar a vari\u00e1vel com o par\u00e2metro &#8220;ses&#8221;. Exemplo: https:\/\/cs.tyo.ai\/meusite2?ses=$FLOWSESSION.<\/p>\n\n\n\n<p>$<strong>FLOWPOINTS<\/strong><br>A FLOWPOINTS acumula o n\u00famero de pontos que forem atribu\u00eddos nas respostas das intera\u00e7\u00f5es. \u00c9 muito \u00fatil para fazer um Quiz, por exemplo, e dar um resultado no final com base no total de pontos.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"634\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowpoints-1024x634.png\" alt=\"\" class=\"wp-image-902\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowpoints-1024x634.png 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowpoints-300x186.png 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowpoints-768x476.png 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowpoints.png 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><br><strong>VARI\u00c1VEIS CRMDATA<\/strong><\/h2>\n\n\n\n<p>As vari\u00e1veis CRMDATA s\u00e3o bastante \u00fateis para uso em conte\u00fado que precise de dados do lead que est\u00e3o no CRM. Essas vari\u00e1veis podem at\u00e9 mesmo mostrar dados que ainda n\u00e3o foram efetivamente salvos no CRM. Inclusive \u00e9 altamente recomend\u00e1vel usar o CRMDATA sempre que poss\u00edvel por causa da flexibilidade.<br><br><strong>$CRMDATA.NAME<br><\/strong>Cont\u00e9m o nome completo do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.FNAME<\/strong><br>Cont\u00e9m o primeiro nome do lead quando dispon\u00edvel. Mesmo que vc capture o nome do lead com um identificador NOME, por exemplo, e o lead forne\u00e7a o nome completo, a CRMDATA.FNAME trar\u00e1 apenas o primeiro nome. Isso \u00e9 importante para casos em que voc\u00ea queira chamar o lead apenas pelo primeiro nome em conversas, emails, etc.<br><br>$<strong>CRMDATA.LNAME<\/strong><br>Cont\u00e9m o sobrenome do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.EMAIL<\/strong><br>Cont\u00e9m o email do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.PHONE<\/strong><br>Cont\u00e9m o telefone do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.BUSINESS<\/strong><br>Cont\u00e9m o nome da empresa do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.ADDRESS<br><\/strong>Cont\u00e9m o endere\u00e7o do lead quando dispon\u00edvel.<\/p>\n\n\n\n<p>$<strong>CRMDATA.CITY<\/strong><br>Cont\u00e9m a cidade do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.STATE<\/strong><br>Cont\u00e9m o estado do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.ZIPCODE<\/strong><br>Cont\u00e9m o CEP do lead, quando dispon\u00edvel.<br><br>$<strong>CRMDATA.BIRTHDATE<\/strong><br>Cont\u00e9m a data completa de nascimento do lead, quando dispon\u00edvel.<br><br>$<strong>CRMDATA.BIRTHDAY<\/strong><br>Cont\u00e9m o dia de nascimento do lead, quando dispon\u00edvel.<br><br>$<strong>CRMDATA.BIRTHMONTH<\/strong><br>Cont\u00e9m o m\u00eas de nascimento do lead, quando dispon\u00edvel.<br><br>$<strong>CRMDATA.BIRTHYEAR<\/strong><br>Cont\u00e9m o ano de nascimento do lead, quando dispon\u00edvel. <br><br>$<strong>CRMDATA.MEMBERNAME<\/strong><br>Cont\u00e9m o nome do membro do time (vendedor ou pessoa respons\u00e1vel pelo lead) quando dispon\u00edvel.<br><br>$<strong>CRMDATA.MEMBEREMAIL<\/strong><br>Cont\u00e9m o email do membro do time (vendedor ou pessoa respons\u00e1vel pelo lead) quando dispon\u00edvel.<\/p>\n\n\n\n<p>$<strong>CRMDATA.MEMBERPHONE<\/strong><br>Cont\u00e9m o telefone do membro do time (vendedor ou pessoa respons\u00e1vel pelo lead) quando dispon\u00edvel.<\/p>\n\n\n\n<p>$<strong>CRMDATA.QUALITY<\/strong><br>Cont\u00e9m a qualidade do lead quando dispon\u00edvel.<\/p>\n\n\n\n<p>$<strong>CRMDATA.STAGE<\/strong><br>Cont\u00e9m o est\u00e1gio do lead quando dispon\u00edvel.<br><br>$<strong>CRMDATA.TAGS<\/strong><br>Cont\u00e9m as tags associadas ao lead quando dispon\u00edvel. As tags estar\u00e3o separadas por v\u00edrgulas.<br><br>$<strong>CRMDATA.SNAPSHOT<\/strong><br>Cont\u00e9m o resumo do campo &#8220;snapshot&#8221; do CRM quando dispon\u00edvel.<br><br>$<strong>CRMDATA.UID<\/strong><br>Cont\u00e9m o identificador \u00fanico do lead quando dispon\u00edvel. Este valor pode ser usado para passar o UID do lead para um flow com o par\u00e2metro &#8220;ctt&#8221; 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\u00ea envia um email oferecendo para agendar uma consulta com voc\u00ea. Para agendar a consulta, voc\u00ea vai precisar dos dados de contato do lead. Neste caso, no link que voc\u00ea colocar no email o UID do contato \u00e9 passado junto: <br><br>https:\/\/cs.tyo.ai\/meuagendamento?ctt=$CRMDATA.UID<br><br>Quando o email \u00e9 enviado, a vari\u00e1vel $CRMDATA.UID \u00e9 trocada pelo identificador do lead e voc\u00ea pode colocar uma l\u00f3gica no seu flow de agendamento para checar se o lead j\u00e1 existe no CRM:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"524\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced-1024x524.png\" alt=\"\" class=\"wp-image-906\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced-1024x524.png 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced-300x154.png 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced-768x393.png 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced.png 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"422\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced2-1024x422.png\" alt=\"\" class=\"wp-image-907\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced2-1024x422.png 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced2-300x124.png 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced2-768x317.png 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/splitadvanced2.png 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"642\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/crmuid-1024x642.png\" alt=\"\" class=\"wp-image-903\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/crmuid-1024x642.png 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/crmuid-300x188.png 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/crmuid-768x481.png 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/crmuid.png 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Neste caso, voc\u00ea ter\u00e1 acesso \u00e0 todos os dados do lead no CRM para usar no seu flow como desejar.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">VARI\u00c1VEIS DA CONTA TAYON<\/h2>\n\n\n\n<p>Alguns dados da sua conta Tayon tamb\u00e9m est\u00e3o dispon\u00edveis em vari\u00e1veis. Essas informa\u00e7\u00f5es podem ser \u00fateis quando voc\u00ea cria flows que podem ser copiados para outras contas, como contas para clientes de ag\u00eancias. \u00c9 uma forma de personalizar os flows com dados de contato, assinatura de emails, etc, sem precisar editar o flow ap\u00f3s a c\u00f3pia para uma nova conta.<br><br>$<strong>ACCOUNTNAME<\/strong><br>Nome completo associado \u00e0 conta.<br><br>$<strong>ACCOUNTFIRSTNAME<\/strong><br>Primeiro nome associado \u00e0 conta.<br><br>$<strong>ACCOUNTLASTNAME<\/strong><br>Sobrenome associado \u00e0 conta.<br><br>$<strong>ACCOUNTEMAIL<\/strong><br>Email associado \u00e0 conta.<br><br>$<strong>ACCOUNTPHONE<\/strong><br>Telefone associado \u00e0 conta.<br><br>$<strong>ACCOUNTSMSCREDITS<\/strong><br>Quantidade de cr\u00e9ditos dispon\u00edveis para envio de SMS ou mensagens de WhatsApp pela API oficial. Pode ser usado para l\u00f3gica no flow, como por exemplo, se n\u00e3o houver cr\u00e9ditos suficientes n\u00e3o programar o envio da mensagem para n\u00e3o gerar erro de envio.<br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">VARI\u00c1VEIS UTM<\/h2>\n\n\n\n<p>Vari\u00e1veis do tipo UTM s\u00e3o enviadas por plataformas de an\u00fancios como Google Ads ou Facebook Ads (Meta). As UTMs s\u00e3o um padr\u00e3o de mercado e a Tayon permite que voc\u00ea receba esses valores em seus sites conversacionais e use para colocar tags ou realizar outras a\u00e7\u00f5es com seus leads.<br><br>As vari\u00e1veis UTM dispon\u00edveis s\u00e3o: <br><strong>$UTM_SOURCE<br>$UTM_CAMPAIGN<br>$UTM_CONTENT<br>$UTM_MEDIUM<br>$UTM_TERM<\/strong><br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">VARI\u00c1VEIS FLOWASSIGNED<\/h2>\n\n\n\n<p>As vari\u00e1veis FLOWASSIGNED representam os dados do Membro do Time que o lead estiver associado. Voc\u00ea pode usar, por exemplo, para personalizar envio de mensagens ou textos de pain\u00e9is no seu flow.<br><br><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"625\" src=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowassigned-1024x625.png\" alt=\"\" class=\"wp-image-904\" srcset=\"https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowassigned-1024x625.png 1024w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowassigned-300x183.png 300w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowassigned-768x469.png 768w, https:\/\/tutoriais.tayon.ai\/wp-content\/uploads\/2024\/11\/flowassigned.png 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>As vari\u00e1veis FLOWASSIGNED dispon\u00edveis s\u00e3o:<br><br>$<strong>FLOWASSIGNED.FNAME<br><\/strong>Cont\u00e9m o primeiro nome do membro do time.<br><br>$<strong>FLOWASSIGNED.LNAME<\/strong><br>Cont\u00e9m o sobrenome do membro do time.<br><br>$<strong>FLOWASSIGNED.EMAIL<\/strong><br>Cont\u00e9m o email do membro do time.<br><br>$<strong>FLOWASSIGNED.PHONE<br><\/strong>Cont\u00e9m o telefone do membro do time.<br><\/p>\n","protected":false},"excerpt":{"rendered":"<p>No flow designer, em qualquer lugar onde seja poss\u00edvel escrever um texto (descri\u00e7\u00f5es, t\u00edtulos, bot\u00f5es, checklists, condi\u00e7\u00f5es, etc.) voc\u00ea pode usar vari\u00e1veis que existem no seu fluxo e outra vari\u00e1veis avan\u00e7adas. Se voc\u00ea tiver um painel onde pergunta o nome da pessoa, por exemplo, e o identificador dessa informa\u00e7\u00e3o \u00e9 NAME. Voc\u00ea pode fazer refer\u00eancia&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"tessera_post_format_link":""},"tesserakbcats":[38],"tesserakbtags":[61,63,60,72],"class_list":["post-899","tesserakb","type-tesserakb","status-publish","format-standard","hentry","tesserakbcats-conversational-flows","tesserakbtags-conversations","tesserakbtags-flow-designer","tesserakbtags-flow","tesserakbtags-conversational-flow"],"_links":{"self":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/tesserakb\/899","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/tesserakb"}],"about":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/types\/tesserakb"}],"author":[{"embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=899"}],"wp:attachment":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=899"}],"wp:term":[{"taxonomy":"tesserakbcats","embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Ftesserakbcats&post=899"},{"taxonomy":"tesserakbtags","embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Ftesserakbtags&post=899"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}