Salesforce Messaging

Overview

Ada’s integration with Salesforce Messaging connects your Ada bot to Salesforce Service Cloud Messaging, enabling handoffs from automated conversations to Salesforce agents.

Unlike Salesforce Chat (Live Agent), Salesforce Messaging (MIAW) is a persistent, asynchronous channel that supports richer web and in-app experiences.

Before you begin

Ada requirements

• An Ada bot with an active messaging channel.

Salesforce requirements

• Salesforce Service Cloud
• Salesforce Messaging for In-App and Web
• Digital Engagement licenses (required for Partner Messaging)
  • Salesforce Messaging is available in Enterprise, Unlimited, and Developer editions with the Digital Engagement add-on license.

Installation steps

The Ada side of the integration will be configured by the Ada team. Before meeting with your Ada team to install and test the handoff, please confirm you have Messaging enabled and Omni-channel routing configured. For the Salesforce side, you will be able to download the managed package from the URL listed in the steps below.

From the Salesforce side, you will need to have Messaging enabled. These steps may already be complete in your instance.

• Give users access to Messaging for In-App and Web

• Set up Omni Channel. Make sure to set Enhanced Omni-Channel Routing toggle to on.

• Add Omni Channel Routing. Under Routing Settings > Routing Model, select the least active model.

• Create Queue for your Route

  • Make sure to add the Messaging Session Object to your Queue

• Create an Omni-Channel Flow

• Add a Messaging Channel. Set it to Messaging for In-App and Web Channel and under Omni-Channel Routing select Omni-Flow and select your Omni-Channel Flow.

• Add Messaging to your Service Console

• Add https://*.ada.support to your CORS Allow List and Trusted URLs. Within the Trusted URL configuration, ensure the connect-src (scripts) CSP directive is selected.

  

• (Optional) Configure hidden Pre-Chat Fields to pass information from the bot to your Messaging record. See Detailed Instructions here.

These steps are necessary for Ada’s handoff integration:

• Configure a Custom Client Deployment.

• If you are setting up pre-chat fields, make sure that you select the visible and hidden fields you would like to pass. Also make sure that Activate the pre-chat feature is selected and Pre-Chat Display Frequency is set to Every Session. Once you have set these up make sure to save them and then publish your embedded service deployment.

  

• Make sure that you activate and publish the deployment. Make sure to send the Ada team the information found under Code Snippet.

  

• Your Custom Client Code Snippet will be as follows:

  

Final steps

1. Activate and publish the deployment.

2. Send your Ada team the following information found under the Code Snippet section:

   1
   {
   2
     "OrganizationId": "00XO#00000#XoXX",
   3
     "DeveloperName": "AdaChatbot",
   4
     "Url": "https://{{subdomain}}.my.salesforce-scrt.com"
   5
   }

   You will need to provide:

   • Salesforce Organization ID
   • Embedded Service Deployment Developer Name
   • Salesforce Instance Login URL

Your Ada team will use this information to finalize the setup and enable the integration.