Digital Experience Site中Messaging for web组件不可见求助

针对你在Scratch Org中遇到的「Unable to load Embedded Messaging configuration」报错，结合Scratch Org的特性，以下是容易遗漏的配置项：

• Scratch Org功能启用验证
  确认你的scratch-def.json中已包含必要的功能标记：

  {
    "features": ["EmbeddedService", "DigitalExperience"],
    "orgPreferences": {
      "enabled": ["EmbeddedServiceEnabled"]
    }
  }
  

  若之前创建Scratch Org时未添加这些配置，需重新创建Org并包含上述参数。

• Embedded Messaging的允许域名配置
  除了CORS和可信站点，必须在Embedded Messaging配置的「Allowed Domains」中添加Digital Experience站点的完整域名（包含https://前缀，例如https://your-site-domain.force.com/your-site-path）。注意Scratch Org的临时域名可能带有-dev-ed后缀，需准确复制。

• 站点用户Profile权限
  检查Digital Experience站点对应的用户Profile（如Guest User Profile）：

  • 启用「Access Embedded Service」权限
  • 授予「Messaging Session」对象的读权限
  • 若使用队列路由，确保Profile拥有访问目标队列的权限（可通过队列的共享规则或Profile的对象权限配置）

• 路由队列/流程的有效性验证

  • 确认目标队列已启用，且队列成员包含至少一个活跃的服务人员（Scratch Org中需确保该用户有Service Cloud许可证并启用Messaging权限）
  • 若使用流程路由，确认流程已激活，且触发条件与Embedded Messaging的场景匹配（例如流程的启动对象为Messaging Session，且无冲突的过滤条件）

• VF页面的脚本引用正确性
  若尝试VF页面加载组件，确保：

  • 脚本的src路径正确引用了你的Embedded Messaging部署ID，格式为：

    <script src="https://your-org-domain.my.salesforce.com/embeddedservice/5.0/esw.min.js" data-deployment-id="YOUR_DEPLOYMENT_ID"></script>
    

  • VF页面的apex:page标签中添加了applyHtmlTag="true"和showHeader="false"，避免样式冲突
  • 站点用户的Profile拥有访问该VF页面的权限

内容的提问来源于stack exchange，提问作者Shraddha Jain