Skip to main content

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. 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

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

  • Ada Glass for Zendesk

  • ZD Admin authorization

  • Postman — A free app we'll use to create an Access Token.

Generate an OAuth Token

This guide walks you through the steps required to generate a Zendesk OAuth access token. You can also reference the Zendesk guide for alternate ways of generating an access token.

Before you start, make sure you have the following:

  • Zendesk Chat account with administrator permissions.

  • The free Postman HTTP request app. Although you can use other endpoint tools, this guide only describes the steps for using Postman.

    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.

    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.

    Important

    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/

  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

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.

    Zendesk_CSAT_connect.png
  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.

    SatSurvey_binary.png

    Note

    Need help configuring the Satisfaction Survey? Check out our configuration guide.

  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.

    Important

    The Zendesk CSAT app must have the chatter's email in order to share their rating with Zendesk. See the Limitations 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.

    Chatter Email

    Insert the email variable.

    email_variable.png

    CSAT Rating

    Insert the csat_score variable.

    csat_score_variable.png
  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

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 help@ada.support.