申请试用

① 建一个自建应用

在企业微信管理后台 →「应用管理」→「自建应用」里创建一个应用(名字随你,比如「客户助手」)。

建好后你能看到三样东西:企业 ID(corpid)应用 ID(agentId)应用 Secret。就在下面填好。

其中企业 ID 在管理后台「我的企业 → 企业信息」页的最底部(如图,点击可放大):

企业微信管理后台「我的企业 → 企业信息」页面,最底部「企业 ID」一行已用红框标出

应用 ID 与 Secret 在这个自建应用的详情页里;可见范围要设为全公司,不然侧边栏里看不到(如图,点击可放大):

企业微信管理后台自建应用详情页,红框标出 AgentId、Secret 与可见范围,红字注明可见范围设置为全公司
你的企业微信

⚠️ 应用 ID 我们只能检查你填了没有,没法替你验证对不对(我们调企微的那一步用不到它)。

不同的企业微信后台版本,菜单名字可能不完全一样——以你实际看到的为准

② 把我们加到「企业可信 IP」

在企业微信后台找到「企业可信 IP」设置,把下面这个地址加进去:

47.104.111.6

入口:「应用管理」→「自建」里点开你的应用(按图中 1→2,点击可放大):

企业微信管理后台「应用管理 → 自建」页面,红箭头指向自建应用列表里的「客户助手」

在应用详情页往下找到「开发者接口」→「企业可信 IP」→ 点「配置」,填入上面的地址后点「确定」(按图中 3→5,点击可放大):

企业微信管理后台自建应用详情页,开发者接口里的「企业可信 IP」配置弹窗,已填入 IP 并点确定

不加的话,我们调企微接口会被拒绝(错误码 60020)。

③ 给这个应用开通「客户联系」权限

还是在这个应用的页面上,找到「客户联系」相关的接口权限并开通。

入口在管理后台「客户联系 → 客户」页:右上角「API」→「可调用接口的应用」点「设置」→ 勾选你这个应用 →「确认」(按图中 1→4,点击可放大):

企业微信管理后台「客户联系 → 客户」页面,四步红箭头:右上角 API 按钮、可调用接口的应用点设置、弹窗里勾选应用、点确认

开通日程同步可调用接口:管理后台「协作 → 日程」页 →「可调用接口的应用」点「修改」→ 勾选你这个应用 →「确认」(按图中 1→4,点击可放大):

企业微信管理后台「协作 → 日程」页面,「可调用接口的应用」点修改,弹窗里勾选自建应用后点确认,四步红箭头标注

这一步没开,我们调企微会一路报错(48002),识别客户的接口也拿不到数据。

④ 设置可信域名并上传验证文件

1. 在上面的应用页里,把「可信域名」与「JS 接口安全域名」设成我们给你的那个域名。只写域名本身,不要带协议头、不要带路径。

2. 保存时企微会要求域名归属验证,让你下载一个校验文件WW_verify_ 开头的 .txt)。每家企业的校验文件各不相同,认准你自己下载的那个。

3. 把下载的文件在下面传给我们,我们替你放到域名下:

4. 上传成功后,回到企微后台点「验证 / 确定」完成认证。

⚠️ 最后这一下只能你自己点,我们没法替你验证——点完企微会立刻告诉你通过没通过。没传文件就直接点验证,会提示「文件未部署」。

入口与整条流程都在这张图里(按图中 1→6,点击可放大):

企业微信「设置可信域名」弹窗,红字六步标注:应用管理→点击自建应用→网页授权及JS-SDK点设置→可信域名输入 qywx.wsgjp.cc→下载文件上传→点「验证并通过」确定

⑤ 配置聊天工具栏

在应用页里找到「聊天工具栏」,把侧边栏指向我们给你的地址。你的专属完整地址在下面(企业 ID 填好后自动生成,点「复制」再粘贴过去):

按图中红箭头:应用详情页 →「配置到聊天工具栏」点「配置」→ 页面内容选「自定义」并粘贴上面这条完整地址 → 配置到「客户联系聊天工具栏」→「确定」(点击可放大):

企业微信应用详情页「配置到聊天工具栏」,红箭头标注:功能区点「配置」,弹窗里页面名称填客户助手、页面内容选自定义并填我们给你的域名、配置到选客户联系聊天工具栏,最后点确定

电脑端与手机端要各配一次——只配一边的话,另一边打不开。

⚠️ 这一步我们也没法替你检查,理由同第 ④ 步。

⑥ 填写参数并提交

你的公司
你的管家婆

填好上面四样后点「刷新」,我们从你的服务器取库名供选择(数据库类型会自动识别,不用你选);也可以不刷新、直接手动填。

做过年结的话,往年的经营历程在各自的帐套库里。点「刷新」后在下面勾选要查往年数据的帐套(一个不选也可以),勾选后会自动填到输入框;这些帐套只用于查询往年数据,不作其它用。

这个账号需要有建视图权限:开通时我们会往你的库里创建我们自己的视图与表。若只给只读账号,开通会停在这一步。

提交后,我们会用上面的参数连接你的管家婆数据库,创建我们自己的 txcrm_ 开头的数据表与视图;我们不改动你的任何原始表,也不改动你的账号与密码。点击提交即表示你同意这一点。

如果侧边栏打不开,逐条对一下

  1. 权限:第 ③ 步的「客户联系」权限开没开。
  2. 工具栏:第 ⑤ 步配的是电脑端还是手机端?两边都要配
  3. 可信域名:有没有多写了协议头或路径。
  4. 可信 IP:第 ② 步的 47.104.111.6 加没加。
  5. 可见范围:这个应用的「可见范围」里有没有包含你自己。