Zendesk Messaging

​

Prerequisites

• A Zendesk Support Professional plan account with Zendesk Messaging enabled to the desired channels
• A Botpress Cloud account and a Botpress Bot

​

Setup in Botpress

1. Go to the Integration Hub in Botpress Cloud (if you don’t have the integration installed yet).
2. Find and open the Sunshine Conversations integration then click on the “Install to Bot” button, now go back to your bot settings.

• Enabled: Whether Botpress will communicate with this channel
• Webhook URL: The URL for receiving data in Botpress (Copy this)
• App ID: The App ID of your Zendesk Conversation API Credentials
• Key ID: The Key ID of your Zendesk Conversation API Credentials
• Key Secret: The Key Secret of your Zendesk Conversation API Credentials
• Webhook Secret: The Webhook Secret of your Zendesk Conversation Integration Webhook

​

Setup in Zendesk

​

Configure the Webhook

1. Open your Zendesk Admin Center.

2. Click on Apps and Integrations and Conversations Integrations

3. Give any name and put the webhook URL that you copied from Botpress.

4. Also select Conversation message and Postbacks on Webhook subscriptions.
5. Click Save at the bottom right corner.
6. Copy the Shared Secret and past on the Botpress Integration Configuration page at Webhook Secret

​

Configure the API Credentials

1. Click on Apps and Integrations view and Conversation API

2. Click on Create API key and give it any name, then Next.
3. Copy App ID, Key ID, Secret key and put them on the associated field on the integration configuration.

​

Save Configuration