Sunshine Conversations: Deploy an Endpoint

SunshineConversations.PNG

Where is the Smooch Endpoint?

This Endpoint was previously known as the Smooch Endpoint. Smooch was acquired by Zendesk in 2019 and renamed to Sunshine Conversations.

Within our Cognigy.AI platform you're able to connect your Cognigy resources to your Sunshine Conversations application by using our Sunshine Conversations Endpoint integration.

Inject & Notify

You can use the Inject and Notify functionality with this type of Endpoint. For further details see:

Inject a Message to a Flow
and
Notify a Contact

Deploy a Sunshine Conversations Endpoint

With the implementation of a Sunshine Conversations Endpoint you can easily connect your Sunshine Conversations application with Cognigy.AI.

This How-to covers the necessary steps for creating and connecting a Sunshine Conversations Endpoint. If you want to get information about assigning a Flow to the Endpoint and setting up the Data Management see Endpoints.

Two Step Preparation Process

1 Configure Your Sunshine Conversations App for the usage of the Cognigy Endpoint on Sunshine Conversations API
2 Creation and configuration of the Sunshine Conversations Endpoint within Cognigy.AI

1 Configure Your Sunshine Conversations App

🔗 On Sunshine Conversations API

*Requirements**
✔ Sunshine Conversations Login
✔ A Sunshine Conversations Workspace

1.1 Create a Sunshine Conversations App

Create a Sunshine Conversations App for your Sunshine Conversations Workspace (see figure 1.1).

6684f48-Screenshot_from_2020-01-24_13-27-08.png
Figure 1.1: Create a Sunshine Conversations App

1.2 Connect to channels and integrations

Each Sunshine Conversations app can be configured with a collection of messaging channels like Facebook Messenger, WhatsApp or Slack. In addition to configuring messaging channels using the Sunshine Conversations dashboard, Sunshine Conversations also provides APIs to configure integrations programmatically. This is particularly useful when offering Sunshine Conversations messaging capabilities as a part of your own software product.

Go to the integration tab, select and configure your integration following the instructions. You can see how it's done here: Sunshine Conversations channels (see figure 1.2).

cb41cd5-Screenshot_from_2020-01-24_13-31-35.png
Figure 1.2: Connect with messaging channels

1.3 Get the Key ID and Secret for verification

To successfully connect your Sunshine Conversations App with the Cognigy.AI Endpoint you'll need the Key ID and Secret of your Sunshine Conversations App. Go to the Settings tab of your Sunshine Conversations App and go to the API keys section, press + Create new secret key and you will get a Key ID and a Secret. Copy and save them. Click on Save Changes.

2 Creation and configuration of the Sunshine Conversations Endpoint

🔗 On Cognigy.AI

Requirements
✔ Key ID
✔ Secret

2.1 Create a Sunshine Conversations Endpoint

First you have to create an Endpoint of the type Sunshine Conversations (see figure 2.1).

45e4883-Screenshot_from_2020-01-24_14-21-35.png
Figure 2.1: Create a Sunshine Conversations Endpoint

2.2 Configure the Sunshine Conversations Endpoint

Expand the Sunshine Conversations Setup panel (see figure 2.2) and paste the saved API Key ID and Secret (step 1.3) into the corresponding fields. In the URI field, just copy the base URL from your Sunshine Conversations App, depending which one you are using. It can differ from USA or EU, just look at the URL in your browser, e. g. "https://app.smooch.io".

Remove trailing slash ("/") from URL

It is very important that you insert the URL without its trailing slash ("/"). Therefore, the URL could look like the following: https://app.smooch.io

5b99529-Screenshot_from_2020-01-24_14-24-05.png
Figure 2.2: Endpoint Configuration - Sunshine Conversations Setup

2.3 Get the Endpoint URL

Move to the top of the Endpoint Configuration page and copy the Endpoint URL which is displayed above the General Settings (see figure 2.3).

7369a1f-Screenshot_from_2020-01-24_14-25-39.png
Figure 2.3: Endpoint configuration page of a Sunshine Conversations Endpoint

Final Step: Connect Your Sunshine Conversations App to the Endpoint

Create Webhook

Requirements
✔ Endpoint URL

In order to connect your Sunshine Conversations App to Cognigy.AI, you will need to add a Webhook in your integrations. The Webhook will be the bridge between Sunshine Conversations and Cognigy.AI. You can create a Webhook in the integrations tab (see figure 2.3 and 2.4).

b0deab2-Screenshot_from_2020-01-24_14-26-54.png
Figure 2.3: Add Webhook

9c3c6e7-Screenshot_from_2019-06-17_14-15-12.png
Figure 2.4: Webhook integration

Create a Webhook, you will be asked to fill in a URL. Here you have to paste the Endpoint URL. There are also some trigger options that you can use. For now, only AppUser messages and Postbacks are required (see figure 2.5).

afc24ae-Screenshot_from_2019-06-17_15-53-31.png
Figure 2.5: Webhook configuration

Create the Webhook and you will see a notification about the connection status on top of the page.

You should be all set up to use the Sunshine Conversations Endpoint you've created with a Flow of your choice.


Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.