Web Messaging SDK guest attributes not persisting to conversation

NICE CXone API & Integrations
1

Trying to push custom guest attributes to the Genesys Cloud Web Messaging widget for authenticated users. We’ve got a simple SPA setup using the @genesys/web-messaging-js-sdk. The widget loads fine, and the chat connects, but the custom attributes aren’t showing up in the Genesys admin UI or the conversation details API response.

Here’s the init code:

const widget = new WebMessaging({
 orgId: 'our-org-id',
 locale: 'en-US',
 guest: {
 name: 'John Doe',
 email: 'john@example.com',
 attributes: {
 userId: '12345',
 tier: 'gold'
 }
 }
});

widget.start();

The userId and tier fields are missing from the conversation object. I checked the network tab, and the WebSocket connection seems to send the initial payload correctly. Is there a specific mapping or configuration step in the admin UI that needs to be enabled for these attributes to flow through? The documentation mentions ‘guest attributes’ but doesn’t explicitly say if they need to be pre-defined in the conversation data schema. We’ve tried restarting the widget and clearing cache, no luck.

2

You’re missing the onGuestReady hook. The widget doesn’t accept attributes during initial construction.

widget.onGuestReady((guest) => {
 guest.update({ name: "John", email: "john@example.com" });
});