全面解析Markdown语法支持与使用指南

应用支持的消息类型

  应用支持推送多种类型的消息,包括文本、图片、视频、文件、图文等。无论是简单的文字信息,还是复杂的多媒体内容,都能通过应用轻松发送。

请求方式与地址

  在发送消息时,需要明确请求方式和请求地址。具体的请求方式会根据不同的消息类型有所变化,而请求地址则是消息发送的目标路径。

参数说明

  在发送消息时,需要了解各个参数的具体含义。不同消息类型的参数格式各不相同,具体格式可以参考后续的“消息类型”部分。

消息类型与限制

  如果在管理端设置了“在微工作台中始终进入主页”,那么在微信端只能接收到文本消息,且文本消息的长度限制为20字节,超过部分会被截断。其他消息类型也会被转换为文本消息,提示用户到企业微信查

转译功能

  应用支持转译功能,可以将部门或用户信息转换为对应的用户名或部门名。在企业授权了会话内容存档接口权限时,还可以将消息和群聊转换为对应的消息内容或群名称。目前,文本、文本卡片、图文、任务卡片、小程序通知、模版消息、模板卡片消息等八种消息类型的部分字段支持转译。

重复消息检查

  为了避免重复接收相同内容的消息,应用支持重复消息检查功能。开启该功能后,在一定时间间隔内,相同内容的消息不会重复接收。时间间隔可以自定义,默认情况下系统会自动处理。

小程序应用的消息发送

  从2025年2月4日开始,企业关联添加的「小程序」应用也可以发送文本、图片、视频、文件、图文等各种类型的消息。这为小程序应用提供了更多的消息发送方式。

调用建议与频率限制

  为了避免资源挤占,建议企业在每小时的0分或30分之外的时间点进行消息推送。此外,每个应用每天的消息发送次数不能超过账上限数的200倍,且对同一个成员的消息发送频率不能超过30次/分钟或1000次/小时,超过部分会被丢弃。

返回示例与权限说明

  如果部分接收人无权限或不存在,发送仍然会执行,但会返回无效的部分。常见的原因是接收人不在应用的可见范围内。权限包含应用可见范围和基础接口权限,如果全部接收人无权限或不存在,则本次调用返回失败。

文本消息的特殊说明

  文本消息的字段支持换行和标签,可以打开自定义的网页。换行符需要使用转义过的形式。

卡片消息的灵活展现

  卡片消息的展现形式非常灵活,支持使用标签或空格进行换行处理,也支持使用不同的字体颜色。目前内置了灰色、高亮和默认黑色三种文字颜色,具体用法可以参考示例。

图文消息的存储与统计

  图文消息的内容存储在企业微信中,多次发送会被认为是不同的图文,阅读和点赞的统计会被分开计算。

小程序通知消息的展示

  小程序通知消息只允许绑定了小程序的应用发送。从2025年6月28日起,用户收到的小程序通知会出现在各个应用中。微工作台(原企业)不支持展示小程序通知消息。

模板卡片消息的支持

  投票选择型和多项选择型卡片仅企业微信3.1.12及以上版本支持。文本通知型、图文展示型和按钮交互型三种卡片仅企业微信3.1.6及以上版本支持。微工作台(原企业)不支持展示模板卡片消息。

转译语法的支持

  目前应用消息中支持的语法是子集,包括支持的消息类型和对应的字段,以及转译模版语法。转译时,如果用户没有别名,则不替换该项内容,保留原样。如果用户有别名,则替换为别名;否则,将替换为姓名。

会话内容存档的转译

  在企业授权了会话内容存档接口权限时,也支持转译消息内容和群聊名称。如果转译失败,将只会展示部分内容,以防止意外泄漏。

群聊转译的特殊情况

  支持转译内部群和外部群的名称,不包括单聊。对于无名称的企业内部群聊,展示为“无名称群聊”;对于无名称的企业客户群聊,展示为“无名称客户群”;对于非企业客户群,展示为“非企业客户群”。

消息转译的其他特殊情况

  如果企微后台系统失败,消息将显示为“消息获取失败”;如果消息不存在或过期,将显示为“消息已过期,消息内容无法展示”;如果密钥错误,将显示为“消息密钥错误”。

© 版权声明
THE END
分享