Building a bot handler in Node.js using the @genesyscloud/web-messaging-guest-sdk. The goal is to send a structured message with quick replies, then parse the user’s selection on the backend. The UI renders the cards and buttons correctly. When the user clicks a quick reply, the client sends a message to the conversation.
The issue is the payload structure. I’m expecting the actions array in the message body to contain the quickReply action with the selected text. Instead, the actions array is empty or missing entirely. The text field just contains the raw string from the button.
Here is the payload I’m sending via the SDK:
const message = new WebMessagingMessage({
to: [{ id: conversationId }],
content: {
type: 'application/vnd.genesys.webmessaging.message+json',
body: {
text: 'Select an option',
actions: [
{
type: 'quickReply',
title: 'Check Status',
value: 'status_check'
},
{
type: 'quickReply',
title: 'Talk to Agent',
value: 'agent_transfer'
}
]
}
}
});
await webMessagingGuestApi.postMessages(message);
When the user clicks “Check Status”, I subscribe to the onMessage event. The incoming message looks like this:
{
"from": { "id": "user-uuid" },
"content": {
"type": "text/plain",
"body": "Check Status"
}
}
No actions field. No quickReply object. Just plain text. I’ve checked the Open Messaging API docs, and it seems like the client should wrap the selection in an action object. Is this a known limitation of the Guest SDK? Or am I missing a config flag to enable structured event parsing? The standard webchat client handles this fine, but the Guest SDK feels stripped down here. Any pointers on how to extract the value field instead of the title?