Zendesk Service

Zendesk is a cloud-based customer service platform that is designed to improve communication between an organization and its customers. Zendesk Service helps to keep businesses in sync and delivers an omnichannel customer experience. This document describes how to connect IBM watsonx Orchestrate to Zendesk Service and use its skills on watsonx Orchestrate.

Before you begin

Before you connect watsonx Orchestrate to Zendesk Service, make sure that you have a Zendesk Service account. If you don't have a Zendesk Service account, you can create one here.

Connecting to Zendesk Service

Important:
- A credential type must be set for apps that are a part of team skill sets and AI assistants. Skill-based actions in AI assistants support only shared credentials.
- If a credential type of an app is not specified, an error message is displayed when users attempt to run the skills of the app. To resolve the error, an admin must set the credential type for the app. For more information, see Managing connections.

An app can be connected either through the skill catalog or through the watsonx Orchestrate chat. Use the method that suits you to connect to an app.

Connect to the app through the skill catalog when you add that skill to your skill set:

  1. On the watsonx Orchestrate chat page, click Add skills from the catalog.
  2. Search and click the app tile.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Otherwise, connect to that app through the watsonx Orchestrate chat when you use the skill:

  1. Open the watsonx Orchestrate chat.
  2. On the chat, start the skill.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Configuring the connection on watsonx Orchestrate SaaS

To connect watsonx Orchestrate to Zendesk Service, complete the following steps:

  1. Click Connect app.
  2. In the Subdomain, enter your Zendesk subdomain. Get the Zendesk subdomain in the URL address that you use to access your Zendesk account. For example, if the URL address is "example.zendesk.com", then the subdomain is "example". For more information, see Getting the connection values: Subdomain.

It redirects you to sign in to a Zendesk Service account to permit watsonx Orchestrate to access that account. After you accept, watsonx Orchestrate connects to it automatically.

Note:
  • If you already have an active Zendesk connection in your browser, that connection is used for the authentication. Log out of the active connection to connect to a different Zendesk account.
  • The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Configuring the connection on watsonx Orchestrate on-premises

To connect watsonx Orchestrate to Zendesk Service, complete the following steps:

  1. Click Connect app.
  2. In the Subdomain, enter your Zendesk subdomain. Get the Zendesk subdomain in the URL address that you use to access your Zendesk account. For example, if the URL address is "example.zendesk.com", then the subdomain is "example".
  3. In the Access token, enter the Zendesk access token. Generate the access token from the application client ID and client secret.

For more information on getting the connection values, see Getting the connection values.

Note: The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Getting the connection values

Follow the steps to get the connection values to connect watsonx Orchestrate to Zendesk Service.

Subdomain

For instructions on getting your Zendesk subdomain, see Where can I find my Zendesk subdomain? on the Zendesk Help page.

Access token

For instructions on getting the access token from Zendesk Service, see Get an access token from Zendesk on the Zendesk Help page.

What to do next

After you connect to the app, you can use the Zendesk Service skills. For more information see, Using the chat.

To learn about the available skills, see List of prebuilt apps, skills and skill flows.


Parent topic:

Connecting to apps