Skip to main content

Setup Messaging

Grant Required Permissions

  1. Log in as a System Administrator user. Go to Permission Sets, SCRT2 Integration User, Object Settings, and then SCC Events.
    1. Enable both Read and Create and choose Save.
  2. To grant agent access to the other Salesforce user for use in testing:
    1. Go to Users, Users and then select the SCCAC Agent.
    2. Select Permission Set Assignments, Edit Assignments, and then add Contact Center Agent (Partner Telephony) and Contact Center Bring Your Own Channel User if it’s not already added. It should appear under Enabled Permission Sets along with SCC Agent. Choose Save.
    3. Go to Feature Settings, Service, Voice, Partner Telephony Contact Centers and select the name of the contact center you created. Scroll down to the Contact Center Users section, choose Add, then choose the plus sign next to SCCAC Agent and choose Done. You will receive an email when the user is added to the contact center.
  3. (Optional, required for agent-to-agent transfer for chat) Grant the permission set license assignment and permission set to the user you want to use to initiate agent-to-agent transfers
    1. Go to Users > Users and select the SCCAC Agent user, or whichever user you want to use for initiating agent-to-agent transfer.
    2. Choose Permission Set License Assignments, choose Edit Assignments, check the box for Partner Messaging User and then choose Save.
    3. Choose Permission Set Assignments, choose Edit Assignments, choose Contact Center Bring Your Own Channel User in the left sidebar and choose the right arrow to move it to the right side, and then choose Save.
    4. Go to Users > Permission Sets and select SCC Agent. Choose System Permissions and Edit and grant the Customize Application permission.

Create Messaging Channel

  1. Go to Feature Settings, Service, Messaging, Messaging Settings, and then choose New Channel.
  2. Choose Start, scroll down and select the SCC messaging channel definition, and then choose Next.
    1. If you don’t see any options on this page, wait a few moments and then choose Back followed by Next again.
  3. Choose Use an existing contact center, select the contact center you created earlier in the dropdown, and then choose Next.
  4. Enter whatever name you like in the Channel name field, Select the API name field, and then choose Save.
  5. If the Connected App Name field of the Conversation Channel Definition section is blank, choose Modify Conversation Channel Definition. In the Connected App Name dropdown, select the name of the connected app (should be awsscc GLOBAL_CONNECTED_APP) and choose Save.
  6. Choose Activate on the upper-right of this page, to activate the channel, choose Active.
  7. Note down the Channel Address Identifier. You will need it for later steps.

Create Lightning App

  1. To create a new Lightning App with Console navigation style:
    1. Go to Apps, App Manager, and then choose New Lightning App.
    2. Enter whatever name you like, choose Next.
    3. Under Navigation Style, select Console navigation, and choose Next.
    4. Choose Add Utility Item and then Omni-Channel.
    5. Choose Add Utility Item, Amazon Connect for Salesforce, and check the Start automatically check box. Choose Next.
    6. Search for Messaging Sessions and Cases and choose them, then choose the right arrow to move them to the Selected Items column. Choose Next and Next again.
    7. Select System Administrator and Standard User or any profile you are using for agents/users and choose the right arrow button to add them to Selected Profiles.
    8. Choose Save and then Finish.
  2. Go to the SCC Agent and SCC Administrator permission sets you cloned and choose Assigned Apps. Hit Edit, and then find the Lightning app you created. Choose the right arrow to add it to the list of Enabled Apps.
  3. To switch to the Enhanced Conversation widget:
    1. From Apps, App Manager, find the row with your newly created Lightning app, choose the down arrow in the rightmost column, and then Edit.
    2. Choose Pages on the top and then choose New Page.
    3. Select Record Page and then Next.
    4. Enter whatever name you like (such as EnhancedMessagingSession) in the Label field and select Messaging Session under Object, and then choose Next.
    5. Select Clone Salesforce Default Page and then choose Done.
    6. In the left nav, find Enhanced Conversation and drag it into the window, under the toolbar with Conversation and Details.
    7. The result should look like this: lightning-app
    8. Although it may look like this if you have no messaging session records yet: lightning-app
    9. On the upper right, choose Save and then Activate.
    10. Choose Assign as Org Default.
    11. Choose Next and then Save. Choose the left arrow on the upper left to return to Setup.

Configure Omni-Channel

  1. Go to Feature Settings, Service, Omni-Channel, and then Presence Statuses.
    1. Choose New.
    2. Enter Active (or any name you like) in the Status Name field.
    3. Make sure Online is selected in Status Options.
    4. Under Service Channels, choose Messaging, Phone and then choose the right arrow so it appears under Selected Channels and choose Save.
  2. Go to Users and then Permission Sets.
    1. Select SCC administrator and then Service Presence Statuses Access.
    2. Choose Edit, select the status you created in step a above, and choose the right arrow, and Add, so it appears under Enabled Service Presence Statuses, and then choose Save.
    3. Do the same for SCC Agent permission set.
  3. Go to Feature Settings, Service, Omni-Channel, and then Routing Configurations.
    1. Choose New.
    2. Type Routing (or any name you like) in the Routing Configuration Name field.
    3. Enter 1 for Routing Priority and choose External Routing as the Routing Model.
    4. Enter 1 for Units of Capacity and choose Save.
  4. Go to Feature Settings, Service, Omni-Channel, and then Presence Configurations.
    1. Choose Edit next to Default Presence Configuration.
    2. Enable Allow agents to decline work requests and choose Save.
  5. Go to Users and then Queues.
    1. Choose New.
    2. Type Queue (or any name you like) in the Label field.
    3. Under Configuration with Omni-Channel Routing, choose the magnifying glass icon next to the Routing Configuration field.
    4. In the popup window, choose the name in the Developer Name column of the routing configuration you created in the previous step.
    5. In Supported Objects, select Messaging Session under Available Objects, choose the right arrow and Add so it appears under Selected Objects.
    6. Under Queue Members, select your user, SCCAC Agent, SCC ApiAccessUser and any other user for agent and choose the right arrow and Add, so it appears under Selected Members. Then choose Save.
  6. Go to Feature Settings, Service, Voice, and then Partner Telephony Contact Centers.
    1. On this page select your contact center name and scroll down to the Queue Mapping section.
    2. Choose Add. For the Salesforce Queue, select the queue you just created, and for the Amazon Connect Queue select the SCC-BasicQueue, and then choose Save.
  7. Go to Feature Settings, Service, Messaging, and then Messaging Settings.
    1. Select the messaging channel under Channel Name.
    2. Under Omni-Channel Routing, set Routing Type as Omni-Queue, and under Queue, type the name of the queue you created. It should be suggested in the list that will appear; select it, and then choose Save.

Test Omni-Channel Setup

  1. At this point, if you’re still logged into the AWS console in this browsing context, sign out of the AWS console (and also your Amazon Connect instance, if you’re signed in as the emergency admin user). When you go active in Omni-Channel, Salesforce will use SAML to sign you into AWS and into Amazon Connect, using an IAM role they set up which only has access to Amazon Connect. If you need to do things as the root user in your AWS account, use an incognito window to sign into the AWS console.
  2. Log in as SCCAC Agent in Salesforce.
  3. Choose the App Launcher (9 dots in a 3x3 grid on the upper left) and choose View All, find the button for your newly created app, and drag it to the first position using the handle on the right side of the button. Choose it and you should see Amazon Connect for Salesforce and Omni-Channel on the bottom.
  4. Expand Omni and you should be able to choose the dropdown arrow and select your Active status.