> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/integrations/helpdesk/zendesk/enabling-sunshine-api-for-website-tickets.md).

# Enabling Sunshine API

You can optionally enable the Sunshine Conversations API for website chat tickets. This will enable the live chat interface in Zendesk for tickets from the Alhena website chat widget.

By default, website chat tickets will appear in Zendesk as email style threads. While live chat works this way, enabling the Sunshine Conversations API gives an improved live chat experience. With Sunshine Conversations, Zendesk enables the send button in the message composer, enables the enter key on the keyboard, and disables email signatures when replying to chat threads.

## Enabling the Sunshine Conversations API

Follow these steps to Enable the Sunshine conversations API:

First, navigate to the Zendesk Integration Settings page. You'll see a configure button next to "Alhena AI Web Chat" if website chat has been enabled.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FKRKXbdRIgF976ZyT2yLl%2FScreenshot%202025-05-27%20at%209.45.44%E2%80%AFAM.png?alt=media&amp;token=784849f6-9dad-4752-bd1c-b4ea8ddfbf5c" alt=""><figcaption></figcaption></figure>

Clicking this button will allow you to configure more settings for the website chat widget. From here, click the toggle next to Sunshine Conversations API

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FLKecYwhHkvS6RdsxAZ7s%2FScreenshot%202025-05-27%20at%209.46.52%E2%80%AFAM.png?alt=media&amp;token=220f5b9a-7e8a-40c0-aaaa-d5d04189491d" alt=""><figcaption></figcaption></figure>

If you've already provided your Sunshine Credentials for the Zendesk WhatsApp integration, then all you need to do is click Save Changes now. Otherwise, you'll need to create a Sunshine Conversations API key and provide it here. Click "Create an API key" and the Zendesk admin page will open where you can do this.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FDthSR10vSqhbHc6frNoa%2FScreenshot%202025-05-27%20at%209.47.04%E2%80%AFAM.png?alt=media&amp;token=8f04d8ef-2a12-4c0a-98b8-a52b8f8d880f" alt=""><figcaption></figcaption></figure>

You can provide any name to your new API key. Then copy the credentials into the matching fields on the Alhena dashboard page in the previous step:

* **App ID**
* **Key ID**
* **Secret Key**

Once all three fields are filled in, click Connect.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2Fnci3K13AG6ffjl9zY54T%2Fimage.png?alt=media&amp;token=1482ed44-ff90-4f3f-b39b-c733abcc650b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FJODksseotWpFyIVPNwIM%2Fimage.png?alt=media&amp;token=71727bb6-2733-420a-84f3-bff731016348" alt=""><figcaption></figcaption></figure>

That's it! Now Alhena will start creating new website tickets as chat threads inside of Zendesk.

Here is how chat threads will look in Zendesk:

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FhVPn8b6RXrky1VK1GrIn%2FScreenshot%202025-05-27%20at%2010.37.54%E2%80%AFAM.png?alt=media&amp;token=2981993f-3c36-4668-9ec5-747b17a35c6d" alt=""><figcaption></figcaption></figure>

If you've chosen to collect email or phone number, you can chose to reply to the user by email or call them as well.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FIPQYZ2RYRz8ft4Nx9K1r%2FScreenshot%202025-05-27%20at%2010.38.37%E2%80%AFAM.png?alt=media&amp;token=496605c9-fc0c-462b-a6c3-85c6ecc36afb" alt=""><figcaption></figcaption></figure>