## 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](https://docs.yellow.ai/docs/platform_concepts/channelConfiguration/facebook-messenger#connect-your-facebook-messenger-account) and page for integration with Sunshine Conversations. You can connect any channel under Sunshine integrations. For example, Facebook is connected.
:::note
## 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 app, 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.
<img src="https://i.imgur.com/zanN1QL.png)" alt="drawing" width="60%"/>
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>
```
4. 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.
:::
5. 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](https://docs.smooch.io/rest/#tag/Switchboard-Integrations).
## 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**.
<img src="https://i.imgur.com/x4Yidtp.png)" alt="drawing" width="60%"/>
4. Click **Allow** to access your Zendesk account.
<img src="https://i.imgur.com/RkJ5lRh.png)" alt="drawing" width="60%"/>
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.
<img src="https://i.imgur.com/SMllyqd.png)" alt="drawing" width="60%"/>
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](https://docs.yellow.ai/docs/platform_concepts/Getting%20Started/create-a-bot).
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](https://docs.yellow.ai/docs/platform_concepts/studio/build/nodes/action-nodes#17-raise-ticket) node, then the agent will accept the invite.
3. The agent will respond to your queries.
Sign in with Wallet
Connect another wallet