① 建一个自建应用
在企业微信管理后台 →「应用管理」→「自建应用」里创建一个应用(名字随你,比如「客户助手」)。
建好后你能看到三样东西:企业 ID(corpid)、应用 ID(agentId)、应用 Secret。就在下面填好。
其中企业 ID 在管理后台「我的企业 → 企业信息」页的最底部(如图,点击可放大):
应用 ID 与 Secret 在这个自建应用的详情页里;可见范围要设为全公司,不然侧边栏里看不到(如图,点击可放大):
不同的企业微信后台版本,菜单名字可能不完全一样——以你实际看到的为准。
② 把我们加到「企业可信 IP」
在企业微信后台找到「企业可信 IP」设置,把下面这个地址加进去:
47.104.111.6
入口:「应用管理」→「自建」里点开你的应用(按图中 1→2,点击可放大):
在应用详情页往下找到「开发者接口」→「企业可信 IP」→ 点「配置」,填入上面的地址后点「确定」(按图中 3→5,点击可放大):
不加的话,我们调企微接口会被拒绝(错误码 60020)。
③ 给这个应用开通「客户联系」权限
还是在这个应用的页面上,找到「客户联系」相关的接口权限并开通。
入口在管理后台「客户联系 → 客户」页:右上角「API」→「可调用接口的应用」点「设置」→ 勾选你这个应用 →「确认」(按图中 1→4,点击可放大):
开通日程同步可调用接口:管理后台「协作 → 日程」页 →「可调用接口的应用」点「修改」→ 勾选你这个应用 →「确认」(按图中 1→4,点击可放大):
这一步没开,我们调企微会一路报错(48002),识别客户的接口也拿不到数据。
④ 设置可信域名并上传验证文件
1. 在上面的应用页里,把「可信域名」与「JS 接口安全域名」设成我们给你的那个域名。只写域名本身,不要带协议头、不要带路径。
2. 保存时企微会要求域名归属验证,让你下载一个校验文件(WW_verify_ 开头的 .txt)。每家企业的校验文件各不相同,认准你自己下载的那个。
3. 把下载的文件在下面传给我们,我们替你放到域名下:
4. 上传成功后,回到企微后台点「验证 / 确定」完成认证。
⚠️ 最后这一下只能你自己点,我们没法替你验证——点完企微会立刻告诉你通过没通过。没传文件就直接点验证,会提示「文件未部署」。
入口与整条流程都在这张图里(按图中 1→6,点击可放大):
⑤ 配置聊天工具栏
在应用页里找到「聊天工具栏」,把侧边栏指向我们给你的地址。你的专属完整地址在下面(企业 ID 填好后自动生成,点「复制」再粘贴过去):
按图中红箭头:应用详情页 →「配置到聊天工具栏」点「配置」→ 页面内容选「自定义」并粘贴上面这条完整地址 → 配置到「客户联系聊天工具栏」→「确定」(点击可放大):
电脑端与手机端要各配一次——只配一边的话,另一边打不开。
⚠️ 这一步我们也没法替你检查,理由同第 ④ 步。
⑥ 填写参数并提交
如果侧边栏打不开,逐条对一下
- 权限:第 ③ 步的「客户联系」权限开没开。
- 工具栏:第 ⑤ 步配的是电脑端还是手机端?两边都要配。
- 可信域名:有没有多写了协议头或路径。
- 可信 IP:第 ② 步的 47.104.111.6 加没加。
- 可见范围:这个应用的「可见范围」里有没有包含你自己。