钉钉如何使用消息模板发送工作通知?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
要使用消息模板发送工作通知,您可以按照以下步骤进行操作:
创建消息模板:登录到钉钉开放平台(https://open-dev.dingtalk.com/),进入应用详情页。在应用详情页中,找到并点击 "消息模板" 或类似的选项。根据需要,创建适合您的工作通知的消息模板。
获取AccessToken:在调用钉钉API之前,您需要获取访问令牌(AccessToken)。可以通过调用 https://oapi.dingtalk.com/gettoken
接口来获取AccessToken,使用企业的corpid和corpsecret作为参数。
使用消息模板发送通知:使用获取到的AccessToken调用消息发送接口,例如 https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2
。在请求的Body中,指定相关的参数,包括接收者、消息类型、消息内容等。对于工作通知,可以选择使用msgtype
字段为 text
或 oa
类型,具体根据您的需求而定。
处理发送结果:API调用成功后,您将会收到响应,其中包含了发送通知的结果信息。您可以根据响应中的数据来处理发送结果,以确保通知已被正确发送。
在钉钉中,发送工作通知消息的步骤如下:
创建并配置消息模板:首先,您需要在钉钉的管理后台进入"工作台"->"审批"->"模板消息"来创建并编辑自己的消息模板。您可以选择预设的模板进行修改,或者创建一个全新的模板。
获取卡片模板ID:在模板创建完成后,进入模板的详情页,找到"模板ID"这个字段,这个就是你需要的卡片模板ID。
调用接口发送消息:然后,第三方企业应用可以通过调用接口,使用获取到的消息模板发送工作通知。请求方式为POST,请求地址为 "https://oapi.dingtalk.com/topapi/message/corpconversation/sendbytemplate"。请注意,有一些限制条件,比如单次发送人数最大1000,每分钟接收人数最大5000等。
使用模板发送工作通知消息https://open.dingtalk.com/document/isvapp/work-notification-templating-send-notification-interface
调用本接口,使用消息模板发送工作通知。
重要
在调用本接口前,确保已经在开发者后台配置并启用了消息模板。详情请参考创建和配置消息模板。
第三方企业应用调用本接口,发送工作通知消息需要注意以下事项:
单次发送人数最大1000。
每分钟接收人数最大5000。
给同一员工,每天只能发送一条内容相同的消息。
每天给每个员工最多可发送100条。
调用本接口使用消息模板发送工作通知。使用消息模板可以提供更加简化和规范的消息体验,同时也能提供更加安全和可管可控的消息通知能力。但消息模板只支持第三方企业应用,不支持企业内部应用。具体使用方法可参考消息模板概述。此回答整理自钉群“钉钉开发者社区(互助群)”