Web Messaging SDK: How to override launcher position and colors via API config?

NICE CXone API & Integrations
1

Hey everyone,

I’m trying to update our Web Messaging deployment to match our new WFM dashboard branding. Specifically, I need to move the launcher button to the top-left corner and change the primary button color to our corporate blue (#0056b3). I thought this could be handled via the deployment configuration API or the SDK initialization JSON, but I’m hitting a wall.

We’re using the standard Genesys Cloud Web Messaging SDK in a React app. I’ve been poking around the /api/v2/webmessaging/deployments/{deploymentId} endpoint, but the response payload doesn’t seem to have obvious fields for launcherPosition or buttonColor. I tried passing these values in the config object during initialization, assuming it would override the default deployment settings, but the launcher stays bottom-right and remains the default green.

Here’s the initialization snippet I’m using:

import { initialize } from '@genesys/web-messaging-sdk';

const config = {
 deploymentId: 'my-deployment-id-123',
 orgId: 'my-org-id',
 launcherPosition: 'top-left',
 buttonColor: '#0056b3',
 theme: {
 primaryColor: '#0056b3'
 }
};

initialize(config);

I’ve also tried updating the deployment via a PATCH request to the REST API:

curl -X PATCH "https://api.mypurecloud.com/api/v2/webmessaging/deployments/my-deployment-id-123" \
 -H "Content-Type: application/json" \
 -d '{
 "launcherPosition": "top-left",
 "buttonColor": "#0056b3"
 }'

This returns a 200 OK, but the changes don’t reflect in the UI. I’m wondering if I’m missing a specific property name or if these settings are locked to the deployment template in the Genesys Cloud admin console.

Environment details:

  • Genesys Cloud Web Messaging SDK v2.1.0
  • React 18
  • Chrome 114
  • US/Central timezone

Any pointers on the correct JSON structure for the API or the SDK config would be appreciated. I’m stuck.