0先准备好两样东西
确认你现在能用管理员身份登录企业微信后台。
- 一台电脑,用管理员的微信扫码登录。
- 一个另一个微信号(你自己的小号、家人都行),等会儿用来当"客户"发测试消息。
必须是企业管理员权限。不是管理员的话,Secret 你看不到、回调也保存不了,得让管理员来点。
1登录企业微信后台,拿「企业ID」
目标:复制一串以 ww 或 wp 开头的字符串。
- 用电脑浏览器打开下面这个网址,微信扫码登录:
① 打开企业微信管理后台 ↗
- 左边菜单最下面,点 「我的企业」 → 「企业信息」。
- 把页面拉到最底部,能看到 「企业ID」,右边一串字符。
- 点旁边的复制,粘到下面这个框里:
找不到?页面拉到底。如果只看到「企业信息」没有企业ID,说明你不是管理员,换管理员账号登录。
2创建/确认一个「微信客服账号」,拿到客服账号ID
目标:拿到一串 wk 开头的客服账号 ID。
- 还是在企业微信管理后台,左边菜单找 「微信客服」(有的版本在「应用管理」下面)。
- 点进去,看有没有客服账号:
- 有 → 直接点开它。
- 没有 → 点 「创建客服账号」,名字随便起,比如
测试客服,头像随便传。
- 点开这个客服账号,页面上会显示 客服账号ID(wk 开头),复制它。
⚠️ 请务必新建一个专门测试的客服账号,不要用正在接待真实客户的那个。测试阶段可能会乱回消息。
3开启 API,拿到「微信客服 Secret」
目标:拿到一串很长的 Secret(这一步必须管理员,且要在手机上看)。
- 在 微信客服 页面里,找到 「API」 区域(有的版本在页面下方 / 右侧「开发配置」)。
- 点 「开启 API」(如果已开启就跳过)。
- 找到 Secret,点 「查看」。
- 这时它会提示"已发送到企业微信"——拿起手机,打开企业微信,在「微信客服」/ 后台通知里看到这串 Secret,复制出来。
- 粘到下面:
⚠️ 注意:这里是「微信客服」专属的 Secret,不是自建应用的 Secret,也不是通讯录同步的 Secret。拿错了后面会报 40001 / invalid credential。
6用另一个微信号发一条测试消息
目标:验证真的能收到 → 真的能回复 → 真的留下了记录。
- 回到企业微信 微信客服 → 点开你那个客服账号 → 找 「客服链接」/「接入链接」,复制那个链接(或保存二维码)。
- 把链接发到另一个微信号(用文件传输助手发过去,在手机上点开)。
- 用那个微信号在会话里发:
测试收发
- 等 3~10 秒,那个微信号应该收到自动回复:「已收到测试消息」。
如果超过 30 秒还没收到,点上面「检查一下」。一般会显示三种情况之一:
① 一条回调都没收到 → 回调没配通,回第 4 步检查密钥是否一致;
② 收到回调但发送失败 → 通常是 Secret 拿错或客服账号ID填错;
③ 发送成功但微信没收到 → 检查是不是发到了别的客服账号。
最后一步:企业可信IP(如果后台要求填)
有些企业的微信客服后台要求配置"企业可信IP",不填的话接口会报 60020 not allow to access from your ip。
拿到 IP 后,在企业微信后台 → 微信客服 → API → 企业可信IP 里加进去。
如果这个 IP 会变(云服务的出口 IP 有可能不固定),那需要换成固定 IP 方案,到时我再给你方案。