With Scripts, your bot can perform tasks like formatting dates for readability, extracting specific data from user input, breaking down complex queries responses, modify and update attribute values and much more.<\/p>\n\n\n\n
- \n
- Tailored Logic Integration<\/strong>: Scripts allow you to add customized logic to meet specific needs not covered by default bot features.<\/li>\n\n\n\n
- More Flexibility<\/strong>: Custom Scripts let you handle complex operations, and connect with external systems.<\/li>\n\n\n\n
- Smooth Integration<\/strong>: Scripts make it easy to connect with third-party APIs, databases, and external services, expanding the bot\u2019s capabilities.<\/li>\n<\/ul>\n\n\n\n
How to use Scripts in Chatbot<\/mark><\/h2>\n\n\n\n
To create a function, follow these steps:<\/p>\n\n\n\n
- \n
- Go to Settings > General Settings > Scripts > Create Script.<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script1-1024x509.png\")
<\/figure><\/div>\n\n\n- \n
- Provide a specific name to your script and click on the Create button.<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script2.png\")
<\/figure><\/div>\n\n\n- \n
- Add your script in the newly created script page<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script3-1024x621.png\")
<\/figure><\/div>\n\n\n- \n
- Go to the chatbot and use Script action within the flow<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script4-1024x504.png\")
Add the script action in chatbot<\/figcaption><\/figure><\/div>\n\n \n![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script5-1024x500.png\")
Test the return value of the script you stored in an attribute<\/figcaption><\/figure><\/div>\n\n\n Creating Scripts for your bot\u200b<\/mark><\/h2>\n\n\n\n
You can create a custom script using JavaScript to implement specific functionality for your bot. Use the following code template and simply replace ‘
Write your code here<\/code>‘ with the actions or logic you want to execute:<\/p>\n\n\n\nYou can define a custom function using JavaScript. Here is a sample code snippet. Just replace the placeholder ‘Your logic goes here’ with the specific functionality you wish to implement.<\/p>\n\n\n\n
return new Promise(resolve => { \n \/\/ Write your code here\n resolve();\n }); <\/code><\/pre>\n\n\n\nScript argument to access user data<\/mark><\/h2>\n\n\n\n
In programming, arguments act as inputs that let the bot access specific information or execute defined actions within your code, creating more targeted and dynamic responses.<\/p>\n\n\n\n
To access user-specific information, use:
data.attribute_name<\/code> , where<attribute_name><\/code> is a variable. Here, you can use any system attribute of REVE Chat or custom attributes you have created to use the variable data directly within the script.<\/p>\n\n\n\nGet the list of system attributes<\/p>\n\n\n\n
Learn more about custom attributes<\/p>\n\n\n\n
Save values in attribute<\/mark><\/h2>\n\n\n\n
- \n
- Single Attribute Storage<\/li>\n<\/ul>\n\n\n\n
In some cases, you might want to save all returned data in a single attribute. For example, you might want to store a single piece of information like user_status or a complete return value as a single entry. This is useful for smaller or consolidated data needs.<\/p>\n\n\n
\n![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script6.png\")
<\/figure><\/div>\n\n\n- \n
- Multiple Attribute Updates (Example Code Below)<\/li>\n<\/ul>\n\n\n\n
If you need to manage several pieces of user data, you can use a custom JavaScript script to assign values to multiple attributes at once. This method is particularly useful when handling several pieces of data, such as user contact details, preferences, or responses, in one go.<\/p>\n\n\n\n
Here\u2019s an example of how to update multiple attributes:<\/p>\n\n\n\n
\/\/ You can set multiple attribute using our script function. A sample script function is given below.\nreturn new Promise(resolve => { \n \/\/set variables\n let name = data.name;\n let phone = data.phone;\n\n\/\/return below object with type value "set_variables" to update multiple attributes at a time\n let returnObj = {\n type: "set_variables",\n variables: {\n name: name,\n phone: phone\n }\n };\n resolve(returnObj);\n});<\/code><\/pre>\n\n\n\nPublishing a Script<\/mark><\/h2>\n\n\n\n
To publish a script, you need to test the script if it is working fine or not.<\/p>\n\n\n\n
- \n
- Simple Scripts (Returning Only Value or JSON): Click the Test Now button. If everything works correctly, you can then publish the script.<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script7-1024x727.png\")
<\/figure>\n\n\n\n- \n
- Scripts with Dynamic Values from Attributes:\n
- \n
- Provide sample values for any attributes referenced in the script. You can use text, numeric, or Json response as your sample variable depending on the type of your script.<\/li>\n\n\n\n
- Click Test Now to verify the script before publishing<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script8-1024x559.png\")
<\/figure>\n\n\n\n- \n
- One your script is ready and works perfectly, live the script to use in chatbot.<\/li>\n<\/ul>\n\n\n\n
Note: If you use
data.attribute_name<\/code> to reference attributes, you must define sample values to avoid undefined values during testing.<\/p>\n\n\n\n![\"\"](\"https:\/\/www.revechat.com\/wp-content\/uploads\/2025\/07\/Script10-1024x615.png\")
<\/figure>\n\n\n\nHow Scripts work<\/mark><\/h2>\n\n\n\n
This section explains how scripts operate within your bot, starting with simple examples and progressing to more complex scenarios to help you build your skills step-by-step.<\/p>\n\n\n\n
The following code examples include some fundamental JavaScript concepts:<\/p>\n\n\n\n
- \n
let<\/code>: Declares a variable to store data.<\/li>\n\n\n\nresolve<\/code>:<\/strong> Completes a promise and returns the function’s output.<\/li>\n\n\n\nif\/else<\/code>: Allows the bot to make decisions based on conditions.<\/li>\n<\/ul>\n\n\n\nDisplay user ID<\/mark><\/h3>\n\n\n\n
The following example demonstrates how to display the current user ID:<\/p>\n\n\n\n
return new Promise(resolve => {\n let internal_user_id = data.internal_user_id; \/\/ Retrieve the user ID from the data object \n resolve(`The current user ID is ${internal_user_id}`); \/\/ Return a message with the user ID \n});<\/code><\/pre>\n\n\n\nExplanation<\/h5>\n\n\n\n
- \n
- Access User ID<\/strong>: The internal_user_id variable is set to the user ID by accessing data.internal_user_id.<\/li>\n\n\n\n
- Display Message<\/strong>: The function returns a message containing the user ID, which will be shown to the user.<\/li>\n<\/ul>\n\n\n\n
Output<\/strong>: The current user ID is [internal_user_id]<\/p>\n\n\n\n
Process current data and time<\/mark><\/h3>\n\n\n\n
The following code snippet captures the current date and time in the Asia\/Kolkata time zone, formats it, and logs the results. The function then returns the current date.<\/p>\n\n\n\n
return new Promise(resolve => {\n let currentdate = new Date(); \/\/ Captures the system\u2019s current date and time\n let currentTime = new Date().toLocaleTimeString('en-IN', { timeZone: 'Asia\/Kolkata' });\n \n \n resolve(currentdate); \/\/ Returns the current date\n});<\/code><\/pre>\n\n\n\nExplanation<\/h5>\n\n\n\n
- \n
- Retrieve Current Date<\/strong>: currentdate is initialized with the system’s current date and time.<\/li>\n\n\n\n
- Set and Format Current Time<\/strong>:\n
- \n
let currentTime<\/code>: Declares a variable for the formatted time.<\/li>\n\n\n\nnew Date()<\/code>: Creates a Date object for the current date and time.<\/li>\n\n\n\n.toLocaleTimeString('en-IN', { timeZone: 'Asia\/Kolkata' })<\/code>: Formats the time for the India (en-IN) locale in the Asia\/Kolkata time zone, displaying it in Indian Standard Time (IST).<\/li>\n<\/ul>\n<\/li>\n\n\n\n- Return Date<\/strong>: The function resolves with the current date, completing the operation.<\/li>\n<\/ul>\n\n\n\n
Output<\/strong>: This script logs the current date and formatted time (Asia\/Kolkata time zone) to the console and returns the current date.<\/p>\n\n\n\n
Custom date range formatter and save value<\/mark><\/h3>\n\n\n\n
This script calculates and formats a date range, providing the start of the current month and the current date and time in a custom “YYYYMMDDHHMMSS” format.<\/p>\n\n\n\n
return new Promise(resolve => {\n function getDatesInCustomFormat() {\n \/\/ Get the current date\n const now = new Date();\n \n \/\/ Get the timezone offset in milliseconds\n const timezoneOffset = now.getTimezoneOffset() * 60000;\n\n \/\/ Calculate the start date (first day of the current month) in local timezone\n const startDate = new Date(now.getFullYear(), now.getMonth(), 1);\n const startDateLocal = new Date(startDate.getTime() - timezoneOffset);\n\n \/\/ Calculate the end date (current date and time) in local timezone\n const endDate = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 23, 59, 59);\n const endDateLocal = new Date(endDate.getTime() - timezoneOffset);\n\n \/\/ Helper function to format date as YYYYMMDDHHMMSS\n function formatDate(date) {\n const year = date.getFullYear();\n const month = String(date.getMonth() + 1).padStart(2, '0');\n const day = String(date.getDate()).padStart(2, '0');\n const hours = String(date.getHours()).padStart(2, '0');\n const minutes = String(date.getMinutes()).padStart(2, '0');\n const seconds = String(date.getSeconds()).padStart(2, '0');\n\n return `${year}${month}${day}${hours}${minutes}${seconds}`;\n }\n\n \/\/ Return the result as a JSON object with 'from' and 'to' keys\n return {\n start_time: formatDate(startDateLocal),\n current_time: formatDate(endDateLocal)\n };\n }\n\n \/\/ Resolve the promise with the result of the function\n resolve(getDatesInCustomFormat());\n});\n<\/code><\/pre>\n\n\n\nExplanation<\/h5>\n\n\n\n
- \n
- Get Current Date and Time (now)<\/strong>: The
now<\/code> variable captures the current date and time for calculating both the start and end dates.<\/li>\n\n\n\n- Adjust for Timezone Offset<\/strong>:
timezoneOffset<\/code> converts the timezone offset from minutes to milliseconds. This ensures that calculations adjust for the local time zone.<\/li>\n\n\n\n- Calculate Start and End Dates<\/strong>:\n
- \n
- Start Date<\/strong>:
startDate<\/code> is set to the first day of the current month at midnight. Then,startDateLocal<\/code> is created by adjusting for the timezone offset.<\/li>\n\n\n\n- End Date<\/strong>:
endDate<\/code> is set to the current date at 23:59:59 (end of the day).endDateLocal<\/code> adjusts this date to the local timezone.<\/li>\n<\/ul>\n<\/li>\n\n\n\n- Format Dates (Helper Function)<\/strong>: The
formatDate<\/code> function converts a Date object into the “YYYYMMDDHHMMSS” format:\n- \n
- Formatting Components<\/strong>: The
year<\/code>,month<\/code>,day<\/code>,hours<\/code>,minutes<\/code>, andsecond<\/code>s are extracted and padded to two digits where needed.<\/li>\n\n\n\n- Return Formatted String<\/strong>: These values are combined into a formatted string (e.g., “20241027111559”).<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Return JSON Object<\/strong>: The function returns a JSON object with:\n
- \n
- start_time<\/strong>: The formatted start date for the month.<\/li>\n\n\n\n
- current_time<\/strong>: The formatted current date and time.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Resolve the Promise<\/strong>: The promise is resolved with the formatted JSON object, making this data available for further use.<\/li>\n<\/ul>\n\n\n\n
Output<\/strong>: This script returns a JSON object with the start time of the month and the current date and time in “YYYYMMDDHHMMSS” format, adjusted for local timezone.<\/p>\n\n\n\n
{\n "start_time": "20241001060000",\n "current_time": "20241028055959"\n}<\/code><\/pre>\n\n\n\nWhat Next?<\/mark><\/h2>\n\n\n\n
Create your own function and use it by adding an API action in the chatbot flow. Lean how API works.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Scripts enhance your bot\u2019s capabilities by enabling custom logic and actions beyond standard features. Learn how to use Scripts in REVE Chat, it lets you easily add JavaScript code in chatbot! Why do you need Scripts? With Scripts, your bot can perform tasks like formatting dates for readability, extracting specific data from user input, breaking […]<\/p>\n","protected":false},"author":36,"featured_media":0,"menu_order":102,"template":"","meta":{"_acf_changed":false,"footnotes":""},"help_center_type":[1812],"class_list":["post-271027","help-center","type-help-center","status-publish","hentry","help_center_type-general-settings"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/help-center\/271027","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/help-center"}],"about":[{"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/types\/help-center"}],"author":[{"embeddable":true,"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/users\/36"}],"version-history":[{"count":10,"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/help-center\/271027\/revisions"}],"predecessor-version":[{"id":302994,"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/help-center\/271027\/revisions\/302994"}],"wp:attachment":[{"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/media?parent=271027"}],"wp:term":[{"taxonomy":"help_center_type","embeddable":true,"href":"https:\/\/www.revechat.com\/wp-json\/wp\/v2\/help_center_type?post=271027"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- current_time<\/strong>: The formatted current date and time.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Return Formatted String<\/strong>: These values are combined into a formatted string (e.g., “20241027111559”).<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- End Date<\/strong>:
- Adjust for Timezone Offset<\/strong>:
- Set and Format Current Time<\/strong>:\n
- Display Message<\/strong>: The function returns a message containing the user ID, which will be shown to the user.<\/li>\n<\/ul>\n\n\n\n
- One your script is ready and works perfectly, live the script to use in chatbot.<\/li>\n<\/ul>\n\n\n\n
- Scripts with Dynamic Values from Attributes:\n
- Simple Scripts (Returning Only Value or JSON): Click the Test Now button. If everything works correctly, you can then publish the script.<\/li>\n<\/ul>\n\n\n\n
- Multiple Attribute Updates (Example Code Below)<\/li>\n<\/ul>\n\n\n\n
- Single Attribute Storage<\/li>\n<\/ul>\n\n\n\n
- Go to the chatbot and use Script action within the flow<\/li>\n<\/ul>\n\n\n
- Add your script in the newly created script page<\/li>\n<\/ul>\n\n\n
- Provide a specific name to your script and click on the Create button.<\/li>\n<\/ul>\n\n\n
- More Flexibility<\/strong>: Custom Scripts let you handle complex operations, and connect with external systems.<\/li>\n\n\n\n