Integrate your Certainly bot with Sunshine Conversations

Now that you’ve created your bot on the Certainly Platform, you're 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 allow 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

  1. Log in to Home - Sunshine Conversations, click the "Create new app" button, give it a name, then click "Create App". 
    Create_App.png
  2. Click "Connect channels":
    blobid1.png 
  3. On the Integrations Directory, scroll down to the Chatbots section and select the Certainly App:
    mceclip0.png 
  4. Click on the "Visit site to install" button: 

    mceclip1.png

Process on the Certainly Platform

  1. 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".

  2. 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 
  3. Grant the Certainly app permission to access your Zendesk account:
    Grant_permissions.png 
  4. You should now see that the bot is connected, as in the image below:
    blobid5.png 
  5. 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 
  6. Next, you'll want to ensure that your Certainly bot is the default integration, meaning it'll respond to incoming messages first.

    To do so, copy and paste your Sunshine Conversations app's API Key ID and Secret into the relevant fields in the Switchboard configuration section, then select the Enable Switchboard button:
    API_Key.png 
  7. 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 the Sunshine Conversations widget

  1. To add the Sunshine Conversations widget to your site, you can obtain the widget code and 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
  2. Follow their documentation and scroll down to the "Script Tag Method" section for instructions on how to add the widget code and integration ID to the script and place it on your site.

  3. 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!