发送企业微信群消息 API

开始使用前,请先创建应用,申请开通短信邮件服务。

请求

POST https://apigate.glodon.com/colibri/api/qywx

说明

::: tip 注意
发送频率限制:每个机器人发送的消息不能超过20条/分钟。
:::

header 参数

参数名必选类型描述
AuthorizationStringBearer app_access_token. 注:该 access_token 是应用级别
Content-TypeStringapplication/json

body 参数

参数名必选类型描述
msgtypeString消息类型,text/markdown 可选
contentString当msgtype=text是,此为文本内容,最长不超过2048个字节,必须是utf8编码;当msgtype=markdown时,此为markdown内容,最长不超过4096个字节,必须是utf8编码
robotKeyString群机器人的id key.假设webhook是:https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa,则该值为 693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

::: tip 注意
目前支持的markdown语法是如下的子集:
####1.标题 (支持1至6级标题,注意#与文字中间要有空格)

# 标题一
## 标题二
### 标题三
#### 标题四
##### 标题五
###### 标题六

2.加粗

**bold**

3.行内代码段(暂不支持跨行)

`code`

4.链接

[这是一个链接](https://aecore.glodon.com/doc)

5.引用

> 引用文字

6.字体颜色(只支持3种内置颜色)

<font color="info">绿色</font>
<font color="comment">灰色</font>
<font color="warning">橙红色</font>

:::

body 参数示例

{
	"robotKey":"693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa",
	"msgtype": "text",
	"text": {
		"content": "hello world"
	}
}
或者
{
	"robotKey":"693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa",
	"msgtype": "markdown",
    "markdown": {
        "content": "实时新增用户反馈<font color=\"warning\">132例</font>,请相关同事注意。\n
         >类型:<font color=\"comment\">用户反馈</font>
         >普通用户反馈:<font color=\"comment\">117例</font>
         >VIP用户反馈:<font color=\"comment\">15例</font>"
    }
}

响应

HTTP 代码说明类型
200ok请求成功,根据业务 code 解析实际结果
401invalid_token请求头里面的 accessToken 无效
600业务异常业务异常

HTTP 请求示例

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n\"robotKey\":\"693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa\",\n\"msgtype\": \"text\",\n    \"text\": {\n        \"content\": \"北京今日天气:29度,大部分多云,降雨概率:60%\" }\n}");
Request request = new Request.Builder()
  .url("https://apigate.glodon.com/colibri/api/qywx")
  .post(body)
  .addHeader("authorization", "bearer cn-110xxxxx-caa9-4237-b8c2-0df1af4xxxxx")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();
curl -X POST \
  https://apigate.glodon.com/colibri/api/qywx \
  -H 'authorization: bearer cn-110xxxxx-caa9-4237-b8c2-0df1af4xxxxx' \
  -H 'content-type: application/json' \
  -d '{
"robotKey":"693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa",
"msgtype": "text",
    "text": {
        "content": "北京今日天气:29度,大部分多云,降雨概率:60%"
    }
}'

成功返回结果

{
  "code": 40000,
  "error": "OK",
  "description": "OK"
}

异常返回结果

{"code":40100,"error":"colibri.unauthorized","description":"认证失败"}
{"code":40200,"error":"colibri.oauth.scope.error","description":"没有分配权限"}
{"code":40202,"error":"colibri.invalid.template.id","description":"无效的模板ID"}
{ "error": "invalid_token", "error_description": "cn-24b92d2f-66cc-45d2-8e8b-e08916bca2d62"}