> For the complete documentation index, see [llms.txt](https://docs.deepconverse.com/product-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deepconverse.com/product-docs/conversational-flow-builder/conversation-blocks/zendesk-sunshine-conversations-handoff-in-widget.md).

# Zendesk Sunshine Conversations Handoff (In Widget)

We will walkthrough the setup required to do the Sunshine Conversations Handover using the DeepConverse chat widget.&#x20;

{% hint style="info" %}
This article allows you to do a handoff to Zendesk within DeepConverse chat widget&#x20;
{% endhint %}

1. Make sure you have connected to **Zendesk Sunshine Conversations** via the **Connections** page

2. Navigate to **Zendesk Admin** > **Bots**. Here you will see DeepConverse under marketplace bots. <br>

   <figure><img src="/files/PfJAKR9kCJc8mS67eSY1" alt=""><figcaption></figcaption></figure>

3. Go ahead and navigate to **Messaging** to see if the web widget channel is active.<br>

   <figure><img src="/files/B0Zrc7x2jM0kwsj91H5i" alt=""><figcaption></figcaption></figure>

4. Create an API Key for the Conversations API for DeepConverse. <br>

   <figure><img src="/files/hhRkOGhutyXzSrybaQzQ" alt=""><figcaption></figcaption></figure>

5. Reach out to the DeepConverse team to find out the **Web Messenger Integration Id** to use for the handoff. This is found via the integrations API \
   [`https://api.smooch.io/v2/apps/{{appId}}/integrations`](https://api.smooch.io/v2/apps/{{appId}}/integrations)<br>

6. Use the Web Messenger Integration Id along with the connection and fields to pass to Zendesk in the Escalation Flow.\ <br>

   <figure><img src="/files/aFyYoSXhjsBp9dU6cc1A" alt=""><figcaption></figcaption></figure>

7. In order for DeepConverse to receive the Conversation events add a Conversation Integration with the following API: \
   \
   [`https://api.converseapps.com/messaging/smooch/events`](<https://api.converseapps.com/messaging/smooch/events&#xA;>)<br>

   <figure><img src="/files/rVfwKhB0OrrB4lhXeqdy" alt=""><figcaption></figcaption></figure>

#### Fields Available in Handoff

<table><thead><tr><th width="370">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>tags</td><td>Comma separated list of tags to add to Zendesk ticket</td></tr><tr><td>brand_id</td><td>Id of the Zendesk brand to use</td></tr><tr><td>priority</td><td>Priority of Zendesk ticket</td></tr><tr><td>requester.name</td><td>Name of the requester (Use $ to reference a parameter)</td></tr><tr><td>requester.email</td><td>Email of the requester</td></tr><tr><td>&#x3C;field_id></td><td>Custom field value to set</td></tr></tbody></table>
