Integrate your Certainly bot with Sunshine Conversations

Now that you’ve created your bot on the Certainly Platform, you are able to connect it to the Sunshine Conversations platform. This article will focus on connecting your Certainly bot to the Sunshine Conversations Web Messenger Widget.

Integrating with Sunshine Conversations will enable your bot to communicate with your customers across every popular messaging app. Learn more in the Sunshine Conversations documentation.

Below, we'll walk you through the following: 

An Administrator role in Sunshine Conversations is required to complete this integration.

Process on the Sunshine Conversations platform

Log in to Home - Sunshine Conversations, click the "Create new app" button, give it a name, then click "Create App". 

Create_App.png

Click "Connect channels":

blobid1.png

On the Integrations Directory, scroll down to the Chatbots section and select the Certainly App:

mceclip0.png

Click on the "Visit site to install" button: 

mceclip1.png

Process on the Certainly Platform

Once on the Certainly Platform, open up the bot you wish to connect to Sunshine Conversations, then navigate to Bot Settings > Channels. In the Sunshine Conversations section, click "Connect with Sunshine".  You’ll then be asked to enter your Zendesk subdomain, click sign in and enter the credentials of your Zendesk bot account when prompted:

Enter_Subdomain.png

 

Grant the Certainly app permissions to access your Zendesk account:

Grant_permissions.png

You should now see that the bot is connected, as in the image below:

blobid5.png

Head back to the Sunshine Conversations platform, click on your app, and you’ll see the Overview screen where you can confirm the platforms are connected:

Connections.png

To ensure that your Certainly bot is the default integration (meaning it'll respond to incoming messages first), copy/paste your Sunshine Conversations app's API Key ID and Secret into the relevant fields in the Switchboard configuration section, then click the Enable Switchboard button:

API_Key.png

You'll be presented with a dropdown list, select Certainly to ensure your bot will be the first responder to incoming messages:

SunCo_-_Set_Default_Integration.png  

The connection is now complete.

Embed Sunshine Conversations Widget

To add the Sunshine Conversations widget to your site, you can obtain the widget code & integration ID from the Sunshine Conversations platform by clicking "Configure" next to Web Messenger and scrolling down the page to steps 3 and 4:

Sunhine_Conversations_Widget_Script.png

Sunhine_Conversations_Integration_ID.png

Follow their documentation and scroll down to the "Script Tag Method" section for instructions on how to add the widget code & integration ID to the script and place it on your site.

To customize (colors, widget logo, etc.) the Sunshine Conversations Widget, click "Configure" next to the Web Messenger integration.

mceclip5.png

You've now integrated your Certainly bot with Sunshine Conversations. Congrats!