# 配置钉钉连接器
钉钉连接器用于实现在工作流中通过配置操作钉钉相关功能。
钉钉（Ding Talk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。
#### 创建钉钉连接
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。

2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。
3. 选择"钉钉"连接器。
4. 在弹窗中配置连接器信息，完成后单击"确定"。
   
   | 参数            | 说明                                                              |
   |:---|:---|
   | 连接名称          | 填写连接器实例名称。                                                      |
   | 应用凭证AppKey    | 应用凭证AppKey，可从钉钉的"应用开发\>企业内部应用\>应用详情页\>应用信息"获取。                  |
   | 应用凭证AppSecret | 应用凭证AppSecret，可从钉钉的"应用开发\>企业内部应用\>应用详情页\>应用信息"获取。               |
   | 机器人RobotCode  | 机器人RobotCode，可从钉钉的"应用开发\>企业内部应用\>应用详情页\>机器人与消息推送"获取。使用机器人功能时必填。 |
   | 描述            | 填写连接器的描述信息，用于识别不同的连接器。                                          |
      
   
 
#### 支持的动作
- 机器人发送链接消息
- 机器人发送Markdown消息
- 机器人发送图片消息
- 机器人发送文件消息
- 机器人发送ActionCard消息
- 机器人发送文本消息
 
#### 配置参数
表1机器人发送链接消息 
| 参数   | 说明                                                       |
|:---|:---|
| 群聊ID | 从钉钉的创建企业内部群或创建场景群接口获取。对于已存在的群，可以用钉钉的根据corpid选择会话JSAPI获取。 |
| 消息标题 | 消息通知标题。                                                  |
| 消息内容 | 消息内容。                                                    |
| 图片链接 | 消息预览图链接。                                                 |
| 跳转链接 | 消息单击后跳转链接。                                               |
   
表2机器人发送Markdown消息 
| 参数   | 说明                                                       |
|:---|:---|
| 群聊ID | 从钉钉的创建企业内部群或创建场景群接口获取。对于已存在的群，可以用钉钉的根据corpid选择会话JSAPI获取。 |
| 消息标题 | 消息通知标题。                                                  |
| 消息内容 | 消息内容。                                                    |
   
表3机器人发送图片消息 
| 参数   | 说明                                                       |
|:---|:---|
| 群聊ID | 从钉钉的创建企业内部群或创建场景群接口获取。对于已存在的群，可以用钉钉的根据corpid选择会话JSAPI获取。 |
| 图片链接 | 消息预览图链接。                                                 |
   
表4机器人发送文件消息 
| 参数     | 说明                                                       |
|:---|:---|
| 群聊ID   | 从钉钉的创建企业内部群或创建场景群接口获取。对于已存在的群，可以用钉钉的根据corpid选择会话JSAPI获取。 |
| 媒体文件ID | 通过上传媒体文件接口，获取media_id参数值。                                |
| 文件名称   | 发送的文件名称。                                                 |
| 文件类型   | 支持xlsx、pdf、zip、rar、doc、docx文件。                           |
   
表5机器人发送ActionCard消息 
| 参数     | 说明                                                       |
|:---|:---|
| 群聊ID   | 从钉钉的创建企业内部群或创建场景群接口获取。对于已存在的群，可以用钉钉的根据corpid选择会话JSAPI获取。 |
| 消息标题   | 消息通知标题。                                                  |
| 消息内容   | 消息内容。                                                    |
| 跳转按钮文本 | 跳转按钮显示内容。                                                |
| 跳转链接   | 消息单击后跳转链接。                                               |
   
表6机器人发送文本消息 
| 参数   | 说明                                                       |
|:---|:---|
| 群聊ID | 从钉钉的创建企业内部群或创建场景群接口获取。对于已存在的群，可以用钉钉的根据corpid选择会话JSAPI获取。 |
| 消息内容 | 消息内容。                                                    |