发送仅特定人可见的消息卡片

用于机器人在群会话中发送仅指定用户可见的消息卡片。卡片上将展示"仅对你可见"标识。

使用场景

临时消息卡片多用于群聊中用户与机器人交互的中间态。例如在群聊中用户需要使用待办事项类bot创建一条提醒，bot 发送了可设置提醒日期和提醒内容的一张可交互的消息卡片，此卡片在没有设置为临时卡片的情况下为群内全员可见，即群内可看见该用户与 bot 交互的过程。而设置为临时卡片后，交互过程仅该用户可见，群内其他成员只会看到最终设置完成的提醒卡片。

通过临时消息卡片，可以减少消息对群聊中不相关用户的打扰，有效降低群消息的噪声。

需要启用机器人能力；需要机器人在会话群里。

仅触发临时卡片的用户自己可见。

不支持转发。

只能在群聊使用。

仅在用户处于在线状态的飞书客户端上可见。

临时消息卡片的呈现能力、交互能力与消息卡片一致。

错误码

具体可参考：服务端错误码说明

请求体demo

{
	 "open_id":"ou_515fbe9d04838174e2035f801453d07f",
	 "chat_id":"oc_286e0a771a76d99f1ec72737ef92ee8d",
     "msg_type": "interactive",
     "card": {
        "elements": [
            {
                "tag": "div",
                "text": {
                    "tag": "plain_text",
                    "content": "overflow & datePicker 功能"
                },
                "fields": [
                    {
                        "is_short": true,
                        "text": {
                            "tag": "lark_md",
                            "content": "**组件模块:**\noverflow & datePicker"
                        }
                    },
                    {
                        "is_short": false,
                        "text": {
                            "tag": "lark_md",
                            "content": "**功能点:**\n"
                        }
                    }
                ]
            },
            {
                "tag": "hr"
            },
            {
                "tag": "action",
                "actions": [
                    {
                        "tag": "overflow",
                        "confirm": {
                            "title": {
                                "tag": "plain_text",
                                "content": "请确认"
                            },
                            "text": {
                                "tag": "plain_text",
                                "content": "跳转方式"
                            }
                        },
                        "options": [
                            {
                                "text": {
                                    "tag": "plain_text",
                                    "content": "多端跳转"
                                },
                                "multi_url": {
                                    "url": "https://www.baidu.com",
                                    "android_url": "https://developer.android.com/",
                                    "ios_url": "https://developer.apple.com/",
                                    "pc_url": "https://www.windows.com"
                                },
                                "value": "james"
                            },
                            {
                                "text": {
                                    "tag": "plain_text",
                                    "content": "指定跳转"
                                },
                                "url": "https://www.baidu.com"
                            },
                            {
                                "text": {
                                    "tag": "plain_text",
                                    "content": "文本内容"
                                },
                                "value": "joy"
                            },
                            {
                                "text": {
                                    "tag": "plain_text",
                                    "i18n": {
                                        "zh_cn": "中文文本-james",
                                        "en_us": "English text-james",
                                        "ja_jp": "日本語文案-james"
                                    }
                                },
                                "value": "james"
                            }
                        ]
                    },
                    {
                        "tag": "date_picker",
                        "placeholder": {
                            "tag": "plain_text",
                            "content": "请选择日期(配有confirm)"
                        },
                        "confirm": {
                            "title": {
                                "tag": "plain_text",
                                "content": "请确认"
                            },
                            "text": {
                                "tag": "plain_text",
                                "content": "跳转方式"
                            }
                        }
                    },
                    {
                        "tag": "date_picker",
                        "placeholder": {
                            "tag": "plain_text",
                            "content": "请选择日期"
                        },
                        "initial_date": "2002-2-22"
                    },
                    {
                        "tag": "picker_time",
                        "placeholder": {
                            "tag": "plain_text",
                            "content": "请选择日期(配有confirm)"
                        },
                        "confirm": {
                            "title": {
                                "tag": "plain_text",
                                "content": "请确认"
                            },
                            "text": {
                                "tag": "plain_text",
                                "content": "跳转方式"
                            }
                        }
                    },
                    {
                        "tag": "picker_time",
                        "placeholder": {
                            "tag": "plain_text",
                            "content": "请选择日期"
                        },
                        "initial_time": "19:09"
                    },
                    {
                        "tag": "picker_datetime",
                        "placeholder": {
                            "tag": "plain_text",
                            "content": "请选择日期(配有confirm)"
                        },
                        "confirm": {
                            "title": {
                                "tag": "plain_text",
                                "content": "请确认"
                            },
                            "text": {
                                "tag": "plain_text",
                                "content": "跳转方式"
                            }
                        }
                    },
                    {
                        "tag": "picker_datetime",
                        "placeholder": {
                            "tag": "plain_text",
                            "content": "请选择日期"
                        },
                        "initial_datetime": "2002-2-22 18:00"
                    }
                ]
            }
        ]
    }
 }

curl --location --request POST 'https://open.feishu.cn/open-apis/ephemeral/v1/send' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "chat_id": "oc_xxxxxxxxxxxx", "open_id": "ou_xxxxxxxxxxxx", "msg_type": "interactive", "card": { // card content } }'

请求参数

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

chat_id

string

必需

发送临时消息的群ID可通过事件推送获取

open_id

string

必需

指定发送临时消息卡片的用户，其他人将无法看到临时消息卡片，只需要填 open_id、email、user_id（id介绍详见用户相关的 ID 概念）中的一个即可。服务端依次读取字段的顺序为 open_id > user_id > email

msg_type

string

必需

消息的类型，此处固定填 "interactive"

card

object

必需

消息卡片的描述内容，具体参考基础结构

示例

application/json

Body

code

integer

必需

返回码，非 0 表示失败

data

object

必需

message_id

string

消息 ID

必需

msg

string

返回码描述

必需

发送仅特定人可见的消息卡片

使用场景#

错误码#

请求体demo#

请求参数

返回响应

使用场景

错误码

请求体demo