Passing CRM ID to Genesys Cloud Web Messaging startChat()

Trying to inject our internal CRM customer ID into the Genesys Cloud Web Messaging session before the chat starts. We need this ID to appear in the conversation context so the WFM reports can tie back to specific accounts.

Here is the snippet we are using in the frontend:

const options = {
 participantAttributes: {
 crmId: 'CUST-12345'
 }
};

genesysCloudMessaging.startChat(options);

The chat connects fine, but when I pull the interaction details via the API (GET /api/v2/conversations/messaging/interactions/{id}), the participantAttributes object is empty. The SDK version is 2.14.0.

We verified the token is valid and has the right scopes. Is there a specific parameter name required for custom attributes in startChat, or do we need to call a separate API endpoint to patch the participant data after the session begins? The documentation is vague on the exact payload structure for the SDK method.

participantAttributes gets dropped before the API call hits the backend. You need to push that data into userAttributes or conversationAttributes instead, otherwise Genesys ignores it completely.

const options = {
 userAttributes: {
 crmId: 'CUST-12345'
 }
};