Skip to main content

创建和配置消息模板

  1. 登录开发者后台
  2. 单击 应用开发,然后选择 第三方企业应用,创建一个小程序或H5微应用。
  3. 在应用详情页面,单击 消息推送。在消息模板管理区域,单击 新增 iShot2022-02-08 10
  4. 选择一个模板类型,单击 去创建 消息模板
  5. 配置消息模板,然后单击 保存 重要 如果模板中配置了模板参数,下方会自动加载模板参数,然后可以配置动态参数的含义描述。 消息内容中有部分值是动态变化的,如订单号、手机号、商品名称等等,在设置模板的时候无法确定,可以通过模板参数来替代。
  6. 单击 测试,然后单击 发送测试消息 测试消息模板是否配置正确。

配置Markdown模板

Markdown模板使用Markdown语法配置和发送消息,适用于非操作的纯通知消息类型。 通过Markdown模板,可以方便地支持文本、图片、链接等展现方式。 markdown Markdown消息模板配置说明 Markdown语法

ActionCard模板

ActionCard模板是以ActionCard消息类型来发送消息的,支持消息内容和行动点操作组合类消息,适用于在消息中需要通过单个或多个行动点快速处理的场景。 ActionCard模板在Markdown模板的基础上,支持整体跳转和独立跳转的样式。 actioncard ActionCard模板配置说明

Form模板

Form模板基于OA消息类型来发送消息。适用于订单等消息展示,支持跳转查看消息详情。 form模板 Form消息模板配置说明

配置模板参数

消息内容中有部分值是动态变化的,如订单号、手机号、商品名称等等,在设置模板的时候无法确定,可以通过模板参数来替代。 发送工作通知时传入真实值替换模板参数。模板参数不是必须,可根据实际情况配置。 模板参数的格式 模板参数采用的格式为${参数名},参数应当符合以下规范。
  • 必须以字母、下划线开头
  • 除开头外后面的部分可以有字母、下划线以及数字组成。
  • 一条消息的动态参数建议不要设置过多。建议不超过5个。
例如消息内容为:
其中的${product}就是模板参数,参数名为product,在发送消息时传入该参数值即可,例如在发送消息时传入product为“一次性口罩”。那么“一次性口罩”就将替换${product}模板参数,最终用户收到的消息内容为:
一个消息模板可配置若干个模板参数,也可以不配置模板参数,请根据实际情况设置。 id转译 传入动态参数时,支持id转译。目前支持将部门id转换为部门名称,userId转换为用户名。 id转译语法如下:
其中:
  • DEPARTMENT_ID是数字类型的部门id。
  • USERID是用户的userid。
例如:
  • departmentName=100departmentName=100替换成部门id为“100”对应的部门名,如“钉钉开放平台”。
  • userName=zhangsan01userName=zhangsan01替换成userid为“zhangsan01”对应的用户名,如“张三”。

提交审核

创建消息模板后,单击 提交 进行模板审核。 p178933

启用模板

当模板审核通过后,自动启用该模板。消息模板是启用状态时,可通过调用接口发送模板消息。详情请参考使用模板发送工作通知消息 启用

停用模板

当不需要使用某个模板时,关闭启用按钮,停止使用该模板。

删除模板

单击 删除 删除一个模板。

克隆模板

单击 克隆 复制一个相同配置的模板。

测试模板

单击 编辑 后,进入模板编辑界面,点击模板编辑页面下的 测试 按钮进行测试,测试会给自己发送一条工作通知。