Zendesk

Overview

When your customers start a new conversation, the Quiq system will create a new Zendesk ticket for the conversation, depending upon your configuration. You may request a Quiq employee to complete this setup, or you can proceed with these steps on your own.

🚧

YOUR_QUIQ_TENANT

NOTE - Throughout the document “YOUR_QUIQ_TENANT” is used as a placeholder for the name of your Quiq tenant. This is typically the first portion of your Quiq site URL. Confirm this name before proceeding with the configuration.

Integration Account

An administrator account in the Zendesk system must be created to allow Quiq to sync tickets via Zendesk. The account name should be Quiq Integration, and email should be: [email protected].

Zendesk Single Sign On

When Quiq is integrated with Zendesk, user authentication is handled via Zendesk. Zendesk users automatically have access to Quiq, and it is not necessary to create users in Quiq. However, Quiq Manager and Admin permissions must be granted to users once their account has been created from Zendesk. Additionally, users must be added to Roles when multiple queues are used. Reference the Admin Manual for specifics of user management.

Follow these steps to enable Zendesk account management:

1. Go to the Zendesk Admin area

2. Under “Apps and Integrations” click on the “Zendesk API” link

3. Click on the “OAuth Clients” tab

4. Click the “Add OAuth client” button to create a new OAuth client

5. For Client Name input “Quiq”

6. For Description input “Quiq Messaging”

7. For Company input “Quiq”

8. For Logo you may leave it blank or upload the Quiq logo from here

9. Unique Identifier should be automatically set to “Quiq”

10. For Client kind click the drop-down and select “Confidential”

11. For Redirect URLs put the following two lines into the text area:

• https://YOUR_QUIQ_TENANT.goquiq.com/idp/callback/zendesk
• https://inbound-YOUR_QUIQ_CLUSTER.goquiq.com/idp/callback/zendesk

12. Click Save and then click OK

13. Click Copy to copy the OAuth secret

14. Paste the secret into your text editor

15. Save the OAuth App

16. Securely share the secret with Quiq

📘

In September 2025, Zendesk changed how apps connect to a Zendesk instance. Learn more. Below you will find updated instructions.

Share Information with Quiq

Work with Quiq employees to transfer your OAuth app name, OAuth app secret, API and account ID Quiq. Quiq will use this information to create Quiq as a Channel in your Zendesk site as well as a custom field that is required for the integration.

Connecting Quiq and Zendesk

1. Make sure that you are an admin both in Quiq and in Zendesk and have completed the above step. To set up the new connection style with Quiq - navigate to the Quiq Admin area and go to the Zendesk section of the Quiq Admin area. From there click Re-Authorize Connection.
2. After clicking the “Re-Authorize Connection” button, a pop-up window will appear and direct you through Zendesk’s flow to allow Quiq access to connect to your Zendesk instance. If required, please fill in your Zendesk account ID and password.

3. Next you will be prompted to allow Quiq to access your Zendesk instance. Please click “Allow”.

4. Finally you should see the pop-up window display the following image, which means the connection was successful and you may close the pop-up window

4. Back in the Quiq Admin area, you should see that the connection status shows as “Connected.” If for any reason it shows “Disconnected,” please click to the “Test Connection” button to see if that resolves the issue.

Zendesk Quiq Messaging App

To view conversation history within tickets in Zendesk, install the Zendesk Quiq Messaging App. Add the app to your Zendesk instance by clicking the link below and following the instructions there:

Get started with Quiq and Zendesk

Testing

Let your Quiq Implementation specialist know when all the steps are completed, and we will test together to ensure that everything is working properly.