钉钉发工作待办需要传什么?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
要在钉钉中发起工作待办,您需要传递以下参数:
用户ID(userid): 待办任务的接收人,在钉钉中使用的唯一标识符,可以是用户的手机号、钉钉ID或企业内部员工ID。
待办内容(title): 待办任务的标题,用于描述待办任务的主要内容。
待办链接(url): 待办任务的跳转链接,点击链接后将跳转到指定页面。可以是一个内部网页链接或者其他可访问的链接。
待办时间(time): 待办任务的截止时间,用于指定该待办任务的完成期限。
示例代码(Python):
import requests
webhook_url = "https://oapi.dingtalk.com/robot/send?access_token=your_access_token"
message = {
"msgtype": "actionCard",
"actionCard": {
"title": "工作待办",
"text": "请尽快处理相关事项。",
"btnOrientation": "0",
"btns": [
{
"title": "查看详情",
"actionURL": "https://www.example.com/todo"
}
]
}
}
headers = {
'Content-Type': 'application/json'
}
response = requests.post(webhook_url, json=message, headers=headers)
上述示例中的 webhook_url
是钉钉机器人的Webhook地址,message
中包含了待办任务的相关内容。您可以根据具体需求修改 title
、text
和 actionURL
来设置待办任务的标题、描述和链接。
要在钉钉中发起工作待办,您需要传递以下参数:
用户ID(userid):指定待办任务的接收人,可以是用户在钉钉中的唯一标识符。
待办标题(title):设置待办任务的标题或名称。
待办内容(content):设置待办任务的详细描述或内容。
跳转链接(url):如果需要,可以提供一个跳转链接,使接收人能够直接点击待办任务并跳转到相关页面。
任务表单(formItemList):如果需要,在待办中显示一个表单,您可以传递一个JSON数组来定义表单字段和值。每个表单字段包含字段名(name)和字段值(value)。
接收人类型(receiverType):指定接收人类型,可以是“user”表示个人,也可以是“group”表示群组。
定时提醒(remindTime):如果需要,在特定时间进行提醒,您可以指定一个时间戳。
如何配置钉钉待办
1.1 普通流程
路径:点击对应的流程表单 >> 页面设置 >> 消息通知 >> 新建消息通知 >> 选择第一个模板卡片 >> 打开更多设置 >> 消息类型选择钉钉待办,如图:
1.2 高级流程
路径:选择人工节点设置 >> 高级 >> 钉钉待办
1.3 发送钉钉通知
(1)打开发送钉钉通知开关;
(2)可以选择关闭普通消息通知,关闭普通消息通知后,只会出现在待办里面,不会通过工作通知提醒;
(3)配置钉钉待办模板,参考消息通知配置;
在钉钉中,发送工作待办事项需要提交以下信息:
POST https://open.dingtalk.com/api/dingtalk/sdd/sendTodoMessage
复制复制
请求头需要包含钉钉应用的access_token,请求体中需要包含上述信息。以Python为例,示例代码如下:
import requests
import json
url = "https://open.dingtalk.com/api/dingtalk/sdd/sendTodoMessage"
access_token = "your_access_token"
data = {
"content": "测试工作待办",
"dueDate": "2022-12-31",
"priority": "高",
"status": "待办",
"creator": "张三",
"acceptor": ["李四", "王五"],
"deptId": "123456"
}
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {access_token}"
}
response = requests.post(url, headers=headers, json=data)
print(response.text)
复制复制