You need to enable JavaScript to run this app.
导航

企业微信(自建应用)数据连接

最近更新时间2023.09.14 16:57:13

首次发布时间2023.06.27 11:55:10

1. 产品概述

企业微信自建应用是指企业在企业微信后台自主创建一个应用并以此应用调用企业微信接口的方式,这种方式比企业微信代开发应用(扫码授权形式)有更高的权限,可以执行更多动作。

2. 使用限制
  • 使用者需具有「项目中心」-「权限」-「按内容管理」-「模块」-「新建数据连接」的权限

  • 使用者需自行在企业微信后台创建应用,并获取该应用的企业ID、应用ID、应用secret

3. 操作步骤

企业微信侧自建应用

进入企业微信官网 https://work.weixin.qq.com/ ,点击企业登录,扫描登录

进入企业微信,点击应用管理,创建应用

填写应用logo,应用名称,选择可见范围(可见范围选择之后,后续拉取数据时只能拉取到可见范围内部门及成员的信息,需要根据实际需求进行配置)



在【应用管理】-【网页授权及 JS-SDK】,点击【设置可信域名】,可信域名的备案主体和当前企业微信的主体相同或者有关联关系

说明:可信域名需配置备案主体与当前企业主体相同或有关联关系的域名,需要客户方提供,企业内部开发配置域名指引链接https://open.work.weixin.qq.com/wwopen/common/readDocument/40754
配置可信IP

说明:企业可信 ip配置,仅所配ip可以通过接口获取企业数据,需客户方提供;如果未预先配置,出现如下报错提示后,手动添加
==>此处需要配置私有化部署的provider服务的出口ip,否则在页面填写应用信息后,校验时会出现如下报错;
解决方式:将错误提示中的ip配置在应用的可信ip中

{"errcode":60020,
"errmsg":"not allow to access from your ip, hint: [1685606004431492806164561],
 from ip: 180.184.93.41, 
 more info at https://open.work.weixin.qq.com/devtool/query?e=60020"}

配置客户联系

说明:如未配置客户联系则无法拉取到客户详情,客户群详情以及企业标签信息

获取客户详情中的union_id字段,需要进行如下操作绑定微信开放平台账户
登录企业管理后台,点击客户与上下游 - 客户联系 -客户 - 微信开发者ID,绑定微信公众号或小程序,绑定的公众号或小程序主体需与企业微信主体一致

corpId,agentId,secret查询位置

选择数据连接

  1. 点击 数据融合>数据连接

  2. 点击 新建连接 并选择 企业微信 (自建)

  1. 点击授权,在弹窗中填写企业ID、应用ID、应用secret

  1. 授权完成后,当前数据连接页面将显示 授权成功


注意

  • 授权成功后,不支持在CDP界面取消授权。

  • 客户可以在企业微信后台取消授权,取消后CDP侧的授权状态将变更为尚未完成授权

  • 二次授权仅支持和原企业微信账号一致

一键创建数据集

  1. 在CDP数据连接页面,点击 一键创建数据集 后,接入的数据将自动生成对应数据集。 点击页面右上角 查看数据集 支持跳转到数据集页面查看详情,包括原始数据和结构化数据。



完成数据准备

需要的表名如下:

序号源表名需要制作成的目标表名
1企业微信1011_企微客户详情原始数据微信客户详情
2企业微信数据连接1228_企业标签原始数据
3企业微信1011_企微客户群详情原始数据客户群详情
4企业微信1011_企微部门列表原始数据部门成员详情
5企业微信1011_企微部门成员原始数据
6新建实时可视化任务GMP群标签任务

注意
批量接口获取客户详情时只有标签id没有标签名称,所以会传一个标签表,关联获取名称
数据说明

  • 表名是动态改变的,需要使用最新的表进行制作,其中1011代表时间即10月11日,这个是可以改变的。

  • 前两张表里因为数据是json字符串的格式,所以需要进行简单的处理后再使用。

  • 第三&四张表需要联合使用,因为一个部门会有很多成员,将两张表联合起来制作成一张表,供后续使用。