Embedded Service Deployment | Salesforce Trailblazer Community

MIAW / Enhanced Chat fails to load in French (Blank Screen) when browser language is ⁠fr⁠

Hi everyone,

We are experiencing a critical issue with our Messaging for In-App and Web (MIAW) / Embedded Service Deployment failing to load specifically when the user's browser language is set to French (⁠fr⁠ / ⁠fr-CA⁠).

Everything functions perfectly when tested in English browser (both English and French User). However, when switching the browser language to French, the chat window fails to mount the pre-chat form, leading to a blank screen with no specific error in console both for English and French User.

Native Setup Test Window Reproduction: This issue reproduces out-of-the-box inside the native Salesforce Setup Test Window when the browser language is changed to French. This confirms the defect is independent of our custom Visualforce page or custom code.

Configurations Already Verified & Implemented:

1. Embedded Service Deployment Settings: French (⁠fr⁠ / ⁠fr-CA⁠) is explicitly added, active, and published under the deployment settings.

2. Experience Cloud / Site Languages: French is enabled and active under Digital Experience Site Settings, and the site has been fully Published.

3. Custom Labels & Translation Workbench: All standard and custom pre-chat form field labels, button text, and instructions have active, fully mapped French translations saved.

4. Code Snippet Locale Mapping: Dynamic language mapping (⁠embeddedservice_bootstrap.settings.language = userLang;⁠) and ⁠useHostSiteLanguage = true⁠ have been verified.

5. Testing Variations: We have tested toggling pre-chat forms on/off and forcing deployment republishes without resolution.

Has anyone encountered this specific CDN package / localized component initialization crash for non-English locales in Enhanced Chat? Any insights on backend CDN bundle compilation or missing metadata flags for ⁠fr⁠ locales would be greatly appreciated!

Thanks in advance for your help!

#Embedded Service Deployment

1 answer

Lilton Gover (Techbridge Solutions)
Oct 29, 6:49 PM
Hi Seema, since it also fails in the Salesforce test window, I'd lean toward a Salesforce-side issue rather than your code. Have you tried testing fr-FR and fr-CA separately? I'd also open a Salesforce Support case with the deployment ID and browser details. You've already ruled out most of the usual configuration issues.

Aug 29, 5:50 AM

Embedded service deployment - Deployment from one org to other

Hello Folks,

I have created whole chat application using embedded service deployment in Salesforce. My chat window will be in salesforce only to another app user. My application is working perfect in my dev org. While deployment from Dev to QA - I am totally stuck, getting

site.com

issue everywhere. I couldn't deploy embedded service deployment from one org to other - I tried with Git, workbench and Changeset everywhere it's failing with site is not found or can not be created error. Is there anyone who faced the same and able to solve?

Thanks,

Seema.

#Embedded Service Deployment #Embedded Service

1 answer

Himanshu Shekhar (AQBEE Innovations Pvt. Ltd.)
Aug 31, 2:40 PM
Hi Seema, this is expected. An Embedded Service Deployment always points to a Site endpoint, and Sites (Force.com
or Experience) do not migrate through change sets or the Metadata API, so in QA the deployment references a Site that does not exist, hence site not found or cannot be created.

Fix, in order:
1. In QA, create and ACTIVATE the Site first (Setup, Sites, or the Experience site if Dev uses one) so QA has its own site domain.
2. Re-add your CSP Trusted Sites and CORS allowlist entries for the host page domain, or the widget loads but stays blocked.
3. Then deploy the Embedded Service Deployment plus its supporting metadata (chat or messaging config, flows, fields) pointing at that QA Site.
4. Do not reuse the Dev code snippet on the page, it hard-codes Dev org URLs. Copy the fresh snippet Salesforce generates for the QA deployment.

The Site is org-specific, so it can never come across in the change set itself. You build and activate it in the target org first, then layer the deployment on top.

If this helps, please mark it as the Best Answer so it helps the next person, thanks 🙂

Aug 19, 12:05 PM

Customising an Agent Chat Window

Hi Everyone :)

Is there a way to add a fixed 'banner' to an embedded service deployment so that there's a constant disclaimer on the chat? Similar to the 'Powered by Agentforce' but customised text?

#Agentforce #Embedded Service Deployment #LWC #Trailhead #Help

2 answers

Kundan Kumar Jha (Infosys Limited)
Aug 19, 4:58 PM
Hey Megan,

