> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Collect and analyze chatter satisfaction data with Satisfaction Surveys

## Overview\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_id_360018418294_id_h_860d44ff-ecd2-4c42-aeab-7cfcd3cc3ff0]

The Satisfaction Survey is designed to help you get better insight into
what your customers are thinking and feeling about their automated
support experience. By using this feature, you’ll be able to request
feedback from your users directly within the bot at an appropriate time
in the conversation.

> **Note**
>
> * You can attach the Satisfaction block to multiple Answers. We
>   recommend that you add the block at the end of your decision trees or
>   to stand-alone Answers.
>
> * Chatters are only served one satisfaction survey per conversation. If
>   you want to collect more chatter feedback, you can also collect
>   individual [Answer reviews](../../build-and-maintain-your-bot/train-and-manage-answers/improve-answer-training-using-chatter-feedback.mdx).

## Configure your survey\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_id_360018418294_id_configuring-your-survey]

There are four ways you can set up customer satisfaction reviews, each with different scales for recording feedback:

| Rating type                  | Negative review     | Positive review |
| ---------------------------- | ------------------- | --------------- |
| **Numeric (5-point scale)**  | 1, 2, or 3          | 4 or 5          |
| **Numeric (10-point scale)** | 1, 2, 3, 4, 5, or 6 | 7, 8, 9, or 10  |
| **Emoji (5-point scale)**    | 😠, 🙁, or 😐       | 🙂 or 😍        |
| **Thumbs up/down (binary)**  | 👎                  | 👍              |

1. On the Ada dashboard, go to **Settings** > **Bot Setup** >
   **Satisfaction Survey**.

2. Beside **Satisfaction Rating**, choose how you want chatters to
   provide ratings. This rating is part of every Satisfaction Survey,
   regardless of whether you enable additional options.

3. Beside **Follow-up Question**, turn on the toggle to allow chatters
   to give additional reasons depending on the rating they provided.
   The options they can select vary based on whether they provided a
   positive or negative rating.

   Possible positive reasons:

   * Efficient chat

   * Helpful resolution

   * Knowledgeable support

   * Friendly tone

   * Easy to use

   * Bot was intelligent

   * Other

   Possible negative reasons:

   * Took too long

   * Unhelpful resolution

   * Lack of expertise

   * Unfriendly tone

   * Technical issues

   * Bot didn't understand

   * Other

4. Beside **Resolution Question**, turn on the toggle to allow chatters
   to answer the question, "Did we resolve your issue?" with either
   "Yes" or "No."

5. Beside **Additional Comments**, turn on the toggle to allow chatters
   to type in additional feedback. Chatter feedback must be 320
   characters or less.

6. Click **Save Changes**. Your bot saves your survey settings.

![](/_fern-files/_img/51043b963a60eefafd1929ea3283f4236c57a8c1dd55708b8fe64d920e76bc58.webp)

## Configure when your survey appears\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_section-idm4600328375193633420749519938]

There are three ways you can survey chatters that you can use in any
combination:

* At the end of each chat

* In the Anytime survey, which appears after the chatter has sent four
  messages to the bot

* Using the Satisfaction block in an Answer

If you don't have any of the three above settings configured, chatters
won't see your survey.

### Survey chatters at the end of each chat\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_section-idm4671682567969633420752535607]

To prompt chatters with the survey at the end of every chat, under your
survey configuration settings, turn on the **Automatically survey at the
end of chat** toggle.

When this setting is turned on, the survey appears when chatters close
the chat, as long as they've sent the bot at least one message, or if a
live agent leaves the conversation.

### Let chatters access the survey during the chat\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_section-idm4671682553851233420753099028]

To allow chatters to access the survey before the chat has ended, under
your survey configuration settings, turn on the **Anytime Survey**
toggle.

When this setting is turned on, after the chatter has sent four messages
to the bot (including quick reply selections), a button appears beside
the chatter's text field.

This survey only consists of the Satisfaction Rating question you
configured in your Satisfaction Survey; it doesn't contain any follow-up
questions, even if you have them configured in the full survey.

### Add your survey to an Answer using the Satisfaction block\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_id_360018418294_id_attaching-a-survey-in-answers]

1. On the Ada dashboard, go to **Build** > **Answers**, and create or
   open an Answer you want to put a survey into.

2. Drag and drop a Satisfaction block into your Answer. This is where
   your users will be prompted for the survey.

3. Click **Save**.

![](/_fern-files/_img/ab84f591d41514347cbe9190d0e9ea939f7f0c1cbcc6d4811624101bd48a3ed5.webp)

## Turn automatic responses to chatter ratings on or off\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_section-idm453589445412803348488961694]

After chatters provide ratings, your bot can respond with the Positive
Satisfaction or Negative Satisfaction locked Answers. You can turn these
responses on or off. Under your survey configuration settings, under
**More Options**, use the toggles beside **Respond to negative ratings**
and **Respond to positive ratings** to turn those responses on or off.
You can also follow the links to each locked Answer to edit their
content.

![](/_fern-files/_img/0081a9a42e19629d1afd07188c1b281d14ded5a4a47ffbad60854a348cbd5edd.webp)

## Reporting\[#UUID-f6e94e16-103a-b225-d6a1-e76889418220_id_360018418294_id_h_3b418218-0deb-48ca-82e0-858e6cf48032]

To see a report of your Satisfaction Survey results, on your Ada
dashboard, go to **Measure** > **Reports** > **Satisfaction Survey
Results**. For more information on the data in that report, see
[Satisfaction Survey Results](./../analyze-chat-data/view-detailed-reports-on-your-bot-s-performance#satisfaction-survey-results).

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).