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.
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.
An administrator account in the Zendesk system must be created to allow Quiq to sync tickets via the Zendesk API. The account name should be Quiq Integration, and email should be: [email protected].
1. While logged in with the integration account from above create an API token
2. Go to the Zendesk Admin area
3. Under “Channels” click on the “API” link
4. Click on the “Plus” icon to create a new token for use with Quiq - DO NOT SAVE this token yet
5. Click on the “Copy” button to copy the token to your clipboard
6. Paste the token into your notepad program or another text editor
7. Click on the “Save” button to save the token in Zendesk
8. Securely share the token with Quiq
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 “Channels” click on the “API” link
3. Click on the “OAuth Clients” tab
4. Click the “Plus” icon to create a new OAuth client
5. For Client Name input “Quiq”
6.For Description input “Quiq Messaging”
7. Company should be automatically set to “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 Redirect URLs put the following two lines into the text area:
11. Click Save and then click OK
12. Click Copy to copy the OAuth secret
13. Paste the secret into your text editor
14. Save the OAuth App
15. Securely share the secret with Quiq
Work with Quiq employees to transfer your OAuth app name, OAuth app secret, API account ID and API token into 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.
Quiq should contact you letting you know that the first phase of the integration is in place. At this point you can log in to Quiq with your Zendesk credentials, but ticket creation has not been set up completely.
1. Login to Quiq
2. In a separate tab, go to your Zendesk admin area
3. Under “Channels” click on the “Channel Integrations” link
4. You should see a button for a “Quiq Channel” - click the button
5. Select the “Accounts” tab
6. Click the “Add account” button
7. In the Quiq base url field, input the base URL for your Quiq instance
10. For display name choose “Quiq”
111. Click submit and you should see the account you created on the accounts tab
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:
Let your Quiq Implementation specialist know when all the steps are completed, and we will test together to ensure that everything is working properly.
Updated about 1 year ago