Breadcrumbs

Zendesk Livechat

This guide explains what you, as the customer, need to provide to enable the integration between Zendesk Livechat and our platform.

1. Create Conversation API

  1. Click on the 4 tile icon on header (Right)

  2. Select Admin Center

  3. Navigate to App and Integrations > APIs > Conversation API

  4. Click Create API Key

  5. Give a name and click Create

  6. Copy the following credentials: App ID, Key ID, Secret Key

NOTE: Make sure Key ID should start with app_. Example: app_7987899098767....... This means you have given app scope permission on the API key.

Warning: Secret Key will only be generated once, so make sure to keep it safe. You can't generate or see it again.

image-20251202-073644.png

2. Create New Integration

  1. Navigate to Admin Center > Apps and Integrations > Integrations > Conversation Integrations

  2. Click on Create Integration

  3. Configure the integration:

    • Give a name

    • Copy the Webhook URL from Marketplace UI and paste it in Webhook URL

    • Keep everything else as default

    • For Webhook subscriptions, select:

      • Conversation Message

      • Participant Left Conversations

  4. Save the integration

    image-20251202-073724.png

3. Create Zendesk API Token

  1. Navigate to Admin Center > Apps and Integrations > APIs > Zendesk APIs

  2. Click on Add API Token

  3. Copy the API Token

  4. Click Save

image-20251202-073823.png

Warning: Make sure to copy and store this token. We won't show it again after you click Save or leave this page.

4. Create OAuth Client

  1. On the same page, click on OAuth Client

image-20251202-075751.png

  1. Click Create

  2. Configure the client:

    • Give a name

    • Add fields like: company, logo, etc.

    • Keep Client kind as Public

  3. Click Save

  4. Important: After saving, please don't click OK/Back

  5. Copy the Client ID from the URL and keep it safe

image-20251202-075828.png

5. Setup in Zendesk

This setup may require involving Zendesk support.

Configure Omnichannel Routing

  1. Customers need to set up omnichannel in Zendesk live chat. If not already configured, they may need to contact Zendesk support for assistance

  2. In Admin Center, navigate to Objects and Rules > Omnichannel routing

  3. Configure queue and routing rules as per your requirements

  4. Make sure to include Sunshine Conversation API in the Queue

image-20251202-075917.png


Enable Multi-Conversations for Single Users

  1. In Admin Center, click Channels in the sidebar

  2. Select Messaging and social > Messaging

  3. At the top of the page, click Manage settings

  4. Under Web Widget and Mobile SDKs, expand Multi-conversations

  5. Click Set up multi-conversations

  6. Click Turn on multi-conversations for your account

  7. Select the channels on which you want to offer multi-conversations

image-20251202-075955.png

  1. Click Save