Follow these steps to set it up successfully.

Step 1: Create the URL Language Field on Messaging Session

1. Navigate to Setup in Salesforce.
2. Search for and select Object Manager.
3. Find and click on the Messaging Session object.
4. Go to Fields & Relationships and click New.
5. Create a new custom field:
   • Field Type: Text
   • Field Label: URL Language
   • Field Name: URL_LANGUAGE (ensure it matches exactly for later steps)
   • Length: Set an appropriate length (e.g., 10 characters for language codes like "en_US").
6. Save the field and ensure it’s accessible to the necessary profiles.

Step 2: Configure Custom Parameters in Messaging Settings

1. Go to Setup and search for Messaging Settings.
2. Locate your Embedded Messaging channel and click Edit.
3. Scroll to the Custom Parameters section.
4. Add a new custom parameter:
   • Parameter Name: URL_LANGUAGE
   • Parameter Type: Select Text.
5. Map the parameter to the URL_LANGUAGE field on the Messaging Session object (see Image 1 below for reference).
6. Save your changes.
   
    

Image 1: Parameter Mappings Configuration

Step 3: Enable Pre-Chat in Embedded Service Deployment

1. Navigate to Setup and search for Embedded Service Deployments.
2. Select your deployment and click Edit.
3. In the Pre-Chat section, check the box labeled Activate the pre-chat feature.
4. Save your changes.

Step 4: Add Hidden Pre-Chat Field

1. In the same Embedded Service Deployment settings, scroll to Hidden Pre-Chat Fields.
2. Click Add or Edit to configure a hidden field.
3. Select the URL_LANGUAGE field from the list (see Image 2 below for reference).
4. Save your changes.

Image 2: Hidden Pre-Chat Fields Setup

Step 5: Re-Publish the Embedded Service Deployment

1. Return to the Embedded Service Deployments page.
2. Select your deployment and click Publish.
3. Confirm the re-publishing to ensure all changes take effect.

Step 6: Modify the Omni-Channel Flow

1. Go back to Messaging Settings and locate your messaging channel.
2. Find the associated Omni-Channel Flow and click to edit it (this is typically linked under the messaging setup).
3. Update the flow to ensure the URL_LANGUAGE field is captured and stored in the Messaging Session record (see Image 3 below for reference).
   • Example: Add an Assignment element to set the Messaging Session’s URL_LANGUAGE field based on the pre-chat input.
4. Save and activate the updated flow.

Image 3: Omni-Channel Flow Update

Step 7: Add JavaScript Code to Digital Experiences

1. Navigate to Digital Experiences > Builder.
2. Open the site where Embedded Messaging is deployed.
3. Go to Settings > Advanced.
4. Click Edit Head Markup.
5. Add the following JavaScript code to pass the URL_LANGUAGE value:

6. Save and publish the changes to your Digital Experience site.

Note: Replace "en_US" with the desired language code or dynamically populate it based on your site’s logic (e.g., using a variable).

Step 8: Test the Configuration

1. Visit your website where the Embedded Messaging chat button is deployed.
2. Click the Chat button to initiate a session.
3. In Salesforce, navigate to the Messaging Sessions tab and open the newly created session record.
4. Verify that the URL_LANGUAGE field is populated with the value "en_US" (or the value you specified).

Troubleshooting Tips

• Field Not Populating? Ensure the URL_LANGUAGE field name matches exactly across all configurations (case-sensitive).
• Chat Not Loading? Double-check that the Embedded Service Deployment is published and the JavaScript code is correctly added to the Head Markup.
• Flow Issues? Test the Omni-Channel Flow in a sandbox environment to confirm the field assignment works as expected.