Skip to main content

Sunshine Conversations

Sunshine Conversations is a messaging platform that allows businesses to interact with their customers across the various messaging apps such as Facebook Messenger, WhatsApp, Instagram, and SMS. The Sunshine Conversations bot allows you to send text, images, files, cards, and quick replies.

For instance, if a business has integrated Sunshine conversations with Facebook, it creates a Sunshine conversations channel for Facebook. Businesses can use this channel to communicate with their customers via WhatsApp to send and receive messages. Similarly, you can integrate with other messaging apps based on your business requirements.

Prerequisites to setup Sunshine conversation channel​

  • Get access to the Sunshine dashboard.
  • Get access to the Zendesk admin or agent portal.
  • Contact the Zendesk Support team to integrate the Sunshine account with the Zendesk account.
  • Create a Facebook account and page for integration with Sunshine Conversations. You can connect to any channel under Sunshine integrations. For example, Facebook is connected.

Create a Sunshine conversation app​

To configure Sunshine Conversation on the Yellow.ai platform, you need to create a new Sunshine Conversation app.

To create an app, follow these steps:

  1. Log in to https://app.smooch.io/ with your credentials.

  2. Click Create new Sunshine Conversations app.

  3. Enter the name of your app and click Create App.

  4. Click Connect channels to connect a channel to your app.

  5. You can select your preferred channels from the available list to integrate with Sunshine Conversations.

  6. Once you have authorized Sunshine Conversations to your Facebook account, select the page you have created and Click Connect Facebook page.


  7. Navigate to the Settings tab and copy the App ID and API keys secret, which are required for configuring Switchboard.

Connect your messaging channels to Zendesk web messenger​

The Sunshine web messenger app allows you to connect the messaging channels to interact with your users from your web page.

To connect your messaging channels to the Zendesk web messenger, follow these steps:

  1. Enter the name of this integration so that you can easily find it in your Sunshine Conversations app.

  2. Choose your preferred method script or NPM to include the Sunshine Conversations plugin on your web page.

    drawing

  3. Add the Sunshine Conversations plugin to your web page. Add the following code at the end of the <head> section on your page:

<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","62274004515b2600ef7b3a07","5");
</script>
  1. Initialize Sunshine Conversations with your Integration ID. Once Sunshine Conversations has been added to your webpage, you need to initialize the Web Messenger using the below code snippet:
<script>
Smooch.init({ integrationId: '62274004515b2600ef7b3a07' });
</script>
note
  • You need to place the above code snippet at the end of the <body> section for better performance.
  1. Verify that your integration is successfully working as intended.

Configure Switchboard on Zendesk admin portal​

You need to configure Switchboard to handle the conversation between Zendesk and your bot. The switchboard enables you to programmatically route a user’s conversation through third party systems such as bot frameworks and helpdesk systems. For more information on how to configure Switchboard, click here.

Connect Sunshine conversation channel to your bot​

To connect Sunshine conversations to your bot on the platform, follow these steps:

  1. Log on to https://cloud.yellow.ai and navigate to Overview > Channels > Additional > Sunshine Conversations > click Connect.

  2. Click Connect to Sunshine Conversation.

  3. Enter your Zendesk subdomain ID that you received while creating a Zendesk account and click Sign in.

    drawing

  4. Click Allow to access your Zendesk account.

    drawing

  5. Your Sunshine Conversations channel will be successfully connected. You need to follow the below highlighted instructions to connect Yellow.ai on Zendesk Admin Centre.

    drawing

  6. Navigate to the Overview page, under the Active channels section, you can see that the Sunshine Conversations channel is successfully connected to your bot.

Connect Yellow.ai on Zendesk Admin Centre​

To connect Yellow.ai on Zendesk Admin Centre, follow these steps:

  1. After connecting your bot to Sunshine Conversations, navigate to the Zendesk dashboard and click Settings.

  2. Click Go to Admin Center.

  3. Select Channels > Bots > Manage bots.

  4. Under Marketplace bots, the Yellow bot will be displayed, click Connect.

Test your bot on Sunshine conversation​

After connecting your bot to the Sunshine conversation, you can test your bot.

Prerequisite​

  • Ensure that you have created the bot with intents and configured the flows with the same intent. For more information, click here.

To test your bot on the Sunshine conversations, follow these steps:

  1. Go to the Facebook page that you have created and trigger the flow that you have created to test the bot.

  2. If a flow is configured for agent reply using the raise ticket node to create a conversation with a Zendesk agent, then the agent will accept the invite. Once a conversation is initiated, the user can talk to the agent from the Zendesk workspace. When the conversation between the agent and user ends, the bot takes the conversation forward with the user.

  3. The agent will respond to your queries.