服务端 API/消息/消息卡片/发送仅特定人可见的消息卡片 # 发送仅特定人可见的消息卡片 用于机器人在群会话中发送仅指定用户可见的消息卡片。卡片上将展示"仅对你可见"标识。
![image.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/b0ec0ce45942463381457edc7b62e144_RXYCFtfUtb.png?lazyload=true&width=1592&height=486) ## 使用场景 临时消息卡片多用于群聊中用户与机器人交互的中间态。例如在群聊中用户需要使用待办事项类bot创建一条提醒，bot 发送了可设置提醒日期和提醒内容的一张可交互的消息卡片，此卡片在没有设置为临时卡片的情况下为群内全员可见，即群内可看见该用户与 bot 交互的过程。而设置为临时卡片后，交互过程仅该用户可见，群内其他成员只会看到最终设置完成的提醒卡片。

通过临时消息卡片，可以减少消息对群聊中不相关用户的打扰，有效降低群消息的噪声。 **注意事项**：需要启用[机器人能力](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)；需要机器人在会话群里。 **注意事项**：- 仅触发临时卡片的用户自己可见。 - 不支持转发。 - 只能在群聊使用。 - 仅在用户处于在线状态的Lark客户端上可见。 - 临时消息卡片的[呈现能力](https://open.larksuite.com/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)、[交互能力](https://open.larksuite.com/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)与消息卡片一致。 ## 请求 基本 |   ---|--- HTTP URL | https://open.larksuite.com/open-apis/ephemeral/v1/send HTTP Method | POST ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 请求体 | 参数| 类型 | 必须 | 说明 |示例 | | - | - | - | - | - | | chat_id|string | 是 | 发送临时消息的群ID可通过事件推送获取 |oc_5ad573a6411d72b8305fda3a9c15c70e| open_id
user_id
email
| string | 是 | 指定发送临时消息卡片的用户，其他人将无法看到临时消息卡片；只需要填 open_id、email、user_id中的一个即可，推荐使用 OpenID，获取方式可参考文档[如何获取 Open ID？](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) （服务端依次读取字段的顺序为 **open_id** > **user_id** > **email**）|ou_5ad573a6411d72b8305fda3a9c15c70e| | msg_type | string | 是 | 消息的类型，此处固定填 "interactive" |interactive| | card|object | 是 | 消息卡片的描述内容，具体参考 [基础结构](https://open.larksuite.com/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)| ### 请求体示例 ```json { "chat_id": "oc_xxxxxxxxxxxx", "open_id": "ou_xxxxxxxxxxxx", "msg_type": "interactive", "card": { // card content } } ``` ## 响应 ### 响应体 |参数|类型|说明| |-|-|-| |code|int|返回码，非 0 表示失败| |msg|string|返回码描述| data | - | -  ∟message_id |string| 消息 ID ### 响应体示例 ```json { "code": 0, "data": { "message_id": "om_fd2057276f16243756ff8eb6fcd7b705" }, "msg": "ok" } ``` ### 错误码 具体可参考：[服务端错误码说明](https://open.larksuite.com/document/ukTMukTMukTM/ugjM14COyUjL4ITN) ### 请求体demo ```json { "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" } ] } ] } } ```