企业微信发消息接入与问题排查完整指南

企业微信发消息接入与问题排查完整指南

一、基础概念

1. 三个核心参数

  • CorpID(企业ID):在「我的企业 → 企业信息」中获取
  • Secret(应用密钥):在「应用管理 → 自建应用」中获取
  • AgentId(应用ID):在应用详情页中获取

关系:

企业(CorpID)

├── 应用A(AgentId + Secret)

├── 应用B(AgentId + Secret)


二、发送消息流程

1. 获取 access_token

GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=xxx\&corpsecret=xxx

2. 发送消息

POST https://qyapi.weixin.qq.com/cgi-bin/message/send

示例:

{

"touser": "test_user",

"msgtype": "text",

"agentid": 1000002,

"text": {

"content": "hello"

}

}


三、userId 获取方式

路径:

通讯录 → 成员 → 查看账号

注意:

  • userId = 账号
  • 不是手机号
  • 不是姓名

四、添加测试用户

步骤:

  1. 通讯录 → 添加成员
  2. 填写账号(userId)
  3. 使用手机号登录企业微信
  4. 确保在应用可见范围内

五、常见报错:60020

错误:

not allow to access from your ip

原因:

IP 不在白名单

解决:

应用管理 → 应用 → 开发者接口 → IP白名单


六、服务商应用 vs 自建应用

类型 是否可控
自建应用 ✅ 完全可控
服务商应用 ❌ 很多限制

建议:使用自建应用


七、域名验证说明

用途:

  • 网页授权
  • JS-SDK

不影响:

  • 发消息接口

八、Nginx 配置验证文件

问题

请求被代理导致 502

解决方案

server {

listen 80;

server_name your-domain.com;

复制代码
location = /WW_verify_xxx.txt {
    root /usr/share/nginx/html;
}

location / {
    proxy_pass http://127.0.0.1:8080;
}

}

文件位置

/usr/share/nginx/html/WW_verify_xxx.txt


九、验证步骤

  1. nginx -t
  2. nginx -s reload
  3. 浏览器访问验证文件

十、总结

  • 发消息核心:CorpID + Secret + AgentId + userId
  • 60020 = IP白名单问题
  • 域名验证与发消息无关
  • Nginx需避免代理验证文件
相关推荐
千舟软件6 天前
报修系统对接企业微信和钉钉的3种方式_千舟报修云
服务器·钉钉·企业微信
金融Tech趋势派11 天前
企业微信客户管理工具哪个好?按企业规模、行业与合规要求的三层判断标准
人工智能·企业微信
知之AI12 天前
桌面 RPA 入门:企业微信日常流程怎么拆、怎么选型(2026)
企业微信·rpa·选型·流程自动化·桌面自动化
超级新零售14 天前
服装订货会数字化:商品版本、订单状态与后续配发数据如何衔接?
大数据·小程序·企业微信
adrninistrat0r17 天前
通过企业微信消息向脚本传递短信验证码、Token 等信息
企业微信
昵称画18 天前
图文:一张十年前的车间系统架构图
低代码·系统架构·php·企业微信·rxjava·零售
字节跳动的猫19 天前
LikeShop 企业微信客服二开:消息同步、客户标签打通与社群引流
企业微信·客服管理·人工客服
极客互动API20 天前
【极客互动】企业微信外部群聊机器人开发实战与效果验证
微信·机器人·企业微信·企微scrm·企业微信api·企微外部联系人
金融Tech趋势派23 天前
企业微信SCRM多少钱一年?2026收费标准拆解与预算自算表
大数据·企业微信
weixin_4935036723 天前
商协会系统对接企业微信:通讯录同步实战
企业微信