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.
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
Sunshine Conversations Login
A Sunshine Conversations Workspace
Create a Sunshine Conversations App for your Sunshine Conversations Workspace (see figure 1.1).
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).
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.
First you have to create an Endpoint of the type Sunshine Conversations (see figure 2.1).
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:
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).
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).
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).
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.
Updated almost 2 years ago