---
schema_version: "1"
id: 4d59c7c3607f5c441412c6cc1bb1ddebe31f9fe2bdcc839bffeb48a2a5698338
title: Troubleshoot Enhanced Chat Setup
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/miaw_troubleshoot.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.miaw_troubleshoot.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: b9b95cafb1a352db2a3c7cd425115cb9b14648d6d3f945fb2834dd3f51f03f0a
description: Respond to error messages you may encounter while setting up Enhanced Chat.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Troubleshoot Enhanced Chat Setup

Respond to error messages you may encounter while setting up Enhanced Chat.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.messaging_editions.htm&amp;type=5&amp;language=en_US" target="_blank">View supported editions.</a></td>

        </tr>
        <tr class="">
          <td class="slds-cell-wrap" style="vertical-align:top;">
            <a name="miaw_troubleshoot__d603e335"><!-- --></a><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" id="miaw_troubleshoot__d603e335" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/checkmark.png" alt="Checkmark"></span>
            <strong>This article applies to:</strong>
          </td>

          <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced In-App Chat and Enhanced Web Chat channels</td>

        </tr>
        <tr class="">
          <td class="slds-cell-wrap" style="vertical-align:top;">
            <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/crossmark.png" alt="X icon"></span>
            <strong>This article doesn’t apply to:</strong>
          </td>

          <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced WhatsApp, Enhanced Facebook Messenger, Standard and Enhanced SMS,
            Enhanced Apple Messages for Business, Enhanced LINE, and Bring Your Own
            Channel</td>

        </tr>
      </tbody>
    </table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d119403e95">Error Message</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d119403e98">Solution</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Error Message" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e95 ">
              <pre class="line-numbers slds-box slds-box_x-small slds-theme_shade slds-m-top_medium slds-m-bottom_medium slds-scrollable_x"><code>Refused to frame ‘&lt;your 
ESW_[deploymentname] site&gt;’ because an ancestor 
violates the following content security policy 
directive: “frame ancestors &lt;your old domain&gt; 
&lt;your old subdomain&gt;”</code></pre>
            </td>

            <td data-label="Solution" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e98 ">
              <p>Change or add the domain that’s associated with your embedded service deployment. </p>
              <ul>
                <li>Go to <span class="menucascade"><strong class="uicontrol">Setup</strong> | <strong class="uicontrol">User Interface</strong> | <strong class="uicontrol">Sites and Domains</strong> | <strong class="uicontrol">Sites</strong></span>.</li>
                <li>Select your site from the Site Label column. Your site is formatted as
                  &lt;ESW_[deploymentname]_[numbers]&gt;.</li>
              </ul>
              <ul>
                <li>Under Trusted Domains for Inline Frames, find the domain or subdomain that
                  you’d like to change, and click <strong class="uicontrol">Edit</strong>.</li>
              </ul>
              <ul>
                <li>Save your changes.</li>
              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Error Message" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e95 ">
              <pre class="line-numbers slds-box slds-box_x-small slds-theme_shade slds-m-top_medium slds-m-bottom_medium slds-scrollable_x"><code> Access to XMLHttpRequest at 
'&lt;your ESW_[deploymentname]_[numbers] site&gt;' from 
directive: '&lt;your domain&gt;' has been blocked by CORS 
policy: No 'Access-Control-Allow-Origin' header is 
present on the requested resource.</code></pre>
            </td>

            <td data-label="Solution" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e98 ">
              <p>Add your new domain to the CORS allowlist.</p>
              <ul>
                <li>From Setup, enter CORS in the Quick Find box, and then select
                  <strong class="uicontrol">CORS</strong>.
                </li>
                <li>Select <strong class="uicontrol">New</strong>.</li>
              </ul>
              <ul>
                <li>Enter an origin URL pattern.</li>
              </ul>
              <ul>
                <li>Save your work.</li>
              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Error Message" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e95 ">
              <pre class="line-numbers slds-box slds-box_x-small slds-theme_shade slds-m-top_medium slds-m-bottom_medium slds-scrollable_x"><code>Refused to load the script 
'&lt;your ESW_[deploymentname]_[numbers]&gt;/assets/js/
bootstrap.min.js' because it violates the 
following Content Security Policy directive: 
"scrtipt-src 'self ''unsafe-eval 'unsafe-inline'...". 
Note that 'script-src-elem' was not explicitly set, 
so 'script-src' is used as a fallback.</code></pre>
            </td>

            <td data-label="Solution" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e98 ">
              <p>Add the ESW site as a trusted site within the Builder:</p>
              <ul>
                <li>Go to <span class="menucascade"><strong class="uicontrol">Setup</strong> | <strong class="uicontrol">Digital Experiences</strong> | <strong class="uicontrol">All Sites</strong></span>.</li>
                <li>Click <strong class="uicontrol">Builder</strong> next to your experience cloud site.</li>
              </ul>
              <ul>
                <li>Under Settings, click <strong class="uicontrol">Security &amp; Privacy</strong>, and go to
                  the Content Security Policy (CSP) section.</li>
              </ul>
              <ul>
                <li>Set Security level to <strong class="uicontrol">Relaxed CSP: Permit Access to Inline Scripts
                    and Allowed Hosts</strong>.</li>
              </ul>
              <ul>
                <li>Click <strong class="uicontrol">Add Trusted Site</strong> to add the CSP trusted site
                  details.</li>
              </ul>
              <ul>
                <li>Enter the name and URL of your esw site.</li>
              </ul>
              <ul>
                <li>Activate the site and click <strong class="uicontrol">Add Site</strong>.</li>
              </ul>
              <ul>
                <li>Publish the site.</li>
              </ul>
              <p>Add the ESW site as a Trusted URL in Setup:</p>
              <ul>
                <li>Go to <span class="menucascade"><strong class="uicontrol">Setup</strong> | <strong class="uicontrol">Security</strong> | <strong class="uicontrol">Trusted URLs</strong></span>.</li>
                <li>Click <strong class="uicontrol">New Trusted URL</strong>.</li>
                <li>Fill out the API Name and URL fields.</li>
              </ul>
              <ul>
                <li>In the CSP Context field, select <strong class="uicontrol">Experience Builder
                    Sites</strong>.</li>
                <li>Under CSP Directives, select <strong class="uicontrol">frame-src (iframe content)</strong>
                  and <strong class="uicontrol">style-src (stylesheets)</strong>.</li>
              </ul>
              <ul>
                <li>Save your changes.</li>
              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Error Message" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e95 ">Placeholder icon appears instead of external image when using enhanced
              links.</td>

            <td data-label="Solution" class="slds-cell-wrap" style="vertical-align:top;" headers="d119403e98 ">
              <p>If you are using a third-party site to host your image, the site domain must
                be added as a Trusted URL: </p>
              <ul>
                <li>Go to <span class="menucascade"><strong class="uicontrol">Setup</strong> | <strong class="uicontrol">| Security</strong> | <strong class="uicontrol">| Trusted URLs</strong></span>.</li>

                <li>Click <strong class="uicontrol">New Trusted URL</strong>. </li>

                <li>Fill out the API Name and URL fields.</li>

                <li>In the CSP Context field, select <strong class="uicontrol">All</strong>.</li>

                <li>Under CSP Directives, select <strong class="uicontrol">img-src (images)</strong>.</li>

                <li>Save your changes.</li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>