钉钉消息

1 功能简介

钉钉消息发送事件可以满足不同类型的钉钉消息发送业务需求。

2 配置说明

（1）文本消息

使用场景
文本消息发送仅支持钉钉消息通知中最基础的一种，仅支持文本内容发送。

扩展阅读：钉钉文本消息（text）

配置说明

• 选择微应用：钉钉消息是通过微应用去发送的，首先需要选择门户管理后台【第三方平台-钉钉-微应用配置】下配置的微应用。有关微应用的配置说明，详见： 第三方平台-钉钉 或 钉钉微应用案例。
• SQL模式（数据来源于自定义SQL）：开启后适用于更加灵活的数据来源（如接收人和消息内容与表单字段无直接关联），可以通过SQL取数，使得【接收用户】和【消息内容】的数据来源于取数SQL的返回字段值，格式同字段取数后台表达式${row.getValue(‘字段名称’)}。
• 接收用户：用于填写接收钉钉消息的用户账号（多个用户之间用”,”隔开），可以直接是钉钉id，也可以是系统用户表中的用户编码ID_、用户工号JOB_NUMBER、用户登录名NAME_这3个字段，配合【用户转换】中的配置转换为系统用户表中的DING_ID字段值进行钉钉消息的发送。
• 用户转换：配合【接收用户】使用，当接收用户中使用的是钉钉id时是可以直接进行消息发送的，可以选择“不转换”。若【接收用户】的取值不能直接作为消息发送的用户信息，例如接收用户使用的是用户工号，此时无法直接进行钉钉消息发送，因此需要通过用户工号在系统用户表进行关联查找，转换为DING_ID字段值进行消息发送。支持关联查找的用户字段有：用户编码ID_、用户工号JOB_NUMBER、用户登录名NAME_。
• 消息内容：支持从元数据字段中取数，也支持引用取数SQL返回的字段值。
• 逐条发送：未勾选时，对于少量用户而言可以同一批发送，发送效率更高；勾选时，将按用户分多次调用接口逐条发送，主要用于应对大批量用户（1000以上）发送可能会超出接口单次发送限额的情况。

执行与显示
文本消息显示效果如下：

（2）卡片消息

如果希望可以从接收到的钉钉消息中跳转链接查看，例如推送的是流程待办消息希望用户可以直接点击消息通知就能去相应的页面进行处理，可以选择使用钉钉卡片消息（链接消息）。

详见专题 钉钉消息事件支持卡片消息