通过

使用 Bot Connector API 向消息添加建议的操作

  • 项目

建议的操作让机器人能够显示用户可以单击以提供输入的按钮。 建议的操作显示在编辑器附近，并且通过让用户轻点按钮即可回答问题或进行选择，而不必使用键盘输入响应，改善了用户体验。 与资讯卡中显示的按钮（即使在单击后仍然可见且可供用户访问）不同，建议的操作窗格中显示的按钮将在用户进行选择后消失。 这可以防止用户在对话中单击过时的按钮，并简化机器人开发。

发送建议的操作

若要向消息添加建议的操作，请设置 Activity 对象的 suggestedActions 属性，以指定表示要呈现给用户的按钮的 CardAction 对象列表。

以下请求向用户发送一条显示三个建议操作的消息。 在此示例请求中，https://smba.trafficmanager.net/teams 表示基本 URI；机器人发出的请求的基本 URI 可能不同。 有关设置基本 URI 的详细信息，请参阅 API 参考。

POST https://smba.trafficmanager.net/teams/v3/conversations/abcd1234/activities/5d5cdc723
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
    "type": "message",
    "from": {
        "id": "12345678",
        "name": "sender's name"
    },
    "conversation": {
        "id": "abcd1234",
        "name": "conversation's name"
   },
   "recipient": {
        "id": "1234abcd",
        "name": "recipient's name"
    },
    "text": "I have colors in mind, but need your help to choose the best one.",
    "inputHint": "expectingInput",
    "suggestedActions": {
        "actions": [
            {
                "type": "imBack",
                "title": "Blue",
                "value": "Blue"
            },
            {
                "type": "imBack",
                "title": "Red",
                "value": "Red"
            },
            {
                "type": "imBack",
                "title": "Green",
                "value": "Green"
            }
        ]
    },
    "replyToId": "5d5cdc723"
}

当用户单击其中一个建议的操作时，机器人将从用户收到包含相应操作的 value 的消息。

其他资源