工作通知

发送工作通知

host: https://yach-oapi.zhiyinlou.com 正式环境

host: https://yach-oapi-test.zhiyinlou.com 测试环境

概述

名称	值
地址	/notice/message/send?access_token=ACCESS_TOKEN
请求方式	POST
参数	见【参数】
返回值	见【返回值】

参数

参数	参数类型	必须	说明
access_token	String	是	调用接口凭证
agent_id	String	是	应用app_id
userid_list	String	否	接收助手消息的员工id "|" 隔开的yach唯一标识例如"yach076429|yach091805|yach131763" ，最大列表长度：100
dept_id_list	String	否	接收者的部门id列表，最大列表长度：20, 接收者是部门id下(包括子部门下)的所有用户示例值23
to_all_user	String	否	是否发送给企业全部用户
message	String	是	消息格式参考：消息类型与数据格式
is_skip_error	Int	否	遇到不存在的用户，是否跳过校验，默认0（0:否1:是）

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "taskId": 39723147066478844
    }
}

撤回工作通知

host: https://yach-oapi.zhiyinlou.com 正式环境

host: https://yach-oapi-test.zhiyinlou.com 测试环境

概述

名称	值
地址	/notice/message/recall?access_token=ACCESS_TOKEN
请求方式	POST
参数	见【参数】
返回值	见【返回值】

参数

参数	参数类型	必须	说明
access_token	String	是	调用接口凭证
msg_task_id	String	是	任务ID

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
    }
}

查看工作通知发送结果

host: https://yach-oapi.zhiyinlou.com 正式环境

host: https://yach-oapi-test.zhiyinlou.com 测试环境

概述

名称	值
地址	/notice/message/result?access_token=ACCESS_TOKEN
请求方式	POST
参数	见【参数】
返回值	见【返回值】

参数

参数	参数类型	必须	说明
access_token	String	是	调用接口凭证
msg_task_id	String	是	任务ID

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "status": 1 // 1:发送成功 2:发送失败 3:处理中
    }
}