1. 机器人推送接口
企业微信官方文档
钉钉官方文档
消息发送接口支持发送文本消息、link消息、markdown消息。
接口地址
https://www.fdccloud.com/api/tenant-open/send-msg-by-robot?access_token={$access_token}
传参方式：
POST
1.1. 文本消息
钉钉
{
"msg_source": "dingtalk",
"web_hook": "https://oapi.dingtalk.com/robot/send?access_token=fb0bd06008f8e76f0437b45c8305044dc16e83a0442ccca2567dd37e5433fb4a",
"msg_content": {
"msgtype": "text",
"text": {
"content": "云助手测试-我就是我,是不一样的烟火@188xxxx3515"
},
"at": {
"atMobiles": ["188xxxx3515"],
"isAtAll": true
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| msg_source | 必须有，(区分企业微信和钉钉) ，dingtalk或者wx |
| web_hook | 必填，机器人的Webhook地址 |
| msg_content | 必须有，消息主体 |
| msgtype | 必须有，消息类型 |
| content | 必须有，消息内容 |
| atMobiles | 非必填，被@人的手机号（在content里添加@人的手机号） |
| isAtAll | 非必填，是否@所有人 |
企业微信
{
"msg_source": "wx",
"web_hook": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=a0df548f-520d-4991-a05f-85d67118131d",
"msg_content": {
"msgtype": "text",
"text": {
"content": "广州今日天气：29度，大部分多云，降雨概率：60%",
"mentioned_list":[
"wangqing",
"@all"],
"mentioned_mobile_list":[
"13800001111",
"@all"]
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| msg_source | 必须有，(区分企业微信和钉钉) ，dingtalk或者wx |
| web_hook | 必填，机器人的Webhook地址 |
| msg_content | 必须有，消息主体 |
| msgtype | 必须有，消息类型 |
| content | 必须有，文本内容，最长不超过2048个字节，必须是utf8编码 |
| mentioned_list | 非必填，userid的列表，提醒群中的指定成员(@某个成员)，@all表示提醒所有人，如果开发者获取不到userid，可以使用mentioned_mobile_list |
| mentioned_mobile_list | 非必填，手机号列表，提醒手机号对应的群成员(@某个成员)，@all表示提醒所有人 |
1.2. link消息
钉钉
{
"msg_source": "dingtalk",
"web_hook": "https://oapi.dingtalk.com/robot/send?access_token=fb0bd06008f8e76f0437b45c8305044dc16e83a0442ccca2567dd37e5433fb4a",
"msg_content": {
"msgtype": "link",
"link": {
"text": "这个即将发布的新版本，创始人xx称它为红树林。而在此之前，每当面临重大升级，产品经理们都会取一个应景的代号，这一次，为什么是红树林",
"title": "时代的火车向前开",
"picUrl": "",
"messageUrl": "https://www.fdccloud.com/"
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| msg_source | 必须有，(区分企业微信和钉钉) ，dingtalk或者wx |
| web_hook | 必填，机器人的Webhook地址 |
| msg_content | 必须有，消息主体 |
| msgtype | 必须有，消息类型 |
| title | 必须有，消息标题 |
| text | 必填，消息内容。如果太长只会部分展示 |
| messageUrl | 必填，点击消息跳转的URL |
| picUrl | 非必填，图片URL |
企业微信
{
"msg_source": "wx",
"web_hook": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=a0df548f-520d-4991-a05f-85d67118131d",
"msg_content": {
"msgtype": "news",
"news": {
"articles" : [
{
"title" : "中秋节礼品领取",
"description" : "今年中秋节公司有豪礼相送",
"url" : "www.qq.com",
"picurl" : "http://res.mail.qq.com/node/ww/wwopenmng/images/independent/doc/test_pic_msg1.png"
}
]
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| msg_source | 必须有，(区分企业微信和钉钉) ，dingtalk或者wx |
| web_hook | 必填，机器人的Webhook地址 |
| msg_content | 必须有，消息主体 |
| msgtype | 必须有，消息类型 |
| articles | 必须有，图文消息，一个图文消息支持1到8条图文 |
| title | 必填，标题，不超过128个字节，超过会自动截断 |
| description | 非必填，描述，不超过512个字节，超过会自动截断 |
| url | 必填，点击后跳转的链接。 |
| picurl | 非必填，图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图 1068455，小图150150。 |
1.3. markdown消息
钉钉
{
"msg_source": "dingtalk",
"web_hook": "https://oapi.dingtalk.com/robot/send?access_token=fb0bd06008f8e76f0437b45c8305044dc16e83a0442ccca2567dd37e5433fb4a",
"msg_content":{
"msgtype": "markdown",
"markdown": {
"title":"杭州天气",
"text": "#### 杭州天气 @150XXXXXXXX \n> 9度，西北风1级，空气良89，相对温度73%\n> \n> ###### 10点20分发布 [天气](https://www.dingalk.com) \n"
},
"at": {
"atMobiles": [
"150XXXXXXXX"
],
"isAtAll": false
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| msg_source | 必须有，(区分企业微信和钉钉)，dingtalk或者wx |
| web_hook | 必填，机器人的Webhook地址 |
| msg_content | 必须有，消息主体 |
| title | 必须有，首屏会话透出的展示内容 |
| text | 必须有，markdown格式的消息 |
| atMobiles | 非必填，被@人的手机号（在text内容里要有@手机号） |
| isAtAll | 非必填，是否@所有人 |
企业微信
{
"msg_source": "wx",
"web_hook": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=a0df548f-520d-4991-a05f-85d67118131d",
"msg_content":{
"msgtype": "markdown",
"markdown": {
"content": "实时新增用户反馈<font color=\"warning\">132例</font>，请相关同事注意。\n >类型:<font color=\"comment\">用户反馈</font> \n >普通用户反馈:<font color=\"comment\">117例</font> \n >VIP用户反馈:<font color=\"comment\">15例</font>"
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| msg_source | 必须有，(区分企业微信和钉钉)，dingtalk或者wx |
| web_hook | 必填，机器人的Webhook地址 |
| msg_content | 必须有，消息主体 |
| content | 必须有，markdown内容，最长不超过4096个字节，必须是utf8编码 |
接口调用后返回结果如下：
{
"errcode": 0,
"errmsg": "ok",
"isComplete": 1,
"data": []
}