form.sendmsg
功能说明
描述
给当前团队成员发送“微信”或“钉钉”消息，团队创建账号需要绑定“企业微信”或“钉钉”，个人使用需要关注公众号，由公众号登录一次即可绑定微信接收通知。
内部根据团队类型分别发送给微信或钉钉，每天最多执行成功500次，注意消息次数是和表单设置的【日期时间字段推送提醒】公用的。
函数原型
form.sendmsg(title,msg,depts="",userids="",url="")参数
| 名称 | 类型 | 描述 |
|---|---|---|
| title | 字符型 | 消息标题 |
| msg | 字符型 | 消息数据 |
| depts | 字符/数组：列表型 | 成员所在的部门id（数组表示发送给多个部门的所有成员） |
| userids | 字符/数组：列表型 | 成员id（数组表示发送给多个成员，成员和部门存在重复的只会收到一次消息） |
| url | 字符型 | 点击消息跳转的链接（必须是当前应用表单或报表的内链， 建议通过 app.geturl 或 form.getdataurl 等api获取） |
返回值
| 类型 | 描述 |
|---|---|
| 整型 | 执行成功返回发送的消息条数，失败返回-1 |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1591 | 操作非法 |
| 1313 | 参数非法 |
| 1593 | 请求失败 |
| 5004 | 非法的json格式 |
其他：
- 所有表单api调用频率限制为1000次/分钟
示例
def test():
# 给多个部门的所有成员和多个成员发消息, 成员重复只会收到1次消息
# url = app.geturl("测试表单") # 表单外链url
url=form.getdataurl("测试表单","5cac38adf790b4b2002a4","","view") # 表单数据url
ret=form.sendmsg("我的标题","我的消息内容",["575fba8e4922270ec4afab4b","557a1de50024ff0994f17928"],["517bf4c0414b86656cc425bf","5f529a097c1b09a57ac02cfe"],url)
print(ret)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无