钉钉发送工作通知消息接口的限制主要包括以下几个方面:
1. 消息内容大小限制
- 推送标题:不同通道对标题长度的限制范围不同,通常在20~50字符以内。
- 消息内容:
- 消息内容和Android通知的大小不得超过 4KB。
- iOS通知的大小不得超过 4000字节(约4KB)。
2. 消息发送频率限制
- 每个机器人每分钟最多发送 20条消息。如果超过该限制,系统会对该机器人限流 10分钟。
3. 安全配置要求
- 创建钉钉机器人时,必须至少选择一种安全设置以保障自定义机器人的安全性。推荐的安全配置包括:
- 自定义关键词:发送的消息中必须包含至少一个预设的关键词,否则消息将发送失败。例如,若设置了关键词“温度”,则消息内容中必须包含“温度”才能成功发送。
- 加签或IP地址(段):建议选择其中至少一种安全设置,以确保消息发送的安全性。
4. 接收者范围限制
- 工作通知消息只会发送给任务的参与者。即使用户是项目的拥有者,但如果不是具体任务的参与者,则无法收到相关的工作通知。
5. Token有效期限制
- 调用申请Token接口时,Token的有效期为 30天。即使在接口调用时设置了更长的
ExpireTime
值,实际有效期仍为30天。
6. 离线消息存储与可见性限制
- 离线消息的可见时间存在延迟,通常为 5~10秒。服务端需要等待超时或失败后才能确认消息是否转化为离线消息。
- 每个实例存储的离线消息数量上限为 100万条。如果超出该限制,服务端会从最早的消息开始清理。因此,建议合理使用持久化订阅模式,避免产生过多无用的离线消息。
7. 其他重要限制
- 自己操作的通知屏蔽:用户自己进行的操作不会触发给自己发送的工作通知。
- 公网访问能力要求:通过钉钉机器人发送消息时,要求工作流集群的VPC网络具有公网访问能力。可以通过配置公网NAT网关,并将EIP地址添加到机器人的IP地址(段)中,以确保安全性。
总结
以上限制涵盖了消息内容、发送频率、安全配置、接收者范围、Token有效期以及离线消息存储等多个方面。在使用钉钉发送工作通知消息时,请务必遵守这些限制,以确保消息能够成功发送并被正确接收。