飞书机器人系列5——发送富文本至飞书群

经验分享

花括号

2025-06-13 18:26·浏览量：1874

花括号

影刀专家

发布于 2025-06-13 18:261874浏览

富文本

支持使用飞书原格式内容，参考飞书消息说明，若需要通过输入电话号码或者邮箱进行@操作，要求可以根据该电话号码和邮箱获取到对应的user_id，具体操作参考通过手机号或邮箱获取用户 ID

飞书消息说明——在一条富文本消息中，支持添加文字、图片、视频、@、超链接等元素。如下 JSON 格式的内容是一个富文本示例，其中：

一个富文本可分多个段落（由多个 [] 组成），每个段落可由多个元素组成，每个元素由 tag 和相应的描述组成。
图片、视频元素必须是独立的一个段落。
style 字段暂不支持自定义机器人和批量发送消息接口。
实际发送消息时，需要将 JSON 格式的内容压缩为一行、并进行转义。（影刀指令里并不需要）
如需参考该 JSON 示例构建富文本消息内容，则需要把其中的 user_id、image_key、file_key 等示例值替换为真实值。

{
        "zh_cn": {
                "title": "我是一个标题",
                "content": [
                        [
                                {
                                        "tag": "text",
                                        "text": "第一行:",
                                        "style": ["bold", "underline"]
                  
                                },
                                {
                                        "tag": "a",
                                        "href": "http://www.feishu.cn",
                                        "text": "超链接",
                                        "style": ["bold", "italic"]
                                },
                                {
                                        "tag": "at",
                                        "user_id": "ou_1avnmsbv3k45jnk34j5",
                                        "style": ["lineThrough"]
                                }
                        ],
                  [{
                                "tag": "img",
                                "image_key": "img_7ea74629-9191-4176-998c-2e603c9c5e8g"
                        }],
                        [        
                                {
                                        "tag": "text",
                                        "text": "第二行:",
                                        "style": ["bold", "underline"]
                                },
                                {
                                        "tag": "text",
                                        "text": "文本测试"
                                }
                        ],
                  [{
                                "tag": "img",
                                "image_key": "img_7ea74629-9191-4176-998c-2e603c9c5e8g"
                        }],
                  [{
                                "tag": "media",
                                "file_key": "file_v2_0dcdd7d9-fib0-4432-a519-41d25aca542j",
                                "image_key": "img_7ea74629-9191-4176-998c-2e603c9c5e8g"
                        }],
                  [{
                                "tag": "emotion",
                                "emoji_type": "SMILE"
                        }],
                        [{
                                "tag": "hr"
                        }],
                        [{
                                "tag": "code_block",
                                "language": "GO",
                                "text": "func main() int64 {\n    return 0\n}"
                        }],
                        [{
                                "tag": "md",
                                "text": "**mention user:**<at user_id=\"ou_xxxxxx\">Tom</at>\n**href:**[Open Platform](https://open.feishu.cn)\n**code block:**\n```GO\nfunc main() int64 {\n    return 0\n}\n```\n**text styles:** **bold**, *italic*, ***bold and italic***, ~underline~,~~lineThrough~~\n> quote content\n\n1. item1\n    1. item1.1\n    2. item2.2\n2. item2\n --- \n- item1\n    - item1.1\n    - item2.2\n- item2"
                        }]
                ]
        },
        "en_us": {
                ...
        }
}

在 BEJSON 网站，编辑json文本并校验。