Authorizations Supported
The XO Platform supports basic authentication for Zendesk. See App Authorization Overview for details.| Authorization Type | Basic OAuth |
|---|---|
| Pre-authorize the Integration | Yes |
| Allow Users to Authorize the Integration | Yes |
Step 1: Enable the Zendesk Action
Prerequisites:- If you don’t have Zendesk credentials, create a developer account. See Zendesk Developer Documentation.
- Copy the User sub domain, username/email, password, and API token of your Zendesk account.
- Go to App Settings > Integrations > Actions.
- Select Zendesk.
Pre-authorize the Integration
Basic OAuth- Go to App Settings > Integrations > Actions and select Zendesk.
- In Configurations, select the Authorization tab.
-
Set Authorization Type to Pre-authorize the Integration > Basic Auth.
-
Enter the following details:
- User Sub Domain – The instance name of the Zendesk account.
- Username or Email – The username or email of the Zendesk account.
You must enter /token after the email address to authenticate. For example,john@example.com/token.- API Token – The password token of the Zendesk account.
-
Click Save. The Integration Successful pop-up is displayed.
The Zendesk action moves from Available to Configured after enabling. -
You can also click Skip for Now to install templates later. See Using the Zendesk Action Templates.
Allow End User to Authorize
- Go to App Settings > Integrations > Actions and select Zendesk.
- In Configurations, select the Authorization tab.
- Select Basic Auth as the authorization type. See App Authorization Overview.
-
Click Select Authorization > Create New.
-
Set Authorization Type to Allow Users to Authorize the Integration > Basic Auth, then enter the following credentials:
- Name – Name for the Basic Auth profile.
- Base URL – Base tenant URL for the Zendesk instance.
- Authorization Check URL – Authorization check URL for your Zendesk instance.
- Description – Description of the profile.
- Click Save Auth.
- Select the new Authorization Profile.
- Click Save.
Step 2: Install the Zendesk Action Templates
-
On the Integration Successful dialog, click Explore Templates.
-
Click Install to begin installation.
-
Once installed, click Go to Dialog. A dialog task for each template is auto-created.
-
Select the desired dialog task and click Proceed.
-
The dialog task is auto-created and the canvas opens with all required entity nodes, service nodes, and message scripts.