如何在点击Adaptive Card的Action.Submit按钮时显示自定义用户消息

数据老陈

2026-8-15

解决方案

1. 调整Action.Submit的data结构

使用messageBack类型时，要同时设置text和displayText字段（部分渠道依赖text来显示用户侧消息），并将业务标识放在value对象中：

"actions": [
    {
        "type": "Action.Submit",
        "title": "Tell me more",
        "data": {
            "type": "messageBack",
            "text": "Ok, tell me more please!",
            "displayText": "Ok, tell me more please!",
            "value": {
                "choice": "TELL_ME_MORE"
            }
        }
    }
]

text/displayText：控制用户侧聊天窗口显示的消息文本
value：传递给Bot的业务逻辑标识（比如TELL_ME_MORE）

2. 在Bot代码中解析提交数据

在TypeScript的Turn处理逻辑里，从activity.value中提取value字段的业务标识，而非直接使用text内容：

async onTurn(context: TurnContext) {
    if (context.activity.type === ActivityTypes.Message) {
        // 处理Adaptive Card提交的数据
        if (context.activity.value) {
            const submitPayload = context.activity.value as {
                type?: string,
                value?: { choice: string }
            };

            if (submitPayload.type === 'messageBack' && submitPayload.value?.choice === 'TELL_ME_MORE') {
                // 执行对应的业务逻辑
                await context.sendActivity("Here's the additional information you asked for.");
            }
        }
    }
}