> 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 chatter satisfaction ratings using the Zendesk CSAT app

## Overview

Use the Zendesk CSAT app to share live chat CSAT ratings with your
Zendesk account. The Zendesk CSAT app works with Ada's [Satisfaction Survey](/scripted/docs/measure-success/plan-and-collect-feedback/collect-and-analyze-chatter-satisfaction-data-with-satisfaction-surveys).
First, the Satisfaction Survey collects a chatter's CSAT rating of the
live agent. Then, the Zendesk CSAT app sends the rating to Zendesk.

This guide walks you through connecting your Zendesk account with the
Zendesk CSAT app, as well as adding the block to your live chat handoff
Answers.

## Connect the Zendesk CSAT App \[#UUID-f58b48c1-8526-527e-a7ac-b88ba1b7dbca_id_4402445961619_id_h_01F8R8FF5NTSCWC1P2QR1BYGSR]

Connecting the Zendesk CSAT app in the Ada dashboard is as simple as
adding an OAuth access token to the Zendesk CSAT integration field in
your bot's integration settings view; however, there are a number of
steps that must be taken in order to retrieve an access token for your
Zendesk account.

### Requirements \[#UUID-f58b48c1-8526-527e-a7ac-b88ba1b7dbca_id_4402445961619_id_h_01F8TJFJ7G68VH5KSAR199X8GF]

* Ada Glass for Zendesk

* ZD Admin authorization

