Field (Variable)

Unlock the full potential of Flexito OmniAI by mastering custom fields. These powerful tools allow you to personalise and optimise user and bot interactions, ensuring a seamless experience tailored to your needs. Learn how to create and manage custom fields effortlessly, enhancing your system's efficiency and effectiveness.

Create Custom Field in Contents Section (#Field(Variable)-CreateCustomFieldinContentsSection)
Create Custom Field in Question and Action Step (#Field(Variable)-CreateCustomFieldinQuestionandActionStep)

TIP: Before diving into each step, it's crucial to understand what a field (or variable) is in Flexito OmniAI. This foundational knowledge is key to navigating the system effectively.

A field, also known as a variable, is essentially a container designed to hold a specific value.

Classification	Description
system field and custom field	system field is created by the system with pre-defined variable name and type, while custom field is defined by yourself
bot field and user field	bot field is shared in the whole bot, while each user has his/her own set of user fields
text field, number field, boolean field, date field, datetime field and JSON field	see

User Field

User fields are specific to individual users. For instance, each user has a unique name and email address, which are considered user fields.

Bot Field

Bot fields are associated with the bot itself. For example, a restaurant bot would have fields for the restaurant's address and contact number. These fields, like "restaurant_address" and "restaurant_contact," are created as bot fields to avoid managing different details for each user.

System Field

System fields are automatically generated by the system with predefined names and types. They include both system bot fields and system user fields:

Some system fields are exclusive to certain channels. Refer to the table below for instructions on editing system fields:

Field Name	Field Type	Variable Type	Description	How to Edit
User Ns	user field	text	user identification in Flexito OmniAI	non-editable
User Id*	user field	text	user identification from the channel	non-editable
First Name	user field	text	profile info	in Question Step/Action Step
Last Name	user field	text	profile info	in Question Step/Action Step
User Name	user field	text	profile info	in Action Step
Gender	user field	text	profile info	in Action Step
Email	user field	text	profile info	in Question Step/Action Step
Phone	user field	text	profile info	in Question Step/Action Step
Profile Image	user field	text	profile info	in Question Step
Locale	user field	text	profile info	non-editable
Timezone	user field	text	profile info	non-editable
Language	user field	text	profile info	in Action Step
Subscribed	user field	datetime	subscribed time	non-editable
Last Text Input	user field	text	user's last input	edited by system
Last Interaction	user field	datetime	last action time	edited by system
Last Button Title	user field	text	last button pressed	edited by system
Flow Ns	bot field	text	flow(bot) identification in Flexito OmniAI	non-editable
Sub Flow Ns	bot field	text	sub flow identification in Flexito OmniAI	non-editable
Page Name	bot field	text	connected Facebook page name	non-editable
Page Id	bot field	text	connected Facebook page id	non-editable
Page User Name	bot field	text	username of the page in Facebook	non-editable
Last FB Comment	user field	text	user's last comment text in the Facebook page	edit by system
Last FB Comment Post Id	user field	text	post id of where user put the last comment	edit by system
Last FB Comment total tagged users	user field	number	tagged users amount in last comment	edit by system
Last FB Comment total new tagged users	user field	number	tagged but haven't subscribed(to bot) users amount	edit by system
Last FB Comment is existing users	user field	number	before this comment, is he/she an existing user? yes=1,no=0	edit by system
Live Chat Url	user field	text	(for agent) visit to talk to user in live chat	edit by system
NOW	user field	datetime	current time in user's timezone*	edited by system
TODAY	user field	date	current date in user's timezone*	edited by system
BOT_CURRENT_TIME	bot field	datetime	current datetime in workspace's timezone	edited by system
ITEM	user field	array (JSON)	each item in a JSON	in "For Each" message
SELECT	user field	array (JSON)	selected item	in "Select" new step
SHOP	bot field	array (JSON)	store information	in Ecommerce Integration
CART	user field	array (JSON)	user shopping cart	in Action Step
ORDER	user field	array (JSON)	user's last order	edited by system
User	user field	array (JSON)	user's profile	edited by system according to other profile values
DialogFlow	user field	array (JSON)	DialogFlow response	edited by DialogFlow agent

Note: If a channel does not support timezone information in a user's profile, or if a user lacks a timezone value despite the channel's support, the workspace timezone will be used as a default.

User Id in Different Channels:

Channel	Meaning	Example Value
Facebook	Unique Id in your Facebook page	6288386817841812
Instagram	Unique Id in your Instagram bot	6570462892993643
Telegram	Unique Id in your Telegram bot
Slack	Unique Id in your Slack workspace	U017MKNENH
WeChat	Unique Id in your WeChat account	oNzS3wpEjnA3tXmOcNxpqtAnBwWg
WhatsApp	User's phone number without +
SMS	User's phone number
Voice	User's phone number
Google	Conversation Id from Google	e-90cf-4347-abb0
Line	Unique Id in your Line bot	Ub02c77c69c59c5be5597d58ce2701ebe
Viber	Unique Id in your Viber bot	mdY9hOWdeQC6J/Sl19Qh8A==
Vk	Unique Id in your Vk bot

Note: The unique ID from a channel is only unique within your specific Facebook page, Telegram bot, Slack workspace, or WeChat account. It is not a universal ID across platforms like Facebook or Slack.

Variable Type

Flexito OmniAI supports 6 different types of variables:

Type	Storage	Example	Operations Supported
Text	letters, words, sentences...	Hi, Flexito OmniAI.	cutting, change case, encode, decode...
Number	numbers	123.45	+ - x ÷, mod, power, log, root, round...
Boolean	either "1" or "0", for true or false	1	assign
Date	date		format, add months/weeks/days
DateTime	date and time	T12:00:00+10:00	format, add months/weeks/days/hours/minutes
JSON (array)	a series of variables	{"name":"Jack", "age":"20"}	load, get, update, remove, count, sum, average, sort, shuffle, reverse...

Boolean Value

When stored in a field, the following values will cause the boolean to return false. Otherwise, it will return true:

empty
null
'false'
false
'no'
0

Create Custom Field

Congratulations, you're now well-versed in fields! Let's put your knowledge to the test! 😎😎

There are two methods to create variables:

Place	Type Supported
in Contents section	user field & bot field
anywhere you need to map result to variable, e.g. Question step, Integration, etc	user field only

Create Custom Field in Contents Section

Navigate to "Contents" from the left sidebar.
Choose either User Fields or Bot Fields.
Use folders to organise your fields if necessary.

To create a field, click the blue "+ New User/Bot Field" button on the right. Enter a "Field Name"—this is required. You can use characters like underscores or spaces to separate words. We recommend keeping the name concise to prevent any display issues.

Next, select a variable type. You can also add a default value or description if needed (default values apply only to bot fields).

Folders are useful for organising variables, especially as your flow expands. 🧐

Create Custom Field in Question and Action Step

To create new fields within a question step:

Enter a new variable name in the "Enter Field Name" box and select it from the drop-down list. Choose the appropriate variable type, and you're all set.

Here's another example: creating a field within an integration: