# 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.

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&#x26;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&#x26;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&#x26;token=8f04d8ef-2a12-4c0a-98b8-a52b8f8d880f" alt=""><figcaption></figcaption></figure>

You can provide any name to your new API key. Then copy the credentials to the Alhena dashboard page in the previous step, and 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&#x26;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&#x26;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&#x26;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&#x26;token=496605c9-fc0c-462b-a6c3-85c6ecc36afb" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alhena.gitbook.io/docs/integrations/helpdesk/zendesk/enabling-sunshine-api-for-website-tickets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.