* An API client, such as [Postman](https://www.postman.com/downloads/),
  to use to create an access token

### Generate an OAuth Token \[#UUID-f58b48c1-8526-527e-a7ac-b88ba1b7dbca_id_4402445961619_id_h_01F8TRANPJ94FANSGG5HJ65PT3]

This guide walks you through the steps required to generate a Zendesk
OAuth access token. You can also reference the [Zendesk guide](https://support.zendesk.com/hc/en-us/articles/4408828740762) for
alternate ways of generating an access token.

Before you start, make sure you have the following:

* Zendesk Chat account with administrator permissions.

* An API client, such as the free [Postman API client app](https://www.postman.com/downloads/). This guide specifically
  describes using Postman, but you can use any API client you're
  familiar with instead.

  > **Note**
  >
  > You can't use your bot's HTTP Request block to create an OAuth token
  > as it is not designed for this process.

Once you have everything in order, you're ready to begin the process of
generating your OAuth access token.

On the Zendesk Chat dashboard:

1. On the sidebar, go to **Settings** > **Account**.

2. Click the **API & SDKs** tab, then click **Add API client**.

3. On the **Add API client** page, complete the three fields.

   | Field             | Description                                                 |
   | ----------------- | ----------------------------------------------------------- |
   | **Client name**   | Enter a unique name to identify this API client.            |
   | **Company**       | Enter a company name.                                       |
   | **Redirect URLs** | Use the following URL: `https://oauth.pstmn.io/v1/callback` |

4. Click **Create API client**. A popup appears with your client ID and
   client secret.

   > **Info**
   >
   > The client secret is shown only once, in this popup. Do not close it
   > until you've completed the following step.

5. Copy the **client ID** and **client secret**, and save them
   somewhere secure. You can now safely close the popup.

In the Postman app:

1. Be sure you're in the **My Workspace** view. Click the
   **Workspaces** drop-down menu, then click **My Workspace**.

2. On the left pane, click **New**, then choose **HTTP Request** to
   open a request tab.

3. On the **HTTP Request** tab, set the request type to **Get**. This
   should already be set by default.

4. In the **URL** field, paste the following URL:
   [https://www.zopim.com/api/v2/chats/](https://www.zopim.com/api/v2/chats/)

5. Below the URL field, click the **Authorization** tab.

6. Click the **Type** drop-down menu and select **OAuth 2.0** to reveal
   token configuration fields.

7. Complete the token configuration field. Use the following tables as
   a guide.

   | Current Token     |                        |
   | ----------------- | ---------------------- |
   | **Access Token**  | Leave this field empty |
   | **Header Prefix** | Enter `Bearer`         |

   | Configure New Token                     |                                                                                        |
   | --------------------------------------- | -------------------------------------------------------------------------------------- |
   | **Token Name**                          | Enter `Zendesk Chat`                                                                   |
   | **Grant Type**                          | Enter `Authorization Code`                                                             |
   | **Callback URL**                        | `https://oauth.pstmn.io/v1/callback`                                                   |
   | **Authorize using browser \[checkbox]** | Tick the checkbox                                                                      |
   | **Auth URL**                            | `https://www.zopim.com/oauth2/authorizations/new?subdomain=ADD_YOUR_ZENDESK_SUBDOMAIN` |
   | **Access Token URL**                    | `https://www.zopim.com/oauth2/token`                                                   |
   | **Client ID**                           | Enter your Zendesk client ID                                                           |
   | **Client Secret**                       | Enter your Zendesk client secret                                                       |
   | **Scope**                               | Enter `read write chat`                                                                |
   | **State**                               | Leave this field empty                                                                 |
   | **Client Authentication**               | Click the drop-down menu and select `Send client credentials in body`                  |

8. Click **Get New Access Token**.

9. On the **Zendesk Chat** browser tab that opens, click **Allow**.
   Once Postman processes your authentication request, a confirmation
   dialog appears.

10. Click **Proceed**. A new popup opens, showing you your token
    details.

11. Copy the Access Token and save it somewhere secure.

12. Click **Use Token**.

Nice work! You've created your access token. You can now use it to
connect Ada's Zendesk CSAT app to your Zendesk account.

## Connect the Zendesk CSAT App \[#UUID-f58b48c1-8526-527e-a7ac-b88ba1b7dbca_id_4402445961619_id_h_01F8YEC574BPY8ENBWEXAP3C7D]

Connecting the Zendesk CSAT app is quick and easy. Now that you've
generated an access token for you Zendesk Chat account, all you need to
do is add that token to the integrations page on Ada dashboard.

1. On the Ada dashboard, go to **Settings** > **Integrations** >
   **Zendesk CSAT \[Configure]**.

2. In the Zendesk Chat Access Token field, paste the access token you
   generated in Postman.

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

3. Click **Save**.

Your Zendesk CSAT app is now connected to your Zendesk account.

## Use the Zendesk CSAT Block

The Zendesk CSAT block does not perform the survey itself; rather, it
sends the rating captured by Ada's Satisfaction block to your Zendesk
account. This means you must use the Satisfaction Survey block in
conjunction with the Zendesk CSAT block.

> **Note**
>
> Be sure to have the Satisfaction Survey block set up.

Let's look at how to use a Zendesk CSAT block to send agent reviews.

1. Set your Satisfaction Survey rating type to **Binary**. The Zendesk
   CSAT block does not work with any other rating type.

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

   > **Note**
   >
   > Need help configuring the Satisfaction Survey? Check out our
   > [configuration guide](/scripted/docs/measure-success/plan-and-collect-feedback/collect-and-analyze-chatter-satisfaction-data-with-satisfaction-surveys).

2. In the live chat handoff Answer, at an appropriate point preceding
   the Zendesk Live Agent block, drag and drop a **Capture** block and
   set it to capture the chatter's email address.

   > **Info**
   >
   > The Zendesk CSAT app must have the chatter's email in order to share
   > their rating with Zendesk. See the
   > [Limitations](#UUID-f58b48c1-8526-527e-a7ac-b88ba1b7dbca_id_4402445961619_id_h_01F97NZRKHWC6ZT2E77MNP8P6J)
   > section for more details.
   >
   > Additionally, you must use only `email` to name the email variable;
   > otherwise, Zendesk can't associate the email variable with the
   > chatter's Zendesk profile.

3. In a live chat handoff Answer, in the space directly following the
   Zendesk Live Agent block, drag and drop the **Satisfaction Survey
   block**.

4. In the space directly following the Satisfaction Survey block, drag
   and drop the **Zendesk CSAT block**.

5. Click the Select Action drop-down menu and select **Update Chat CSAT
   Rating**. This adds the Select Variables for Inputs section to the
   block.

6. Complete the new fields. Use the following table as a guide.

   <table>
     <tbody>
       <tr>
         <td>
           **Chatter Email**
         </td>

         <td>
           Insert the *email* variable.

           ![](/_fern-files/_img/1f80242d845a65fe893288f2c9c52002f2053383a080a2c89a1e8827163a0d8c.webp)
         </td>
       </tr>

       <tr>
         <td>
           **CSAT Rating**
         </td>

         <td>
           Insert the *csat_score* variable.

           ![](/_fern-files/_img/bc5a3078f3e5510498bff2474d59ef06cd56d944c41081924bfd6929e66d9c3b.webp)
         </td>
       </tr>
     </tbody>
   </table>

7. Click the **Fallback Answer** drop-down menu and select a fallback
   Answer to display should an error occur.

8. Click **Save**.

Your bot is now set up to share chatters' agent ratings with your
Zendesk account. The Satisfaction Survey presents for the chatter as
soon as the live agent closes the live chat. Once the chatter completes
the survey, the Zendesk CSAT block connects with Zendesk and transfers
the survey to your account.

## Limitations \[#UUID-f58b48c1-8526-527e-a7ac-b88ba1b7dbca_id_4402445961619_id_h_01F97NZRKHWC6ZT2E77MNP8P6J]

Be aware that there are some limitations to the Zendesk CSAT app's
functionality which you might be accustomed to having outside of Ada.

* The app requires the chatter's email address to work. For
  unauthenticated chatters, ensure that you are capturing their email
  address prior to the survey. If sharing an email address is not
  mandatory for the chatter, and they refuse to do so, the Zendesk CSAT
  block can't share the rating with your Zendesk Chat account.

* Zendesk sets a limit of 200 requests per minute for their Zendesk Chat
  API. The Zendesk CSAT app shares agent survey results with Zendesk
  using this API, and is therefore also bound by this rate limit.

---

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