Clipboard problem with screen pop inside desktop (WebexCC)

[gabriel-gossa]

Hello Webex Community,

I'm currently integrating a web application into Webex via a screen pop within the desktop interface, which functions as an iframe. My web app allows agents to copy a generated text in order to paste it as an answer for email. I've encountered an issue where the "copy" functionality within this screen pop is blocked, resulting in the following error:

NotAllowedError: Failed to execute 'writeText' on 'Clipboard': The Clipboard API has been blocked because of a permissions policy applied to the current document.

I also came across this post (https://community.cisco.com/t5/webex-for-developers/wxcc-desktop-iframe-js-copy-to-clipboard-failing/td-p/4822839) and tried implementing the same parameters in the screen pop part of the desktop layout without sucess. Is there any way to fix this ? 

[gkovanis]

Hello @steinbrunnerj / @gabriel-gossa , thanks for bringing this to our attention.

Today, the allowedParams for Screen Pop are hard-coded, so even using desktop layout wouldn't include the 'clipboard-write; clipboard-read;' needed to achieve what you mention.

We are actively working on a fix for this to be able to include these parameters, will keep you posted on this thread when it will be possible to overcome this issue.

[iLoveBGP]

The clipboard issue in your Webex desktop integration occurs because the Clipboard API is blocked due to a permissions policy applied within the iframe. This is a common restriction in modern browsers to prevent unauthorized clipboard access. To resolve this, you need to ensure that your web application explicitly declares permissions for clipboard access and that these permissions are supported in the Webex environment.

First, confirm that the allow="clipboard-write" attribute is included in the iframe's configuration within the Webex desktop layout. This attribute explicitly grants the iframe permission to write to the clipboard. Additionally, ensure that your web app runs over HTTPS, as clipboard access is restricted to secure origins.

If the issue persists, verify with Webex support or documentation whether specific security policies are enforced within the Webex desktop client that override iframe permissions. You may also explore alternatives like using Webex APIs to directly handle data transfer between the app and the desktop interface, bypassing clipboard dependency. If none of these solutions resolve the issue, consult Cisco TAC for further guidance on compatibility and permissions adjustments.

[sandiban]

Hi @gabriel-gossa,
Have you checked this sample here - https://github.com/CiscoDevNet/webex-contact-center-widget-starter/blob/master/Iframe_Widget_Allowedparams.json where you can find SCREEN POP option as well.
If this doesn't help either, kindly raise a support case to us by sending the details to wxccdevsupport@webex.com and we can check it further.

Regards!
Sandip

[gabriel-gossa]

Hi @sandiban ,

Thank you for the reference! I’ve reviewed the sample you shared from the GitHub repository, but I might still be missing something.

To clarify, I’m working on configuring the screen pop for my dynamic web app. Here’s what I’ve done so far:

• I’ve used the SCREEN_POP_TAB and SCREEN_POP and tried adding the parameters there to make it work.
• The configuration works perfectly when I use the iframe (with a static page of my web app but I need it to be dynamic as I don't want to always display the same thing. That's why I need to use the screen pop for my page to appear if it is called in the flow), but it doesn’t seem to function in the screen pop tab, even though the API call and web app are valid.

Here’s a snippet of my desktop layout for context :

{
  "comp": "slot",
  "attributes": {
    "name": "SCREEN_POP_TAB",
    "allowedParams": "clipboard-read; clipboard-write self https://dialonce.inspear.org/"
  }
},
"visibility": "SCREEN_POP"
},
{
  "comp": "md-tab-panel",
  "attributes": {
    "slot": "panel",
    "class": "widget-pane"
  },
  "children": [
    {
      "comp": "slot",
      "attributes": {
        "name": "SCREEN_POP",
        "allowedParams": "clipboard-read; clipboard-write self https://dialonce.inspear.org/"
      }
    }
  ],
  "visibility": "SCREEN_POP"
},
{
  "comp": "md-tab",
  "textContent": "Iframe Widget",
  "attributes": {
    "slot": "tab"
  }
},
{
  "comp": "md-tab-panel",
  "attributes": {
    "slot": "panel"
  },
  "children": [
    {
      "comp": "agentx-wc-iframe",
      "attributes": {
        "src": "https://dialonce.inspear.org/index.php?id=f69e267ebfd863228d40c03887284882110767feffb6c381cf34a5aa6aa5e54a",
        "allowedParams": "clipboard-read; clipboard-write self https://dialonce.inspear.org/"
      },
      "wrapper": {
        "title": "Iframe",
        "maximizeAreaName": "app-maximize-area"
      }
    }
  ]
}

The screen pop doesn’t function as expected, and I suspect there might be a missing configuration I overlooked. Before raising a support case, I want to confirm whether I’ve correctly implemented the configuration.

Could you provide any additional insights on this setup?

Thanks again for your assistance!

Regards,

[steinbrunnerj]

Hi @gabriel-gossa,

I found your post today and I am facing exactly the same issue.

Have you found a way to activate the copy function in the screen pop section in the meantime?

Thanks,
Regards
Jörg

[gabriel-gossa]

Hi @steinbrunnerj, I am still stuck with this issue and trying to know if the problem comes from my configuration or webexCC itself. I'm still waiting for more information in order to raise a ticket if the issue does not come from my side. 

Regards, 
Gabriel