1. 多IM托管说明
系统使用说明
  • api模块
    • api接入说明
    • api快速入门
      • 如何发送一条消息
      • 通过接口实现群发
      • 加密externalUserId打通方案
      • unionId打通方案
      • 企业级API消息回调签名说明
      • 获取externalUserId和wecomChatid
      • 加密手机号加好友方案
      • 加密版接口
    • api最佳实践
      • 联系人群聊相关最佳实践
      • 消息相关最佳实践
      • AI 课程助手
  • 使用指南
    • 使用指南
      • 如何获取小程序参数
      • 配置报警机器人流程
      • 飞书报警检测配置教程
      • 企微报警机器人配置教程
      • 客户联系权限配置方法
      • 异地登录助手
    • 多IM托管说明
      • 飞书 托管说明
      • 钉钉 托管说明
      • Instagram 托管说明
      • 小红书 托管说明
      • 微信小店 托管说明
      • 微信客服 - 自建应用 托管说明
  1. 多IM托管说明

微信客服 - 自建应用 托管说明

托管说明#

此文档说明了微信客服-自建应用授权托管方式。

托管方式#

本系统提供微信客服自建应用托管方案，只需管理员在本系统后台按照提示绑定应用相关信息即可。

托管前准备#

请准备企微管理后台管理员权限账号

托管流程#

1.
登录本系统，点击【小组管理-托管账号-添加托管账号】
1.png
2.
点击【微信客服-自建应用】，进行托管，请确保企业已完成微信客服-自建应用主体的绑定。
image.png
3.
若已完成微信客服-自建应用的绑定，则会展示所有微信客服账号，点击【添加至此小组】，成功将该员工号托管到本系统。
image.png
4.
若未进行微信客服-自建应用主体的绑定，则需先绑定自建应用，点击【去接入】
image.png

绑定自建应用流程#

1.
前往【企业控制台-配置中心-微信客服-自建应用】，点击【添加自建应用】
image.png

第1步-企业配置#

1.
登录 企业微信管理后台，点击【我的企业-企业信息】，将【企业简称】和【企业ID】回填到本系统的【企业主体】和【企业ID】，点击【下一步】
image.png
image.png
📌
注意：
同一企微的微信客服，不能同时使用三方安装和自建应用。若配置了自建应用微信客服，则三方安装的微信客服将会失效。
同一个自建应用的微信客服不能授权给2个企业，若已授权给本系统的其他企业，则需要前往对应企业进行删除
image.png

第2步-接收消息配置#

Secret配置#

2.
点击【应用管理-应用-自建】，点击【创建应用】，或者选择已有自建应用
image.png
3.
创建自建应用：完成「应用logo」、「应用名称」「可见范围」的填写后，点击【创建应用】
image.png
4.
创建成功后， 点进刚创建的自建应用详情页，找到【Secret】，点击【查看】，在「查看Secret」的弹窗内点击【发送】
image.png
image.png
5.
管理员手机端将收到来自「企业微信团队」的消息通知，点进会话，找到「查看Secret」的系统通知，点击【前往查看】，点击【复制】将Secret回填到本系统
image.png

接收消息配置#

6.
打开 企业微信管理后台，在刚创建的自建应用详情页，找到【功能-接收消息】，点击【设置API接收】，在打开的「API接收消息」页面，分别点击【token】和【EncodingAESKey】的【随机获取】，将获取到的【token】和【EncodingAESKey】回填到本系统
image.png
image.png
image.png
7.
如果该自建应用只用来服务微信客服，则可以将【选择需要接收的消息事件类型】，除了【微信客服消息和事件】，其他都取消勾选
image.png

第3步-自建应用配置#

接收消息URL#

8.
将系统提供的【接收消息URL】填写到 企业微信管理后台 的【URL】处，并点击【保存】
image.png
image.png
如提示 “域名主体校验未通过，需配置备案主体与当前企业主体相同或有关联关系的域名”
请按以下步骤操作：
在与企业主体匹配 / 存在关联关系的备案域名下，搭建转发服务器，并将服务器的 URL，填写到【企微管理后台 - 应用管理 - 自建应用 - 应用详情 - 接收消息 - 设置 API 接收】的 URL 输入框中；
在该转发服务器上，将回调请求转发至地址：{CACC地址}/callback/internal-wxkf/{corpId}
image.png
若提示：openapi 回调地址请求不通过
请检查并核对第二步中的 Token、EncodingAESKey、Secret 是否配置正确。

可信IP配置#

9.
将系统提供的【可信IP】填写到 企业微信管理后台 ，自建应用详情页【企业可信IP-配置】的弹窗内，并点击【下一步】
image.png
image.png
image.png
如提示 “以下IP属于第三方服务商，为保证企业数据安全，请配置本企业服务器的IP”
请按以下步骤操作：
把您企业自有服务器的 IP，填写到【企业微信管理后台 - 应用管理 - 自建应用 - 应用详情 - 开发者接口 - 企业可信 IP】的配置项中；如果填完还是提示该报错，需要联系企业微信官方客服解决。
在这台已配置可信 IP 的企业服务器上，设置请求转发规则，把我方调用企微的所有请求，都转发到企微官方服务器。
最后把该转发服务的使用地址，回填到本页面的对应输入框中即可。
📌
转发配置示例（避免配置错误导致网页解析失败）
举个例子：如果您的转发地址是 https://example.com/wecom/proxy
第一步：把 https://example.com/wecom/proxy 完整填到本页的对应输入框里
第二步：在服务器上配置转发规则，所有带 https://example.com/wecom/proxy/ 前缀的请求，都对应转发到企微官方接口地址。比如 https://example.com/wecom/proxy/a/b/c，就要转发到 https://qyapi.weixin.qq.com/cgi-bin/a/b/c，以此类推。
image.png
image.png

第4步-微信客服配置#

将自建应用授权给微信客服#

10.
点击【应用管理-微信客服】，进入应用详情页，若顶部提示：正在通过微信客服后台管理相关能力，启用后将由此处统一接管用户咨询和客服账号。则需点击【开始使用】
image.png
image.png
11.
点击【API-可调用接口的应用-设置】，在弹窗内，需勾选上刚刚配置的自建应用，点击【确定】保存配置
image.png
image.png
若未找到【可调用接口的应用】，需点击【接收事件服务器-编辑】，找到「接收事件服务器配置」，点击【停用】，弹窗内点击【确定】
image.png
image.png
刷新后，若还未找到【可调用接口的应用】，需点击【Secret-调用记录】点击【停用 secret 】即可
image.png

将微信客服授权给本系统#

12.
在「微信客服」应用详情页，下滑到底部，找到「通过API管理会话消息」点击【企业内部开发】，找到刚刚的自建应用，找到右侧三个点，点击【更换客服账号】，弹窗内勾选需要授权的客服账号，点击【确定】进行保存
image.png
image.png
image.png
13.
配置完成后，在本系统点击【完成配置】，成功添加微信客服的自建应用！
image.png
修改于 2026-04-10 09:22:14
上一页
微信小店 托管说明
Built with