The Channel framework lets you integrate origin services with Zendesk Support. It enables mirroring content between those origin services and Zendesk Support and agents to support customers on origin services through Zendesk Support.
In this tutorial, you'll build an integration service for WordPress. Zendesk Support will call the integration service periodically, converting WordPress blog comments into Zendesk Support tickets and comments. Agents can respond in Zendesk Support. The Channel framework sends these agent responses to the integration service, which creates corresponding comments in WordPress.
- Step 1: Setup the developer environment
- Step 2: Get resources from the origin service (Polling)
- Step 3: Add logging of event callbacks
- Step 4: Post new resources to the origin service (Channelback)
- Step 5: Connect the integration service to Zendesk Support - Part 1 (Admin UI, Manifest)
- Step 6: Connect the integration service to Zendesk Support - Part 2 (Zendesk app)
- Step 7: Store state information in Zendesk Support (Metadata, Pull State)
- Step 8: Provide native resource links in Zendesk Support (Clickthrough)
Difference between integrating with the Channel framework and the Zendesk REST API
Building an integration using the Zendesk REST API requires extensive knowledge of the Zendesk Support data model, and of course of the Zendesk API. Building an integration using the Channel framework doesn’t require any knowledge of the Zendesk Support data model or APIs. Instead, the integration exposes itself as a web service. It implements methods specified by Zendesk Support, but it doesn’t need to call it at all. The methods it exposes are not dependent on internal Zendesk Support details.
This tutorial requires you to:
- Install applications on your computer. (Note: We have not tested the instructions with role escalation. You may need extra configuration if you're sudoing.)
- Use the
curlcommand for testing.
- Have access to a Zendesk Support account for testing
This tutorial uses WordPress as the origin service. To run everything in this tutorial, you need:
- Database for WordPress
- "rest-api" WordPress plugin
- "JSON Basic Authentication" WordPress plugin
- Node for integration service
- Ruby for the Zendesk App Tools
Refer to the installation instructions of these applications on how to install them.