Skip to content
background gradient desk

Set up rating and survey feature to assesst quality of chatbots

March 3, 2021

Share with:


 1. Set up rating scenario for Chatbot

To report and evaluate quality of Bot/online support, Bot creators can make rating content and send it to customers to collect information. The step-by-step instruction to create rating scenario is: 

Step 1: Declare variables

Scenarios >  Variables setting > Add variable to rate and collect messages from customers.

  • “rate_level”: the variable to receive star ratings
  • “rate_message”: the variable to receive feedback from customers

Step 2: Create a campaign to collect rating and constant

               + Enter campaign’s name

               + Enter description of campaign

               +  Attach campaign with Bot

Chatbot FPT.AI

  • In the campaign > Settings > Copy campaign token

Chatbot FPT.AI

  • In Bot > Scenarios > Constant setting > Add constant, use the campaign token from The purpose of this constant is to connect Bot with the corresponding rating campaign.

Chatbot FPT.AI

Step 3: Create a scenario to collect rating from customers

Step 3.1: Create a scenario to rate from 1* to 5*

  • Use quick reply card
  • Create star rating buttons (from 1 to 5 stars)
  • For each button, set the variable “rate_level” according to the number of stars. When customers click on those buttons, Bot will ask more at the next step. 

Chatbot FPT.AI

Chatbot FPT.AI

Step 3.2: Create a scenario to collect message

  • At the “Collect message” step, after the rating step, use a Form card to ask for customer feedback and select the “rate_message” variable. 

  • Then use a JSON API card to transfer collected information, including “rate_level” stars and “rate_message” feedback to to see details and make reports. For this card, set up as the instruction below: 

                 + Choose POST method

                 + URL: (This is the 2nd version of

                 + Headers: Authorization – Bear {{token}} (Token is taken from the constant above, used to connect Bot with rating campaign) 

                  + Transfer variables to save information into rating page include: sender_id, sender_name, rate_level, rate_message

  • Create a memories card to delete rate_level and rate_message variable after they are saved into rating page
  • Create a text card to thank customers and finish rating flow. 

Chatbot FPT.AI


Tùy vào định nghĩa kịch bản mà người tạo kịch bản Bot có thể không cần lấy phản hồi của khách hàng. Như vậy, hệ thống rating chỉ lưu số sao được đánh giá

Depending on each scenario, Bot creators may not need to collect messages from customers. Thus, the system will save rating stars only.

2. Assessment and report interface

Step 1: Log in Bot Assessment created in step 1.1

Step 2: In the menu “Bot Assessment” > “Overview”: Bot Admin can see a report on the number of ratings and the percentage of rating stars. 

Chatbot FPT.AI

Step 3: In the menu “Bot Assessment” > “Details”: Bot Admin can see how each customer rate and feedback in detail. 

Chatbot FPT.AI

Detailed report can be exported or filtered according to time


1. Create survey content

Step 1: Visit Log in with FPT ID account.

Step 2: Create survey content

  • <Survey Name>: Enter survey name
  • <Survey Descriptions>: Enter survey descriptions
  • <Question Name>: Enter questions
  • <Image URL> (Optional): Image URL on website
  • <Choice>: Enter choices for questions
  • Click Save
  • Click <New Question> to add new questions

Chatbot FPT.AI


2. Create a survey scenario for Chatbot

Step 1: Variables setting

Visit Bot creation interface, then create following variables: 

Chatbot FPT.AI

Step 2: Constant setting

  • On, copy that survey token

Chatbot FPT.AI

  • Chatbot > Constant setting > Add new constant value (name the constant and add constant value using the above token from

Chatbot FPT.AI

Step 3: Create scenarios for Chatbot

Step 3.1: Get the survey on for Chatbot scenario through JSON 

  • Check variable condition “survey_completed” != True
  • Method: GET
  • URL:
  • Headers: Authorization/ Bearer {{token_survey}} (Transfer the above constant to header to connect Bot with survey)
  • Variables: None

Chatbot FPT.AI

Step 3.2: Use a Text card to design introduction for Bot

  • Check condition survey_completed != True

Chatbot FPT.AI

Step 3.3: Use a JSON API card to call survey system to get questions

  • Create a step for cards that get questions: GetQuestion
  • At GetQuestion step, use JSON API to take the questions set up for survey

Method: GET


Headers – Key: Authorization

Value: Bearer {{token_survey}} (Transfer the above constant to header to connect Bot with survey)

Variable: sender_id

Chatbot FPT.AI

  • Add a new step to finish survey flow “End-survey”
  • Use a “Go to step” card to go to the End-survey step with the condition “survey_completed” = True.

Chatbot FPT.AI

Step 3.4: Save responses of customers into survey system

  • Create a new step named “Answer”
  • At this step, create a JSON API card to save customers’ choices into the system: 

Method: POST


Headers – Key: Authorization

Headers – Value: Bearer {{token_survey}}

Variable: Chọn the variable “sender_id”, “question”, “choice”

Chatbot FPT.AI

  • Next, also at Answer step, use a “go to step” card, check variable condition “survey_completed” != True, go to GetQuestion step. The purpose of this step is to get more steps if the flow is not finished. 


Chatbot FPT.AI

3. Assessment and report interface

Step 1: At created survey, click on the Report icon

Chatbot FPT.AI

Step 2: See statistics, report of each survey question

Chatbot FPT.AI

Chatbot FPT.AI


?  Start building a chatbot right now with the chatbot creation platform FPT.AI Conversation:

☎ Hotline: 0911886353

? Email: [email protected]

Related Posts

Get ahead with AI-powered technology updates!

Subscribe now to our newsletter for exclusive insights, expert analysis, and cutting-edge developments delivered straight to your inbox!