Skip to main content
钉钉端口通过自定义机器人向钉钉群发送消息，可用于业务通知。端口属于 MFT 类型，Webhook 地址和机器人安全设置直接保存在端口中，无需创建共享连接。

​
核心功能

  • 支持直接发送文本、使用 ArcScript 模板生成文本或 Markdown，以及发送原始 JSON 请求。
  • 支持机器人加签和自定义关键词校验。
  • 支持通过手机号、用户 ID 提醒群成员，或 @所有人。

​
添加机器人并获取 Webhook 地址

开始前，需要能够管理目标钉钉群中的机器人。以下以 PC 版钉钉为例：
  1. 打开目标群聊，进入右上角的群设置 → 智能群助手 → 添加机器人。
  2. 在机器人列表中选择自定义，单击添加，填写机器人名称和头像。
  3. 配置机器人的安全设置，至少选择一种。使用自定义关键词时，例如设置为 业务通知，并将同样的值填入端口的自定义关键词。
  4. 如启用加签，复制机器人的加签密钥，填入端口的加签密钥；未启用加签时留空。
  5. 按提示完成添加，复制生成的完整 Webhook URL，填入端口的Webhook 地址。
添加操作和地址获取位置可参考阿里云官方 Webhook 获取指南，安全选项可参考钉钉官方自定义机器人安全设置。如果启用 IP 白名单，应允许运行端口的服务器或代理访问公网时使用的出口 IP。 Webhook 地址通常如下，需替换为机器人实际生成的地址：

​
端口配置

​
设置选项卡

​
高级选项卡

​
使用方式

​
发送文本

  1. 填写 Webhook 地址及对应的安全设置，单击发送测试消息检查配置。
  2. 将发送模式设为文本，按需配置 @提醒。
  3. 将 UTF-8 文本消息传入端口，启用自动化中的发送以自动处理。
文本模式直接发送输入内容，不进行模板渲染。内容不能为空；端口按 UTF-8 字节数检查长度，文本和 Markdown 内容上限均为 20000 字节，自动添加的关键词也计入长度。

​
使用 ArcScript 模板

将发送模式设为模板，选择消息格式并填写消息模板。模板支持 ArcScript，可以读取当前消息内容和消息头，也支持宏。例如，选择 Markdown，将消息标题设为 文件处理完成，模板可填写：
每条输入消息都会触发模板渲染，端口将渲染结果按所选格式发送。结果不能为空，并受相同的内容长度限制。此示例读取当前消息的文件名，ArcScript 语法和用法可参阅ArcScript 入门。

​
发送原始 JSON

将发送模式设为原始 JSON，输入必须是包含 msgtype 的完整机器人请求 JSON 对象。例如，机器人配置了关键词 业务通知 时，可以使用：
此模式直接发送输入 JSON，不渲染模板，并忽略端口的消息格式、标题和 @提醒设置及对应消息头。若需 @成员或所有人，应在输入中设置 at 对象。 端口仍使用配置的 Webhook 地址和加签密钥。若配置了自定义关键词，输入消息体必须自行包含该关键词，否则会在发送前报错。link、actionCard 和 feedCard 等消息类型也可通过此模式发送，具体结构可参考钉钉官方自定义机器人接入文档。

​
处理结果

发送成功后，输入消息标记为成功。配置、模板渲染或发送失败时，输入消息标记为错误，可在交易日志中查看原因，并使用端口的重试设置重新处理。安全校验失败时，应检查关键词、加签密钥和 IP 白名单。