How to Integrate Sunshine Conversations

Prerequisites:

1. Your Zendesk account must have access to the Conversations API.
2. Ensure that the Agent Workspace is enabled in your Zendesk setup.
3. You will need to obtain the following credentials from your Conversations API:
   1. • App ID
      • API Key ID
      • API Key Secret
4. Ensure that you have already integrated Forethought with Zendesk Chat before proceeding with this setup.

Obtaining the Conversations API Credentials

1. In the Zendesk Admin Setting, click Conversations API > Create API Key.

   

2. Enter a name for the key and click Next.
3. Copy the keys from this page before clicking Next. You will NOT be able to see the full Secret Key again once you click Next and that key is necessary for the OAuth flow below. Once copied, click Next and the API key will be created. You will need these three keys to complete the OAuth flow.

   

Integrating with Forethought

1. Go to the Integrations tab on your Forethought Dashboard page. Search for the Sunshine Conversations integration and click Connect.
2. You'll be redirected to a new page where you will be prompted to sign into your Zendesk account. Sign in to your account.
3. Click Allow on the following page.
4. You will be redirected to another a page that will ask for the App ID, API Key, and the API Secret that was gathered in the prerequisite steps. Input and submit those.
5. You will then be taken back to the Forethought Dashboard integration page where you can start building workflows under the Workflow Builder tab! You will be able to execute those workflows on any conversation channel that is set up from your Sunshine Conversations app.

Disconnecting Sunshine Conversations

1. Click the Delete button on your Sunshine Conversations integration