Create a Bring Your Own Channel for Messaging Channel

Install a Managed Package

Install the managed package for your Bring Your Own Channel for Messaging provider.

Tip To learn how to create your own Messaging provider integration instead of installing a managed package from AppExchange, see the Bring Your Own Channel for Messaging Developer Guide.

Create a Bring Your Own Channel for Messaging Channel

1. From Setup, enter Messaging Settings, and then select Messaging Settings.
2. Click New Channel.
3. Select the Conversation Channel Definition tile that represents the Managed Package that you installed previously, and click Next.
4. Give your Bring Your Own Channel for Messaging channel a name.
5. Click anywhere to populate the API Name field, and save your changes.
6. If required for your Messaging channel, turn on Event-Driven Settings. These options appear if your Messaging partner supports them in the Conversation Channel Definition. Usage counts towards your high volume platform event allocation. See Considerations and Limitations for Bring Your Own Channel and Bring Your Own Channel for CCaaS for more information.
   1. To show messaging end users an indicator when a rep is typing, select Show agent typing indicator.
   2. To send end users acknowledgments when their inbound messages are read or delivered, select Show messaging users read and delivered receipts.
   3. To show end users loading text and progress animations while an Agentforce Service agent is processing, select Show Agentforce agent progress indicator.
7. Set up routing for this Messaging channel.
   1. Under Omni-Channel Routing, click Edit.
   2. To route messages with an Omni-Channel flow, select Omni-Channel Flow in the Routing Type field, and then enter the names of the Omni-Channel flow and fallback queue that you created previously.
   3. To route messages to a queue, select Queue in the Routing Type field, and then enter the name of the Salesforce queue that you created previously.
8. Save your changes.
9. Click Activate.

Create and Configure an External Client App for OAuth Integration

Certain Messaging providers require you to set up and manage your own external client app (ECA) to provide authentication for the integration between their platform and the Salesforce Interaction Service API. Check with your provider whether setting up your own app is a required setup step for their integration. First create the ECA and then update the Conversation Channel Definition (CCD).

Tip

• To check whether your Messaging provider requires you to set up your own external client app, from Setup, go to Messaging Settings and select the Messaging channel you created. In the Conversation Channel Definition section, if you see Modify Conversation Channel Definition, you must create your own ECA. Otherwise, the partner provider manages the app for you.
• We recommend using an external client app for Interaction Service authentication instead of a connected app. Starting in Spring ’26, customers can’t create a connected app unless they request the ability to create connected apps from Salesforce Support. To migrate a preexisting connected app, see Create an External Client App from a Connected App.

1. Create an external client app and set Distribution State set to Local.
2. In the OAuth Settings area of the page, select Enable OAuth.
   The OAuth Settings area expands and the OAuth settings fields are visible.
3. Add a callback URL (endpoint), which is the same as the OAuth redirect URI. We recommend you use https://login.salesforce.com to start with.
4. Add the OAuth scopes Access Interaction API resources (interaction_api) and Perform Requests at any time (refresh_token, offline_access).
5. In the Flow Enablement section, select Enable JWT Bearer Flow.
6. Upload your self-signed certificate.
7. To create the ECA, click Create.
8. In your external client app’s Policies tab, click Edit.
9. Under OAuth policies, from the Permitted Users dropdown, select Admin approved users are pre-authorized. If you see a warning message, click OK.
10. Under App Policies, add the System Administrator profile.
11. Save your changes.
12. After setting up your ECA, update the Conversation Channel Definition for your Messaging channel to reference the app you created.
    1. From Setup, in the Quick Find box, enter Messaging Settings, and then select Messaging Settings.
    2. Select the Messaging channel you created.
    3. In the Conversation Channel Definition section, click Manage Conversation Channel Definition. If this button isn’t available, your CCaaS provider manages the ECA, and you don’t need to create one and associate it with the Conversation Channel Definition.
    4. Select the external client app that you created.
13. Save your changes.

Test Your Bring Your Own Channel for Messaging Channel

1. Open the Service Console app, and go to the Omni-Channel utility bar at the bottom of the console, provided it’s installed. Go online as the service rep assigned to the messaging button.
2. Open the app where your customers initiate Bring Your Own Channel for Messaging, and start a conversation.
3. In the console tab, verify that you received a conversation request. Accept the request and try sending a message.