创建和配置消息模板
- 登录开发者后台。
- 单击 应用开发,然后选择 第三方企业应用,创建一个小程序或H5微应用。
-
在应用详情页面,单击 消息推送。在消息模板管理区域,单击 新增。
-
选择一个模板类型,单击 去创建。
- 配置消息模板,然后单击 保存。 重要 如果模板中配置了模板参数,下方会自动加载模板参数,然后可以配置动态参数的含义描述。 消息内容中有部分值是动态变化的,如订单号、手机号、商品名称等等,在设置模板的时候无法确定,可以通过模板参数来替代。
- 单击 测试,然后单击 发送测试消息 测试消息模板是否配置正确。
配置Markdown模板
Markdown模板使用Markdown语法配置和发送消息,适用于非操作的纯通知消息类型。 通过Markdown模板,可以方便地支持文本、图片、链接等展现方式。
Markdown消息模板配置说明
Markdown语法:
ActionCard模板
ActionCard模板是以ActionCard消息类型来发送消息的,支持消息内容和行动点操作组合类消息,适用于在消息中需要通过单个或多个行动点快速处理的场景。 ActionCard模板在Markdown模板的基础上,支持整体跳转和独立跳转的样式。
ActionCard模板配置说明
Form模板
Form模板基于OA消息类型来发送消息。适用于订单等消息展示,支持跳转查看消息详情。
Form消息模板配置说明
配置模板参数
消息内容中有部分值是动态变化的,如订单号、手机号、商品名称等等,在设置模板的时候无法确定,可以通过模板参数来替代。 发送工作通知时传入真实值替换模板参数。模板参数不是必须,可根据实际情况配置。 模板参数的格式 模板参数采用的格式为${参数名},参数应当符合以下规范。
- 必须以字母、下划线开头
- 除开头外后面的部分可以有字母、下划线以及数字组成。
- 一条消息的动态参数建议不要设置过多。建议不超过5个。
${product}就是模板参数,参数名为product,在发送消息时传入该参数值即可,例如在发送消息时传入product为“一次性口罩”。那么“一次性口罩”就将替换${product}模板参数,最终用户收到的消息内容为:
- DEPARTMENT_ID是数字类型的部门id。
- USERID是用户的userid。
- 将替换成部门id为“100”对应的部门名,如“钉钉开放平台”。
- 将替换成userid为“zhangsan01”对应的用户名,如“张三”。
提交审核
创建消息模板后,单击 提交 进行模板审核。
启用模板
当模板审核通过后,自动启用该模板。消息模板是启用状态时,可通过调用接口发送模板消息。详情请参考使用模板发送工作通知消息。