NicoChatNicoChatDocsSearch the docs…
Sign in

Field Variable

TIP - Before detailing each step, let’s take a look at what a field (variable) is in NicoChat. It may take a moment, but it is essential to understand the system.

2026-08-12
Classification
Description
system field and custom field
the system field is created by the system with a predefined variable name and type, while the custom field is defined by you
bot field and user field
The bot field is shared across the whole channel, while each user has their own set of user fields
text field, number field, boolean field, date field, datetime field, JSON field and Long JSON field
see variable type below

User Field

The user field belongs to users. For example, each user has their own name and email address. So “name” and “email” are user fields.

Bot Field

The bot field belongs to the channel. For example, the channel of a restaurant holds the address and the phone number of the restaurant. So "restaurant_address" and "restaurant_contact" should be created as bot fields, since you do not want to manage different addresses or contacts of your restaurant for each user.

System Field

The system field is created by the system, with a predefined variable name and type. There are system bot fields and system user fields:

Some system fields exist only in specific channels. See in the table below how to edit the system field:

| Field Name | Field Type
| Variable Type

Description
How to Edit
User Ns
User field
User Id*
User field
First Name
User field
Last Name
User field
User Name
User field
Gender
User field
Email
User field
Phone
User field
Profile Image
User field
Locale
User field
Timezone
User field
Language
User field
Subscribed
User field
Last Text Input
User field
Last Interaction
User field
Last Button Title
User field
Flow Ns
Bot field
Sub Flow Ns
Bot field
Page Name
Bot field
Page Id
Bot field
Page Username
Bot field
Last Facebook Comment
User field
Last FB Comment Post Id
User field
Last FB Comment total tagged users
User field
Last FB Comment total new tagged users
User field
Last FB Comment is existing users
User field
Live Chat Url
User field
NOW
User field
TODAY
User field
BOT_CURRENT_TIME
Bot field
ITEM
User field
SELECT
User field
SHOP
Bot field
CART
User field
ORDER
User field
User
User field
Dialogflow
User field

Note - If the channel does not provide a timezone in the user profile, or if it does but the user has no timezone value, the workspace timezone is used.

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
1173717756
Slack
Unique id in your Slack workspace
U017MKNENH
WeChat
Unique id in your WeChat account
oNzS3wpEjnA3tXmOcNxpqtAnBwWg
WhatsApp
User phone number without +
553188887777
SMS
User phone number
+553188887777
Voice
User phone number
+553188887777
Google
Google conversation id
8095938e-90cf-4347-ab94-9224308672b0
Line
Unique id in your Line bot
Ub02c77c69c59c5be5597d58ce2701ebe
Viber
Unique id in your Viber bot
mdY9hOWdeQC6J/Sl19Qh8A==
Vk
Unique id in your Vk bot
705862439

Note - The channel unique id is unique only within your Facebook page, your Telegram bot, your Slack workspace or your WeChat account; it is not a unique id across the whole of Facebook, the whole of Slack, etc.

Variable Type

There are 7 variable types in NicoChat:

Type
Stores
Example
Supported operations
Text
letters, words, sentences...
Hi, NicoChat.
trim, change upper and lower case, encode, decode...
Number
numbers
123,45

+ - x ÷, mod, power, log, root, round...
Boolean
"1" or "0", for true or false
1
assign
Date
date
30/03/2021
format, add months/weeks/days
DateTime
date and time
2022-01-01T12: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...
Long JSON
a JSON array with extended capacity, up to 500,000 characters
{"products": [ {...}, {...}, ... ]}
same operations as the JSON type — suitable for large catalogs, integration/API responses with many items or accumulated histories that exceed the limit of the standard JSON field

Boolean value

When one of these values is stored in the field, the boolean returns false; otherwise, it returns true:

  • empty
  • null
  • 'false'
  • false
  • 'no'
  • 0

Create custom field

Wow, now you are a master 👨🎓 of fields! Let’s try it out! 😎😎

You can create variables in 2 ways:

Where
Supported type
in the Content section
user field and bot field
anywhere you need to map the result to a variable — for example, question step, integration, etc.
user field only

Create a custom field in the Content section

  • go to "Content" in the left sidebar
  • select User Fields or Bot Fields
  • use the folder to organize your fields, if needed

Click the blue "+ New user/bot field" button on the right to create a field. "Field name" is required. You can use any character to separate words, such as underscore or space. We suggest keeping the field name as concise as possible, to avoid possible display problems.

After that, choose a variable type. Add a default value or a description, if needed. (the default value exists only for bot fields)

Folders can be used to organize variables. Believe me: you will need them when your flow grows. 🧐

Create a custom field in the question step and in the action step

For example, to create new fields in the question step:

Type a new variable name in the “Insert field name” box and click it in the dropdown list. Select the corresponding variable type and you are done.

Another example, creating the field in an integration: