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 customers across all popular messaging apps. Learn more in the Sunshine Conversations documentation.

Below, we'll walk you through the following: 

An Admin role in Sunshine Conversations is required to complete the integration.

Process on the Sunshine Conversations platform

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

    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, select "Connect with Sunshine".

  2. You’ll then be asked to enter your Zendesk subdomain, select "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 and select your app. You’ll then 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 will 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 "Enable Switchboard":
    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!

Once the Switchboard integration is established, it is not possible to edit the settings or use other tokens (ID and Secret) unless the Switchboard is removed and added again. This process will require a  small amount of downtime.

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 selecting "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 to learn 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, select "Configure" next to the Web Messenger integration.
    mceclip5.png
You've now integrated your Certainly bot with Sunshine Conversations. Congrats!