Sunshine Conversations

Integrate with Sunshine Conversations so your users can chat with your inGenious AI chatbot alongside your other connected channels. 

To integrate your chatbot with Sunshine Conversations:

  1. Create an app in Sunshine Conversations, if you don't already have one.
  2. Connect your inGenious AI chatbot to your Sunshine Conversations App.

Once you have integrated your chatbot with your Sunshine Conversations app, you can connect channels from Sunshine Conversations, such as the Smooch Web Messenger.

Let’s look at each of those steps in detail.

Step 1: Create an app in Sunshine Conversations

If you do not already have a Sunshine Conversations app you want to connect to:

  1. Log into your Sunshine Conversations dashboard.
  2. Create an app in Sunshine Conversations.
    Name your app something you will remember.
  3. Click Create App.
  4. Connect the messaging channels you want to use to your Sunshine Conversations app.

Refer to the Sunshine Conversations documentation on integrating your chosen channel.

Step 2: Connect your inGenious AI chatbot

Before you start

Make sure you're logged into your Sunshine Conversations account.

  1. Open inGenious AI.
  2. Turn on the Sunshine Conversations API integration for your chatbot:
    1. Open the chatbot you want to integrate and click Settings.
    2. Click Integrations.
    3. Toggle the Sunshine Conversations integration on.
  3. Click Connect to Sunshine Conversations.
    Your browser will launch your Sunshine Conversations dashboard in a popup window.
    If you do not see the dashboard, check your browser's popup blocker.
  4. If prompted, log in to your Sunshine Conversations account.
  5. Select the app you want to connect to Sunshine Conversations.
    This is the app you created in the first step.
  6. Click Allow.

Your browser will return to the inGenious AI platform, and populate the Sunshine Conversations integration settings. Once your chatbot is published, you can connect your Sunshine Conversation messaging channels.

Example: Add the Smooch Web Messenger widget to your website

Sunshine Conversations offers several different messaging channels you can connect to. This example guides you through connecting the Smooch Web Messenger:

  1. Connect the Smooch Web Messenger and find your integration ID
  2. Add the Smooch Web Messenger widget to your website.
  3. Initialise the Smooch Web Messenger widget.

Connect Smooch Web Messenger and find your Integration ID

Tip:

Have Notepad or a similar text editor open to copy your integration ID into.

To find your Integration ID:

  1. Log into the Sunshine Conversations dashboard.
  2. Go to the app that you have integrated with inGenious AI.
  3. Connect to the Web Messenger integration in the Sunshine Conversations dashboard.
  4. Click Confirm Integration.
  5. Copy the Integration ID from the Web Messenger integration page into Notepad.

Add the Smooch Web Messenger widget

Add this script near the end of the <head> section of your web pages, and replace <integration-id> with the integration ID you copied previously.

<script>
!function​ (​o​, ​p​, ​s​, ​e​, ​c​) { ​var​ ​i​, ​a​, ​h​, ​u​ = [], ​d​ = []; ​function​ ​t​() { ​var​ ​t​ = ​"You must provide a supported major version."​; ​try​ { ​if​ (​!​c​) ​throw​ ​new​ ​Error​(​t​); ​var​ ​e​, ​n​ = "https://cdn.smooch.io/"​, ​r​ = ​"smooch"​; ​if​ ((​e​ = ​"string"​ == ​typeof​ ​this​.​response​ ? JSON​.​parse​(​this​.​response​) : ​this​.​response​).​url​) { ​var​ ​o​ = p​.​getElementsByTagName​(​"script"​)[​0​], ​s​ = ​p​.​createElement​(​"script"​); ​s​.​async​ = ​!0​; var​ ​i​ = ​c​.​match​(​/([0-9]​+​)​\.​?​([0-9]​+​)​?​\.​?​([0-9]​+​)​?​/​), ​a​ = ​i​ ​&&​ ​i​[​1​]; ​if​ (​i​ ​&&​ ​i​[​3​]) s​.​src​ = ​n​ + ​r​ + ​"."​ + ​c​ + ​".min.js"​; ​else​ { ​if​ (​!​(​4​ <= ​a​ ​&&​ ​e​[​"v"​ + ​a​])) ​throw​ ​new Error​(​t​); ​s​.​src​ = ​e​[​"v"​ + ​a​] } ​o​.​parentNode​.​insertBefore​(​s​, ​o​) } } ​catch​ (​e​) { e​.​message​ === ​t​ ​&&​ ​console​.​error​(​e​) } } ​o​[​s​] = { ​init​: ​function​ () { ​i​ = ​arguments​; var​ ​t​ = { ​then​: ​function​ (​e​) { ​return​ ​d​.​push​({ ​type​: ​"t"​, ​next​: ​e​ }), ​t​ }, ​catch​: function​ (​e​) { ​return​ ​d​.​push​({ ​type​: ​"c"​, ​next​: ​e​ }), ​t​ } }; ​return​ ​t​ }, ​on​: function​ () { ​u​.​push​(​arguments​) }, ​render​: ​function​ () { ​a​ = ​arguments​ }, ​destroy​: function​ () { ​h​ = ​arguments​ } }, ​o​.​__onWebMessengerHostReady__​ = ​function​ (​e​) { ​if (​delete​ ​o​.​__onWebMessengerHostReady__​, ​o​[​s​] = ​e​, ​i​) ​for​ (​var​ ​t​ = ​e​.​init​.​apply​(​e​, i​), ​n​ = ​0​; ​n​ < ​d​.​length​; ​n​++) { ​var​ ​r​ = ​d​[​n​]; ​t​ = ​"t"​ === ​r​.​type​ ? ​t​.​then​(​r​.​next​) : t​.​catch​(​r​.​next​) } ​a​ ​&&​ ​e​.​render​.​apply​(​e​, ​a​), ​h​ ​&&​ ​e​.​destroy​.​apply​(​e​, ​h​); ​for​ (​n​ = 0​; ​n​ < ​u​.​length​; ​n​++)​e​.​on​.​apply​(​e​, ​u​[​n​]) }; ​var​ ​n​ = ​new​ ​XMLHttpRequest​; n​.​addEventListener​(​"load"​, ​t​), ​n​.​open​(​"GET"​, ​"https://"​ + ​e​ + ".webloader.smooch.io/"​, ​!0​), ​n​.​responseType​ = ​"json"​, ​n​.​send​() }(​window​, ​document​, ​"Smooch"​, ​"<integrationId>"​, ​"5"​); 
</script>

Initialise the Web Messenger widget

Add this script to the <body> of your web pages, replacing <integration-id> with the integration ID you copied previously.

<script>
Smooch.init({integrationId:}).then(function(){
  Smooch.on('widget:opened',function(){
    if(Smooch.getConversations().length===0){
      Smooch.createConversation();
    }
  });
});
</script>
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.