Skip to main content
The Handover Providers section in the Endpoint settings has been deprecated in 4.97. The removal date is September 2025. We encourage you to try our new Handover Providers interface, which offers greater flexibility for managing your integration with contact centers. For a smooth migration, refer to the migration guide.
The Sunshine Conversations Endpoint enables you to connect your AI Agent to the Zendesk’s Sunshine Conversations messaging platform.

Generic Endpoint Settings

Learn about the generic Endpoint settings on the following pages:

Specific Endpoint Settings

ParameterDescription
API VersionThe Sunshine Conversations API version Cognigy.AI uses to communicate with your app. Cognigy.AI supports version 1.1 and version 2. The version must match the one used to create the webhook in your Sunshine Conversations app.
Key IDThe API key ID from your Sunshine Conversations app. The format is app_XXXXXXXXXXXXXXXXXXXXXXXX. The key ID is paired with the secret you provide.
SecretThe API secret generated for your Sunshine Conversations app. This secret must match the key ID you entered earlier.
URIThe base URL for your Sunshine Conversations app. For example, https://app.smooch.io. Don’t include a trailing slash (/).

How to Set Up

  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.
  1. Go to the Sunshine Conversations Dashboard 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.AI Endpoint. Save Changes.
  1. In the Cognigy.AI 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.
  1. In your Sunshine Conversations app, go to Settings > Integrations > Webhooks.
  2. Click Add Webhook.
  3. Paste the Cognigy.AI 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.AI Endpoint version (v1.1 or v2). Save the webhook.

More Information

I