{"id":805,"date":"2025-02-25T00:41:28","date_gmt":"2025-02-25T00:41:28","guid":{"rendered":"https:\/\/tutorials.tayon.ai\/?post_type=tesserakb&p=805"},"modified":"2025-02-25T00:54:20","modified_gmt":"2025-02-25T00:54:20","slug":"using-variables-and-identifiers-on-your-flows","status":"publish","type":"tesserakb","link":"https:\/\/tutorials.tayon.ai\/?tesserakb=using-variables-and-identifiers-on-your-flows","title":{"rendered":"Using Variables and Identifiers on Your Flows"},"content":{"rendered":"\n

In the flow designer, anywhere it is possible to write text (descriptions, titles, buttons, checklists, conditions, etc.), you can use variables that exist in your flow and other advanced variables. If you have a panel where it asks for the person’s name, for example, and the identifier for that information is NAME, you can reference that identifier in any subsequent panel.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

FLOW ENVIRONMENT VARIABLES<\/h2>\n\n\n\n

In addition to the variables you create within the flow, you can also use advanced variables. Let’s start with the flow environment variables.<\/p>\n\n\n\n

$FLOWPARAMETER<\/strong>
This variable contains the value that is passed in the URL with \u201cpar\u201d. Suppose you are running a paid ad campaign on Facebook and Google at the same time and you want to know the origin of the click. You can include in the URL that calls your conversational site the origin in the parameter \u201cpar\u201d. If your URL is https:\/\/cs.tyo.ai\/meuanuncio, you would have in the Facebook ad https:\/\/cs.tyo.ai\/meuanuncio?par=FACEBOOK and in the Google ad https:\/\/cs.tyo.ai\/meuanuncio?par=GOOGLE. In your flow, you can use this variable to add a tag to the lead, for example.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

$FLOWSESSION<\/strong>
This variable contains a unique identifier (UID) for the flow session. Each time someone accesses the conversational site, a new session is created. You can control the creation of sessions in the conversational site\u2019s configuration panel. The FLOWSESSION can be used to transfer a session from one conversational site to another (as long as the two conversational sites are in the same account). This is useful when you want the visitor to move to another conversational site, but you want to use the information they provided on the initial site. To use FLOWSESSION, you must create a URL redirection action in your flow and pass the variable with the \u201cses\u201d parameter. Example: https:\/\/cs.tyo.ai\/meusite2?ses=$FLOWSESSION.
<\/p>\n\n\n\n

$FLOWPOINTS<\/strong>
FLOWPOINTS accumulates the number of points that are assigned in the responses of the interactions. It is very useful for making a quiz, for example, and providing a result at the end based on the total points.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

CRMDATA VARIABLES<\/h2>\n\n\n\n

CRMDATA variables are very useful for use in content that needs lead data from the CRM. These variables can even show data that has not yet been effectively saved in the CRM. It is even highly recommended to use CRMDATA whenever possible because of its flexibility.<\/p>\n\n\n\n

$CRMDATA.NAME<\/strong>
Contains the full name of the lead when available.<\/p>\n\n\n\n

$CRMDATA.FNAME<\/strong>
Contains the first name of the lead when available. Even if you capture the lead\u2019s name with an identifier like NOME, for example, and the lead provides the full name, CRMDATA.FNAME will bring only the first name. This is important for cases where you want to address the lead only by the first name in conversations, emails, etc.

$CRMDATA.LNAME<\/strong>
Contains the last name of the lead when available.<\/p>\n\n\n\n

$CRMDATA.EMAIL<\/strong>
Contains the lead’s email when available.<\/p>\n\n\n\n

$CRMDATA.PHONE<\/strong>
Contains the lead’s phone number when available.<\/p>\n\n\n\n

$CRMDATA.BUSINESS<\/strong>
Contains the lead’s company name when available.<\/p>\n\n\n\n

$CRMDATA.ADDRESS<\/strong>
Contains the lead’s address when available.<\/p>\n\n\n\n

$CRMDATA.CITY<\/strong>
Contains the lead’s city when available.<\/p>\n\n\n\n

$CRMDATA.STATE<\/strong>
Contains the lead’s state when available.<\/p>\n\n\n\n

$CRMDATA.ZIPCODE<\/strong>
Contains the lead’s postal code when available.<\/p>\n\n\n\n

$CRMDATA.BIRTHDATE<\/strong>
Contains the lead’s full birth date when available.<\/p>\n\n\n\n

$CRMDATA.BIRTHDAY<\/strong>
Contains the lead’s day of birth when available.<\/p>\n\n\n\n

$CRMDATA.BIRTHMONTH<\/strong>
Contains the lead’s birth month when available.<\/p>\n\n\n\n

$CRMDATA.BIRTHYEAR<\/strong>
Contains the lead’s birth year when available.<\/p>\n\n\n\n

$CRMDATA.MEMBERNAME<\/strong>
Contains the name of the team member (salesperson or person responsible for the lead) when available.<\/p>\n\n\n\n

$CRMDATA.MEMBEREMAIL<\/strong>
Contains the email of the team member (salesperson or person responsible for the lead) when available.<\/p>\n\n\n\n

$CRMDATA.MEMBERPHONE<\/strong>
Contains the phone number of the team member (salesperson or person responsible for the lead) when available.<\/p>\n\n\n\n

$CRMDATA.QUALITY<\/strong>
Contains the quality of the lead when available.<\/p>\n\n\n\n

$CRMDATA.STAGE<\/strong>
Contains the stage of the lead when available.<\/p>\n\n\n\n

$CRMDATA.TAGS<\/strong>
Contains the tags associated with the lead when available. The tags will be separated by commas.<\/p>\n\n\n\n

$CRMDATA.SNAPSHOT<\/strong>
Contains the summary of the CRM \u201csnapshot\u201d field when available.<\/p>\n\n\n\n

$CRMDATA.UID<\/strong>
Contains the unique identifier of the lead when available. This value can be used to pass the lead\u2019s UID to a flow with the \u201cctt\u201d parameter and avoid having the lead provide contact information again. An example would be when the lead registers in one of your lead capture flows and then you send an email offering to schedule a consultation with you. To schedule the consultation, you will need the lead’s contact details. In this case, in the link you include in the email, the contact\u2019s UID is passed along:<\/p>\n\n\n\n

https:\/\/cs.tyo.ai\/myschedule?ctt=$CRMDATA.UID<\/p>\n\n\n\n

When the email is sent, the variable $CRMDATA.UID is replaced by the lead\u2019s identifier and you can include logic in your scheduling flow to check if the lead already exists in the CRM.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n

In this case, you will have access to all the lead data in the CRM to use in your flow as desired.<\/p>\n\n\n\n

TAYON ACCOUNT VARIABLES<\/h2>\n\n\n\n

Some data from your Tayon account is also available in variables. This information can be useful when you create flows that can be copied to other accounts, such as accounts for agency clients. It is a way to personalize flows with contact details, email signatures, etc., without having to edit the flow after copying it to a new account.<\/p>\n\n\n\n

$ACCOUNTNAME<\/strong>
Full name associated with the account.<\/p>\n\n\n\n

$ACCOUNTFIRSTNAME<\/strong>
First name associated with the account.<\/p>\n\n\n\n

$ACCOUNTLASTNAME<\/strong>
Last name associated with the account.<\/p>\n\n\n\n

$ACCOUNTEMAIL<\/strong>
Email associated with the account.<\/p>\n\n\n\n

$ACCOUNTPHONE<\/strong>
Phone number associated with the account.<\/p>\n\n\n\n

$ACCOUNTSMSCREDITS<\/strong>
Amount of credits available for sending SMS or WhatsApp messages via the official API. It can be used for logic in the flow, such as, if there are not enough credits, do not schedule the sending of the message to avoid sending errors.<\/p>\n\n\n\n

UTM VARIABLES<\/h2>\n\n\n\n

UTM-type variables are sent by advertising platforms such as Google Ads or Facebook Ads (Meta). UTMs are an industry standard and Tayon allows you to receive these values in your conversational sites and use them to add tags or perform other actions with your leads.<\/p>\n\n\n\n

The available UTM variables are:
$UTM_SOURCE<\/strong>
$UTM_CAMPAIGN<\/strong>
$UTM_CONTENT<\/strong>
$UTM_MEDIUM<\/strong>
$UTM_TERM<\/strong><\/p>\n\n\n\n

FLOWASSIGNED VARIABLES<\/h2>\n\n\n\n

FLOWASSIGNED variables represent the data of the Team Member that the lead is associated with. You can use them, for example, to personalize message sending or text panels in your flow.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The available FLOWASSIGNED variables are:<\/p>\n\n\n\n

$FLOWASSIGNED.FNAME<\/strong>
Contains the first name of the team member.<\/p>\n\n\n\n

$FLOWASSIGNED.LNAME<\/strong>
Contains the last name of the team member.<\/p>\n\n\n\n

$FLOWASSIGNED.EMAIL<\/strong>
Contains the email of the team member.<\/p>\n\n\n\n

$FLOWASSIGNED.PHONE<\/strong>
Contains the phone number of the team member.<\/p>\n\n\n\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

In the flow designer, anywhere it is possible to write text (descriptions, titles, buttons, checklists, conditions, etc.), you can use variables that exist in your flow and other advanced variables. If you have a panel where it asks for the person’s name, for example, and the identifier for that information is NAME, you can reference…<\/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":[130,38],"tesserakbtags":[59,71,72,109,60,63,96],"class_list":["post-805","tesserakb","type-tesserakb","status-publish","format-standard","hentry","tesserakbcats-ai-agents","tesserakbcats-conversational-flows","tesserakbtags-automation","tesserakbtags-bot","tesserakbtags-conversational-flow","tesserakbtags-crm","tesserakbtags-flow","tesserakbtags-flow-designer","tesserakbtags-leads"],"_links":{"self":[{"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=\/wp\/v2\/tesserakb\/805","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=\/wp\/v2\/tesserakb"}],"about":[{"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=\/wp\/v2\/types\/tesserakb"}],"author":[{"embeddable":true,"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=805"}],"wp:attachment":[{"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=805"}],"wp:term":[{"taxonomy":"tesserakbcats","embeddable":true,"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Ftesserakbcats&post=805"},{"taxonomy":"tesserakbtags","embeddable":true,"href":"https:\/\/tutorials.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Ftesserakbtags&post=805"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}