> ## Documentation Index
> Fetch the complete documentation index at: https://botpress.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk Messaging

{/* vale on */}

[Open in Hub](https://studio.botpress.cloud/home?exploreHub=1\&hubItemId=intver_01KMZARX5E90SJEDCQ6GKZ4ZBV)
*v2.0.1*

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/sunshine-conversation-zendesk.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=7d3de296e905b6646f1514664745cb69)

You can also use the Sunshine Conversations integration to connect Botpress to Zendesk Messaging.

## Prerequisites

* A [Zendesk Support Professional plan account](https://www.zendesk.com.br/pricing/support) with Zendesk Messaging enabled to the desired channels
* A [Botpress Cloud account](https://sso.botpress.cloud) and a [Botpress Bot](https://botpress.com/docs/get-started/quick-start.md)

## Setup in Botpress

1. Go to the [Integration Hub](https://app.botpress.cloud/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.

The Sunshine Conversations integration has the following 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

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/sunshine-conversation-config.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=180be210d8926818902a20354ad2a12c)

## Setup in Zendesk

### Configure the Webhook

1. Open your Zendesk Admin Center.

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/zendesk-admin-center.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=3de1cbfae9560916ac10f71c93e107fa)

2. Click on **Apps and Integrations** and **Conversations Integrations**

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/zendesk-integrations.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=36b1f25dd5bacb875f1d690033cfe47d)

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

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/zendesk-webhooks.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=d57a602957b010e8124dfe5cfb44c9ff)

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**

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/zendesk-secret.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=18e7a079171aa352842b83f832ab842e)

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/sunshine-conversation-integration-config.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=309b2cf1a2d24ed2d3543dc24ed5cc00)

### Configure the API Credentials

1. Click on **Apps and Integrations** view and **Conversation API**

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/zendesk-conversations-api.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=ef733daa1a06957e28579417a98bedfe)

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.

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/sunshine-conversation-integration-config-2.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=7c4b7031b8f9877e497e443b9a407ec6)

![](https://mintcdn.com/botpress/KbMT91f_P0tr2fc3/integrations/integration-guides/sunshine-conversations/assets/sunshine-conversation-shared-secrets.png?fit=max\&auto=format\&n=KbMT91f_P0tr2fc3\&q=85\&s=de584e5c2bd5d10c4458f2cd437e1229)

### Save Configuration

Channel configuration is complete, you can now click **Save**

That's it, you may now start chatting with your bot on any channel from Zendesk Channels!

OBS: Please ensure that you enabled Zendesk Messaging for the required Zendesk Channel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.