Skip to main content

Documentation Index

Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

System Fields are variables in the format {{field_name}} that ChatbotX collects and updates automatically. You can use them to insert contact details, account data, ad source information, or conversation context into a Flow without creating those values manually. Some variables may not appear in the suggestion list when you configure a Flow. You can still use them by typing the exact variable syntax manually. This document focuses on the supported System Fields covered in the four groups below.

​
Contacts Fields

These fields store contact details, interaction history, and conversation context.
FieldMeaning and usage
{{first_name}}The contact’s first name.
{{last_name}}The contact’s last name.
{{full_name}}The contact’s full name.
{{email}}The contact’s email address.
{{phone}}The contact’s phone number.
{{user_country}}The contact’s country.
{{user_state}}The contact’s state, province, or region.
{{user_city}}The contact’s city.
{{inbox_link}}The link to the inbox on Chatrace.
{{gender}}The contact’s gender.
{{locale}}User language. Example: en_US.
{{locale2}}User language in short format. Example: en.
{{ig_user_name}}The Instagram user name.
{{ig_followers}}The Instagram follower count for the user.
{{ig_verified}}The verification status for the user on Instagram.
{{ig_follow_business}}Indicates whether the user follows the business on Instagram.
{{ig_business_follow_user}}Indicates whether the business follows the user on Instagram.
{{profile_pic}}The contact’s profile picture URL.
{{timezone}}Timezone offset, such as +2.
{{timezone_name}}The timezone name. Example: America/New_York.
{{user_id}}The contact user ID on Chatrace. Use this ID in the API.
{{subscribed_date}}The date when the contact was created.
{{fb_chat_link}}The direct link to the contact’s Facebook Inbox.
{{me}}A link where users can view and delete their data to help support GDPR compliance.
{{user_code}}The contact’s user code.
{{last_btn_title}}The title of the last button the user clicked.
{{last_interaction}}The time of the most recent interaction.
{{last_order}}The contact’s most recent order information.
{{last_seen}}The last recorded time the contact was seen.
{{last_input}}The last text, image, video, audio, file, or voice message sent by the user.
{{last_input_type}}The type of the last input: text, image, video, audio, file, reel.
{{consecutive_failed_reply}}The number of consecutive failed replies from the user.
{{last_ref}}The last entry point link clicked by the user.
{{user_channel}}The user’s primary channel.
{{user_hash}}The user’s hash identifier.
{{user_tags}}Contains the names of all tags applied to the contact.
{{user_external_id}}The Viber user ID.
{{user_source}}The user source, such as Ads, Facebook/IG comment, Direct, Imported, API, Inbound Message, or Unknown.
{{assigned_admin_name}}The name of the assigned admin.
{{assigned_admin_email}}The email of the assigned admin.
{{assigned_admin_id}}The ID of the assigned admin.
{{current_user_time}}The user’s current local time.
{{chat_history}}Returns the last 50 messages between the user and the business.
{{chat_history_large}}Returns the last 200 messages between the user and the business.
{{chat_history_details}}Like {{chat_history}}, but it also includes who sent each message.
{{chat_history_details_large}}Like {{chat_history_details}}, but it returns the last 200 messages.
{{user_notes}}The notes added to the user.
{{last_user_note}}The last note added to the user.
{{webchat}}A link that allows the user to continue the conversation from any channel in Webchat.
{{webchat_parent_url}}The URL of the page where Webchat is loaded.

​
Account Fields

These fields return information about your ChatbotX account.
FieldMeaning and usage
{{account_id}}The account ID.
{{account_name}}The account name.
{{account_image}}The account image.
{{api_key}}The API key of your account.

​
Ads Fields

These fields identify the most recent ad or ad source that brought the user into the conversation.
FieldMeaning and usage
{{last_ad}}The ID of the last Facebook ad the user clicked before reaching your bot.
{{last_ctwa}}The ID of the last Click-to-WhatsApp action that opened the chat.
{{last_ad_source_url}}The link to the ad the user clicked.
{{last_ad_source_platform}}The platform where the user clicked the ad, such as Facebook or Instagram.

​
Other Fields

These fields describe the previous step, current step, and inbox sender context.
FieldMeaning and usage
{{last_step}}Includes the STEP ID of the previous executed step. Works only in published Flows.
{{current_step}}Includes the STEP ID of the current active step. Works only in published Flows.
{{member_name}}Includes the member name that sends the message or Flow from the inbox.
{{team_name}}Includes the names of all teams the member is part of when they send a message or Flow from the inbox.
{{last_input_failure}}Includes the reason GET USER DATA failed. Possible values are timeout, user_skipped, invalid_input_attempts.
Tip: If a System Field is not shown in the suggestion list, you can still type it directly into a Flow. For example, if you want to save {{ig_followers}} or {{chat_history}} into a temporary Custom Field for later use, create an empty Custom Field and enter the System Field directly in the value box. The system will resolve that variable when the Flow runs.