获取令牌并发送内部应用通知

按企业自建应用身份，给一位在可见范围内的成员发送文本通知。

官方资料核对 2026-10-15示例代码，未进行真实接口实测

接入准备

管理员创建并启用企业自建应用，配置应用可见范围。
接收成员需要在应用可见范围内，并具有相应基础接口许可；不是只要知道 userid 就能发送。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。

WECOM_CORP_ID: 企业 ID。
WECOM_CORP_SECRET: 当前自建应用 Secret。
WECOM_ACCESS_TOKEN: 下面获取令牌操作的 access_token；必须与 AgentId 对应同一应用。

export WECOM_CORP_ID='ww_replace_with_corp_id'
export WECOM_CORP_SECRET='replace_with_app_secret'
export WECOM_ACCESS_TOKEN='replace_with_app_access_token'

以上 export 适用于 macOS / Linux 的终端，在同一终端内运行后续代码。Python 示例保存为 request.py 后执行 python3 request.py。

调用步骤

01
管理后台 → 应用管理 → 当前自建应用取得 AgentId 和 Secret；在我的企业取得企业 ID。
02
先换取令牌，将响应 access_token 保存到 WECOM_ACCESS_TOKEN。
03
把示例 body 的 agentid 整数和 touser 用户账号替换为本企业真实值。
04
执行发送；即使 errcode=0，也要查看 invaliduser、invalidparty、invalidtag、unlicenseduser，不能把部分成功当全员送达。

调用 01

获取应用 access_token

自建应用按企业 ID 与该应用 Secret 换取凭证；避免把带密钥的请求 URL 写入访问日志。

GEThttps://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${WECOM_CORP_ID}&corpsecret=${WECOM_CORP_SECRET}

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置	类型 / 必填	说明
`corpid`Query	string必填	管理后台 → 我的企业中的企业 ID，不是 AgentId。
`corpsecret`Query	string必填	管理后台 → 应用管理 → 当前自建应用的 Secret；不能混用通讯录同步 Secret。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request GET \
  --url "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${WECOM_CORP_ID}&corpsecret=${WECOM_CORP_SECRET}"

import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${WECOM_CORP_ID}&corpsecret=${WECOM_CORP_SECRET}")
headers = {

}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
if isinstance(result, dict) and "errcode" in result and result["errcode"] != 0:
    raise SystemExit("平台返回业务错误，请结合下方排错说明检查响应")

// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${WECOM_CORP_ID}&corpsecret=${WECOM_CORP_SECRET}");
const headers = Object.fromEntries(
  Object.entries({}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
  method: "GET",
  headers,
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
if (Object.hasOwn(result, "errcode") && result["errcode"] !== 0) {
  throw new Error('平台返回业务错误，请结合下方排错说明检查响应');
}

返回示例

按官方字段整理的节选示意，使用虚构 ID，不是实测结果。把 access_token 保存到 WECOM_ACCESS_TOKEN。以下为结构示意，非本站实测结果。

{
  "errcode": 0,
  "errmsg": "ok",
  "access_token": "replace_with_returned_token",
  "expires_in": 7200
}

常见错误与排查

errcode 非 0获取凭证失败: 按 errmsg 检查企业 ID、Secret、应用启用状态与后台安全设置。

调用注意

按 expires_in 缓存，正常 7200 秒；不同应用分别缓存，失效时重新取得。
调用必须从服务端发起；后台要求可信 IP 时，使用实际服务器出口 IP。

获取 access_token

调用 02

发送文本应用消息

执行会向 touser 指定成员的应用会话发送消息，本例不使用 @all。

POSThttps://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${WECOM_ACCESS_TOKEN}

请求头

Content-Type: application/json

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置	类型 / 必填	说明
`access_token`Query	string必填	本应用 access_token。
`touser`请求体	string必填	本示例必填；多个 userid 用 \| 分隔，最多 1000 个。API 也支持 toparty/totag，但至少需指定一种接收对象。
`agentid`请求体	integer必填	当前应用 AgentId，示例 1000002 是假值，务必替换。
`msgtype`请求体	string必填	本例 text。
`text.content`请求体	string必填	文本内容，最长 2048 字节，UTF-8。
`enable_duplicate_check`请求体	integer可选	0 关闭、1 开启；默认 0。本例在窗口内检查重复消息。
`duplicate_check_interval`请求体	integer可选	重复检查窗口，单位秒；默认 1800，最多 4 小时；本例 600。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

cat > request-body.json <<'JSON'
{
  "touser": "replace_with_member_userid",
  "msgtype": "text",
  "agentid": 1000002,
  "text": {
    "content": "接入测试：应用通知已启动"
  },
  "enable_duplicate_check": 1,
  "duplicate_check_interval": 600
}
JSON

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${WECOM_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-binary @request-body.json

import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${WECOM_ACCESS_TOKEN}")
headers = {
    "Content-Type": expand("application/json"),
}
body = {
    "touser": "replace_with_member_userid",
    "msgtype": "text",
    "agentid": 1000002,
    "text": {
        "content": "接入测试：应用通知已启动",
    },
    "enable_duplicate_check": 1,
    "duplicate_check_interval": 600,
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
if isinstance(result, dict) and "errcode" in result and result["errcode"] != 0:
    raise SystemExit("平台返回业务错误，请结合下方排错说明检查响应")

// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${WECOM_ACCESS_TOKEN}");
const headers = Object.fromEntries(
  Object.entries({
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "touser": "replace_with_member_userid",
  "msgtype": "text",
  "agentid": 1000002,
  "text": {
    "content": "接入测试：应用通知已启动"
  },
  "enable_duplicate_check": 1,
  "duplicate_check_interval": 600
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
if (Object.hasOwn(result, "errcode") && result["errcode"] !== 0) {
  throw new Error('平台返回业务错误，请结合下方排错说明检查响应');
}

返回示例

按官方字段整理的节选示意，使用虚构 ID，不是实测结果。保留 msgid 用于后续撤回；同时检查无效和无许可成员列表。以下为结构示意，非本站实测结果。

{
  "errcode": 0,
  "errmsg": "ok",
  "invaliduser": "",
  "invalidparty": "",
  "invalidtag": "",
  "unlicenseduser": "",
  "msgid": "example_message_id"
}

常见错误与排查

81013全部接收人无权限或不存在: 核对应用可见范围、userid 与成员的基础接口许可。
invaliduser / unlicenseduser 非空部分成员未成功接收: 分别处理不存在/不可见成员与无接口许可成员，不要把整体 errcode=0 当全部成功。

调用注意

应用通知不等于向普通员工私聊发消息，不能读取员工之间的聊天。
重复检查会影响相同测试正文的再次发送；新业务消息应有可区分内容。

发送应用消息

注意事项

每个应用的 Secret、Token、AgentId 一一对应；不能用群 Webhook key 调用本接口。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

01
获取 access_token核验日期 2026-10-15
02
发送应用消息核验日期 2026-10-15

企业微信的其他调用手册

向群推送文本通知读取授权部门的成员列表

← 返回企业微信的全部功能