Adding one thing to Himanshu's answer since it's mostly right but slightly understates option 2: Salesforce actually has a fully supported LWC-based header customization for Messaging (lightningSnapin__MessagingHeader target), you extend the base chat header component and can add whatever fixed text/markup you want inside it. This is documented and stays visible for the whole conversation, unlike the greeting-message approach, which scrolls away.

So realistically you have two solid, supported paths:
1. Custom LWC header (extends BaseChatHeader/MessagingHeader), gives you a persistent banner area inside the actual chat window that Salesforce won't overwrite on releases, since it's a supported customization point, not DOM hacking
2. A banner on your host page around the widget (Himanshu's option 1), simplest if the disclaimer doesn't need to be inside the chat window itself

Both are supported. The custom header route is probably closer to what you're picturing since it sits inside the widget alongside "Powered by Agentforce," not just around it.

Reference:
https://developer.salesforce.com/docs/service/messaging-web/guide/customize-header.html

Dec 29, 2020, 10:22 PM

Hello Trailblazers,

Please upvote my latest Service Cloud Idea;

Add Email as a Channel Menu Option

https://trailblazer.salesforce.com/ideaView?id=0874V000000ciUuQAI

Thanks, Tom

2 comments

Tom Bassett (Vera Solutions) Forum Ambassador
Jan 4, 2021, 9:05 AM
Thanks for this suggestion, this is a neat workaround for now until Email is added as it's own option :)

Dec 29, 2020, 10:23 PM

Hello Trailblazers,

Please upvote my latest Service Cloud Idea;

Add Email as a Channel Menu Option

https://trailblazer.salesforce.com/ideaView?id=0874V000000ciUuQAI

Thanks, Tom

Dec 29, 2020, 10:23 PM

Hello Trailblazers,

Please upvote my latest Service Cloud Idea;

Add Email as a Channel Menu Option

https://trailblazer.salesforce.com/ideaView?id=0874V000000ciUuQAI

Thanks, Tom

Mar 12, 2020, 4:39 PM

Hi Trailblazers! I have a question about Embedded Service Code Snippets. If someone is using different website pages, rather than different subdomains, for brands (i.e. example.com/brandA rather than brandA.example.com), is it possible to have an embedded chat window that is different for each brand and for the chat window to stay visible as the website visitor navigates sub-pages for the brand. Thanks in advance!

Dec 20, 2019, 2:54 PM

Hi,

I am having issues with adding the webchat to our website. I configured the chat colors to be orange and grey and they works fine during the chat session. The problem is before the chat session the button is black and the icon is missing and just shows a box. you can view it on the website.

https://bacasystems.com/support-test/

Any help is appreciated.

prechat.PNG

1 comment

Hao Dong (Salesforce)
Jan 8, 2020, 6:34 PM
take a look at this help article here https://help.salesforce.com/articleView?id=snapins_chat_branding.htm&type=5
Make sure to update the brand secondary color

Oct 31, 2019, 7:44 AM

Hi All and Anyone who can help :-) We are due to go live with our site later today and I have an issue with the web chat styling and screens changing and case automation disappearing with the installation of custom chat buttons. I had some assistance from Salesforce support with the web chat set up and it working. They said to follow the documentation steps for the custom chat buttons which we did and then after deploying the code the custom chat buttons, the pop up chat screen, pre-chat form and styling from the Embedded Service Deployment were replaced with a rudimentary chrome chat pop up and no pre-chat as previously configured. Cases no longer autogenerate and a chat transcript window replaces the other case/chat configuration. We don't know why this happened but need URGENT assistance here.

We can delete the code and go back to the standard included buttons with embedded chat but we don't understand why this happened and why we can't connect it to our custom chat button.

These are the steps we followed:

1. Followed Salesforce Documentation Instructions to install Custom Chat Buttons.

2. Added Chat Button Code to Staging Site Pages.

3. Added Chat Deployment Code (Javascript) to Staging Site Pages - this finally changed the button but then replaced the other components.

There were no error message just complete change. Documentation reads as though embedded chat is an extension of Live Agent. Are they two different things?

Thanks for anything you can offer.

Emma

1 comment

Beth Bornstein (Privia Health)
Oct 31, 2019, 7:48 PM
I'd bet it was the prechat...that has the code for all the automations, such as creating a case, record type, etc. I don't have much timwe to dive deeper on this, but at a glance, that is what I'd start with for troubleshooting.

#Embedded Service Deployment2 discussing

Salesforce Featured Topic

Related Learning