System Fields

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.

Contacts Fields

These fields store contact profile details, location, interaction history, and conversation history.

Field	Meaning 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.
`{{gender}}`	The contact’s gender.
`{{avatar}}`	Profile picture URL of the contact (alias for `{{profile_pic}}`).
`{{profile_pic}}`	The contact’s profile picture URL.
`{{user_country}}`	The contact’s country.
`{{user_state}}`	The contact’s state, province, or region.
`{{user_city}}`	The contact’s city.
`{{last_latitude}}`	The latest recorded latitude of the contact’s location.
`{{last_longitude}}`	The latest recorded longitude of the contact’s location.
`{{locale}}`	User language and region. Example: `en_US`.
`{{locale2}}`	User language in short format. Example: `en`.
`{{language}}`	Preferred language code of the contact.
`{{timezone}}`	Timezone offset, such as `+2`.
`{{timezone_name}}`	The timezone name. Example: `America/New_York`.
`{{current_user_time}}`	The contact’s current local time.
`{{current_time}}`	The current time in the contact’s timezone (alias for `{{current_user_time}}`).
`{{user_id}}`	The contact ID in ChatbotX. Use this ID in API calls.
`{{user_code}}`	The channel-specific user code or source ID of the contact.
`{{user_hash}}`	The signed cryptographic hash identifier of the contact.
`{{user_external_id}}`	The external channel user ID (such as Viber user ID).
`{{user_channel}}`	The primary channel of the contact (e.g. `Messenger`, `Instagram`, `Whatsapp`).
`{{user_source}}`	The source where the contact originated (e.g. `Ads`, `Comments`, `Direct`, `Imported`, `Inbound Message`).
`{{user_tags}}`	Contains the names of all tags applied to the contact.
`{{user_notes}}`	All notes added to the contact profile.
`{{last_user_note}}`	The most recent note added to the contact profile.
`{{subscribed_date}}`	The date when the contact was created or subscribed.
`{{last_seen}}`	The last recorded timestamp the contact read a message or interacted.
`{{last_interaction}}`	The timestamp of the contact’s most recent incoming interaction.
`{{last_outbound_message_at}}`	The timestamp of the most recent message sent out to the contact.
`{{last_input}}`	The last text, image, video, audio, file, or voice message sent by the user.
`{{last_input_type}}`	The type of the last user input (`text`, `image`, `video`, `audio`, `file`, `reel`).
`{{last_btn_title}}`	The title of the last button the user clicked.
`{{consecutive_failed_reply}}`	The number of consecutive failed replies from the user.
`{{chat_history}}`	Returns the last 50 messages between the user and the bot.
`{{chat_history_large}}`	Returns the last 200 messages between the user and the bot.
`{{chat_history_details}}`	Returns the last 50 messages including sender attribution.
`{{chat_history_details_large}}`	Returns the last 200 messages including sender attribution.
`{{me}}`	A secure link where users can view and delete their data for GDPR compliance.

These fields provide channel-specific IDs, follower data, and direct communication links.

Field	Meaning and usage
`{{inbox_link}}`	Direct link to open the conversation inside the ChatbotX workspace inbox.
`{{fb_chat_link}}`	Direct link to open the contact in Facebook Page Inbox.
`{{webchat}}`	Direct link allowing the user to resume conversation via Webchat.
`{{webchat_parent_url}}`	The URL of the host webpage where the Webchat widget is embedded.
`{{wa_user_id}}`	The WhatsApp phone number ID of the contact.
`{{wa_user_name}}`	The WhatsApp profile display name of the contact.
`{{ig_user_name}}`	The Instagram username of the contact.
`{{ig_followers}}`	The Instagram follower count for the contact.
`{{ig_verified}}`	The verification badge status for the contact on Instagram.
`{{ig_follow_business}}`	Indicates whether the contact follows your business on Instagram.
`{{ig_business_follow_user}}`	Indicates whether your business follows the contact on Instagram.

These fields capture context when a contact interacts through Facebook or Instagram post comments.

Field	Meaning and usage
`{{last_fb_comment}}`	The text content of the contact’s most recent comment.
`{{last_post_id}}`	The ID of the post where the contact commented.
`{{last_comment_id}}`	The ID of the specific comment made by the contact.
`{{last_commented_post_text}}`	The full caption or text of the post where the contact commented.

Account and Workspace Fields

These fields return information about your ChatbotX workspace and connected channels.

Field	Meaning and usage
`{{account_id}}`	The workspace ID.
`{{workspace_id}}`	The workspace ID (alias for `{{account_id}}`).
`{{account_name}}`	The workspace name.
`{{workspace_name}}`	The workspace name (alias for `{{account_name}}`).
`{{account_image}}`	The workspace logo or image URL.
`{{api_key}}`	The workspace API access token.
`{{page_user_name}}`	The name or username of the connected channel page or account.

Ads and Referral Fields

These fields identify the ad or entry point link that directed the contact into the conversation.

Field	Meaning and usage
`{{last_ad}}`	The Facebook Ad ID that directed the contact into the chat.
`{{last_ctwa}}`	The Click-to-WhatsApp click ID that initiated the conversation.
`{{last_ad_source_url}}`	The URL of the ad that the contact clicked.
`{{last_ad_source_platform}}`	The ad platform where the user clicked (e.g. `Facebook`, `Instagram`).
`{{last_ref}}`	The referral parameter or Entry Point Link clicked by the user.

Booking and Appointment Fields

These fields store calendar and appointment scheduling details.

Field	Meaning and usage
`{{booking_calendar}}`	The name of the calendar assigned to the contact’s appointment.
`{{booking_date}}`	The scheduled date and time of the contact’s appointment.
`{{booking_link}}`	The personalized booking link for the contact to schedule or manage appointments.

Flow, Team, and Debugging Fields

These fields provide execution context, team assignment, error logs, and AI message queues.

Field	Meaning and usage
`{{last_step}}`	The Step ID of the previously executed step in a published Flow.
`{{current_step}}`	The Step ID of the currently active step in a published Flow.
`{{member_name}}`	The name of the team member sending messages from Inbox.
`{{team_name}}`	The names of the teams the active inbox member belongs to.
`{{assigned_admin_name}}`	The name of the admin or agent assigned to the contact.
`{{assigned_admin_email}}`	The email of the admin or agent assigned to the contact.
`{{assigned_admin_id}}`	The ID of the admin or agent assigned to the contact.
`{{ai.queued.messages}}`	Messages queued while an AI Agent is processing a response.
`{{last_input_failure}}`	Reason a GET USER DATA action failed (`timeout`, `user_skipped`, `invalid_input_attempts`).
`{{last_error_log}}`	The most recent error log recorded during flow or integration execution.

If a System Field does not appear in the dropdown suggestion list, you can still type it manually into any text box or Custom Field value. ChatbotX will resolve the variable dynamically when the Flow runs.

Getting Started

Automation

AI Agents

Contacts

Inbox

Remarketing

Triggers

Tools

Channels

Integrations

Contacts Fields

Account and Workspace Fields

Ads and Referral Fields

Booking and Appointment Fields

Flow, Team, and Debugging Fields

​Contacts Fields

​Channel and Social Profile Fields

​Comments and Social Interaction Fields

​Account and Workspace Fields

​Ads and Referral Fields

​Booking and Appointment Fields

​Flow, Team, and Debugging Fields

Contacts Fields

Channel and Social Profile Fields

Comments and Social Interaction Fields

Account and Workspace Fields

Ads and Referral Fields

Booking and Appointment Fields

Flow, Team, and Debugging Fields