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

# Sunshine Conversations

<a href="/release-notes/2026.16"><Badge className="version-badge" color="blue">Updated in 2026.16.0</Badge></a>

<Frame>
  <img src="https://mintcdn.com/cognigy-15abf2ba/gMdd3UtLaZzJw9j6/_assets/ai/deploy/endpoint-reference/sunshine-conversations.png?fit=max&auto=format&n=gMdd3UtLaZzJw9j6&q=85&s=f4030d6d61c1af2f7959132e637de24c" alt="Sunshine Conversations Endpoint logo" width="384" height="59" data-path="_assets/ai/deploy/endpoint-reference/sunshine-conversations.png" />
</Frame>

The Sunshine Conversations Endpoint enables you to connect your AI Agent to the [Zendesk's Sunshine Conversations messaging platform](https://app.smooch.io/).

## Generic Endpoint Settings

Learn about the generic Endpoint settings on the following pages:

* [Endpoints Overview](/ai/agents/deploy/endpoints/overview)
* [NLU Connectors](/ai/platform-features/nlu/external/nlu-connectors/overview)
* [Data Protection & Analytics](/ai/agents/deploy/endpoints/data-protection-and-analytics)
* [Real-Time Translation Settings](/ai/agents/deploy/endpoints/real-time-translation-settings)
* [Session Management](/ai/agents/deploy/endpoints/session-management)
* [Transformer Functions](/ai/for-developers/transformers/overview)
* [Inject and Notify](/ai/agents/deploy/endpoints/inject-and-notify)
* [Copilot](/agent-copilot/configure/copilot-section)

## Specific Endpoint Settings

<Accordion title="Sunshine Conversations Setup">
  | Parameter   | Description                                                                                                                                                                                                                 |
  | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | API Version | The Sunshine Conversations API version Cognigy uses to communicate with your app. Cognigy supports version 1.1 and version 2. The version must match the one used to create the webhook in your Sunshine Conversations app. |
  | Key ID      | The API key ID from your Sunshine Conversations app. The format is `app_XXXXXXXXXXXXXXXXXXXXXXXX`. The key ID is paired with the secret you provide.                                                                        |
  | Secret      | The API secret generated for your Sunshine Conversations app. This secret must match the key ID you entered earlier.                                                                                                        |
  | URI         | The base URL for your Sunshine Conversations app. For example, `https://app.smooch.io`. Don't include a trailing slash (`/`).                                                                                               |
</Accordion>

## How to Set Up

<AccordionGroup>
  <Accordion title="1. Create a Sunshine Conversations Endpoint">
    1. In the left-side menu of your Project, click **Deploy > Endpoints**.
    2. On the **Endpoints** page, click **+ New Endpoint**.
    3. In the **New Endpoint** section, do the following:
       1. Select the **Sunshine Conversations** Endpoint type.
       2. Specify a unique name.
       3. Select a Flow from the list.
    4. In the **Configuration Information** section, copy the URL from the **Endpoint URL** field.
  </Accordion>

  <Accordion title="2. Create a Sunshine Conversations App">
    1. Go to the [Sunshine Conversations Dashboard](https://app.smooch.io/) and log in with your Zendesk account.
    2. If you don't have a workspace yet, create one first. Otherwise, select your existing workspace.
    3. Click **Create App**. Enter the name and description for your app. Click **Create**.
    4. Go to the **Channels** or **Integrations** tab. Add the messaging channels you want, for example, WhatsApp, Facebook Messenger, Slack. Follow the Sunshine Conversations instructions for each integration.
    5. Open the **Settings** tab of your app. Go to **API Keys** and click **+ Create new secret key**.
    6. Copy the **Key ID** and **Secret** for later use in the Cognigy Endpoint. Save Changes.
  </Accordion>

  <Accordion title="3. Complete the Endpoint Configuration">
    1. In the Cognigy interface, open the Sunshine Conversations Endpoint you created.
    2. In the **Sunshine Conversations Setup** section, fill in the required fields:
       * **API Version** - select either v1.1 or v2, matching your Sunshine Conversations app.
       * **Key ID** - paste the key ID you copied from Sunshine Conversations.
       * **Secret** - paste the secret you copied.
       * **URI** - use your app's base URI, for example, `https://app.smooch.io` (omit the trailing `/`).
    3. Save changes.
  </Accordion>

  <Accordion title="4. Add a Webhook in Sunshine Conversations">
    1. In your Sunshine Conversations app, go to **Settings > Integrations > Webhooks**.
    2. Click **Add Webhook**.
    3. Paste the Cognigy Endpoint URL you copied earlier into the **URL** field.
    4. For **Triggers**, select at least the following options:
       * `AppUser messages`
       * `Postbacks`
    5. Ensure the **API Version** matches your Cognigy Endpoint version (v1.1 or v2). Save the webhook.
  </Accordion>
</AccordionGroup>

## More Information

* [Cognigy Help Center: Sunshine Conversations Deployment](https://support.cognigy.com/hc/en-us/articles/360016307699-Sunshine-Conversations-Deploy-an-Endpoint)
* [Cognigy Help Center: Sunshine Conversations Zendesk Handovers](https://support.cognigy.com/hc/en-us/articles/360016224599-Sunshine-Conversations-Zendesk-Handovers)