• EN

企业微信集成

作者:eteams2025-01-23 13:44

、概述


支持与企业微信系统集成,包括“通讯录同步”“应用集成到企业微信"”消息互通“,即实现在企业微信上使用我们的应用,包括推送消息。


、操作说明


    1. 企业集成

    2. 应用集成

       2.1 企业微信管理后台创建应用

       2.2 可信域名校验

       2.3 云桥集成应用

       2.4 配置应用菜单

       2.5 构造免登链接

    3. 消息推送

       3.1 消息规则配置

       3.1.1 文字

       3.1.2 图文

       3.1.3 文本卡片

       3.1.4 模板卡片

       3.2 消息撤回

    4. 通讯录同步

       4.1 前提

       4.2 同步功能相关配置

           4.2.1 从企业微信同步组织用户绑定

           4.2.2 是否同步到OA

           4.2.3 同步通讯录到企业微信

           4.2.4 用户绑定/解绑

        4.3 同步功能使用说明

           4.3.1 以企业微信组织架构为准

           4.3.2 以OA组织架构为准

                4.3.2.1 企业微信没有组织架构

                4.3.2.2 企业微信有组织架构

            4.3.3 其他注意事项

      5. 考勤同步

      6. 扫码登录

      7. 客户管理

         7.1 功能配置

         7.2 外部联系人列表

            7.2.1 外部联系人手动同步

            7.2.2 外部联系人自动同步

       8. 消息存档

       9. 其他功能说明

          9.1 企业微信-聊天工具栏+工具栏配置

          9.2 更多设置

            

【云桥对外域名】配置

     集成企业微信需要配置外网域名地址,在【云桥】-【基础参数设置】配置当前系统的外网域名地址,配置好之后点击保存;


 

注意:

1. 若用户集成的是私有化部署的企业微信,不强制要求开通外网域名,云桥外网地址可以直接填写当前私有化系统的内网IP地址;

2.若用户集成的非私有化部署的企业微信,需要开通外网域名。


【开通服务器网络权限的说明】

1.如果使用本系统进行企业微信集成功能,则需要调用企业微信接口,并且最终用户是通过企业微信来使用集成的功能,所以本系统部署的云桥服务器必须要求,能够访问外网:即开通这台服务器的上网权限,让云桥服务器能够访问互联网,如果贵公司对网络安全要求较高,至少需要让这个服务器能够访问以下地址:
企业微信API:https://qyapi.weixin.qq.com
(如果是政务微信,需要把qyapi.weixin.qq.com换成政务微信的服务地址)
2.同时请网络管理员将本系统的访问地址映射到外网。
3.可以用如下方式验证网络是否通畅:
企业微信(如果是政务微信,需要把qyapi.weixin.qq.com换成政务微信的服务地址测试)
在云桥服务器上按如下方式检查网络:
ping qyapi.weixin.qq.com 查看是否能ping通
Windows:
浏览器访问 https://qyapi.weixin.qq.com/cgi-bin/gettoken 查看是否有返回结果
Linux:
执行命令 curl https://qyapi.weixin.qq.com/cgi-bin/gettoken 查看是否有返回结果


1. 企业集成

    企业微信接入功能主要是在云桥中建立企业微信接入信息,将基本的企业CorpID等写入云桥中;

① 点击后台管理中心,在所有服务中选择云桥或者平台引擎里点击云桥,即可进入云桥页面,如下图所示:



② 访问【企业微信集成】菜单,点击右上角【新建企业微信】,如下图所示:



 

③ 输入企业名称以及企业corpid,如下图所示:



 

④ 其中CorpID获取方式:请登录企业微信管理后台https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome,在【我的企业】获取CorpID,如下图:


 


注意:私有化部署的企业微信,需要修改API服务地址!!!




2. 应用集成

2.1企业微信管理后台创建应用

① 请登录企业微信管理后台https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome,进入【应用管理】,点击【创建应用】,如下图:



 

② 创建应用后,即可获取到AgentID、Secret,如下图所示:



 

2.2可信域名校验

注意:2.2点可信域名校验是对非私有化企业微信域名校验的说明。

私有化部署的企业微信对域名不做强制要求!!!可跳过该步骤!!!若需要校验网页授权及JS-SDK可参考:https://yq.weaver.com.cn/eb/qa/view/#/question/bb1f037fdda54d35980f8bd0af335437


① 访问当前集成的企业微信团队,点击【基础信息设置】,打开企业微信基础设置页面,获取可信域名;

 


 

② 将域名配置到企业微信管理后台对应的应用网页授权及JS-SDK 中:访问企业微信管理后台-【应用管理】,找到对应的应用,点击【网页授权及JS-SDK】中的【设置可信域名】 ;


 

③ 在可信域名中填写第一点复制过来的外网域名,填写完成之后,点击【申请校验域名】,具体填写格式说明可参 https://yq.weaver.com.cn/eb/qa/view/#/question/7e60e7cbf03b45779ff6ef4b481b2868 的  第2 点。




 

④ 下载界面上的txt文件;


 

⑤ 在当前企业微信团队【基本设置】页面,上传第四点下载的txt 文件;



 

⑥ 文件上传后,点击确定;


2.2.1 企业微信域名校验常见问题

请点击此链接查看:https://yq.weaver.com.cn/eb/qa/view/#/question/7e60e7cbf03b45779ff6ef4b481b2868

2.3云桥集成应用

① 访问云桥【企业微信集成】,在当前集成的企业微信页面,点击【添加应用】,如下图:



 

② 进入应用详情页面,填写企业微信应用的应用名称、AgentID、Secret【步骤2.1中获取到的应用信息】,如下图:



 

③ 配置应用的企业可信IP:在应用详情页可以复制公网IP



 

④ 访问企业微信管理后台-【应用管理】,找到对应的应用;



 

⑤ 在具体应用-【开发者接口】-【企业可信IP】中填写上刚刚复制的公网ip;



 

⑥ 应用主页 是设置企业微信应用的主页功能,调用模块默认为打开应用,选择应用中心已经存在的主页型应用,如下图所示:



 

        也支持自定义链接地址,如下图:


 



2.4配置应用菜单

用户可以根据需求,设置菜单地址,设置完成后,点击保存,会自动发布到企业微信管理后台的应用菜单里:




发布到企业微信管理后台的效果:




企业微信端实现的功能效果:





 若没有自动发布到企业微信,可以根据以下方法手动将菜单配置到企业微信:先复制出菜单地址





将复制的菜单地址配置到企业微信:访问企业微信管理后台https://work.weixin.qq.com/wework_admin/loginpage_wx,找到对应的应用,设置应用菜单;






2.5构造免登链接   

需求背景:用户需要在企业微信端免登打开OA的业务地址,例如流程、表单、文档等,可以通过在OA业务地址后面加上云桥的单点参数来实现。 

云桥单点参数格式如下: 

wea_link_keep_ebAgentKey=需要替换成实际的应用参数&wea_link_keep_ebCorpKey=需要替换成实际的企业参数&wea_link_keep_ebTenantKey=需要替换实际的租户识别码 



例如:wea_link_keep_ebAgentKey=830265179035746304&wea_link_keep_ebCorpKey=783254141977542657&wea_link_keep_ebTenantKey=to74i5mdhw

直接在需要打开的OA地址后面加上参数即可:

http://testpg.test.eteamswork.cn/sp/workflow/flowpage/fullView/871109798170779649?secondEmpId=775003999577841665&requestId=871109798170779649&wea_link_keep_ebAgentKey=830265179035746304&wea_link_keep_ebCorpKey=783254141977542657&wea_link_keep_ebTenantKey=to74i5mdhw




例如,不是 通过云桥推送的公告消息,里面的放了E10的文档附件链接,需要能在企业微信免登打开;

将构造的带云桥单点参数的链接地址,放到公告消息附件链接里面,点击附件,实现在企业微信免登打开:




例如, 在流程表单中插入二维码,可以通过企业微信的扫一扫功能扫描二维码直接打开流程表单;

将构造的带云桥单点参数的链接地址,放到二维码链接里面,即可实现:





3. 消息推送

3.1消息规则配置

    消息管理功能主要是将OA应用消息推送到企业微信中,即实现在企业微信中接收并处理业务系统的消息。消息正常推送的前提是,企业微信用户要关联OA系统用户账号。

① 在【云桥】-【消息推送设置】-【消息推送规则】 页面,点击新建,如下图所示:



 

② 例如将 日报 的消息推送到企业微信:填写好规则名称,消息来源选择日报,如下图所示:




 

    在规则详情页面,点击【新建】,设置推送目标,第三方企业类型选择【企业微信】,企业和应用根据实际需要,选择对应的企业团队和应用,如下图所示:




 

    消息类型有:文字、图文、文本卡片、模板卡片,可以根据需求选择相应的消息类型,效果见3.2消息类型示例;



 

    注意:推送目标新建之后,要点击【保存】,如下图所示:




 

    消息推送规则新建之后,可以点击【编辑】按钮,对规则详情进行编辑,如下图所示:





 

③  日报 的消息推送到企业微信:除了第二点中所述将消息来源选择日报之外,还可以将消息来源选择为全部,如下图所示:




 

    注意:若消息来源选择全部,OA其他应用的消息(例如审批,出勤等)也会通过这条消息推送规则推送到企业微信。



3.1.1 文字

① 消息推送规则设置,消息类型选择【文字】消息:




① 文字消息内容默认推送消息标题,也可以根据需求自定义推送




注意:文字消息内容必填,不支持清空




3.1.2 图文

消息推送规则设置,消息类型选择【图文】消息:




云桥上传了图片:





云桥没有上传图片:




图文消息标题必填,不支持置为空值:




手动清空保存还是会默认带出标题:




图文消息内容可以根据需要选择置为空值:




注意:业务模块有图片,默认优先展示业务图片;若业务模块没有图片,默认展示云桥设置的图片。


3.1.3 文本卡片

消息推送规则设置,消息类型选择【文本卡片】消息:




默认推送消息标题,内容和按钮:



消息标题不支持置为空值,手动清空保存还是会默认带出标题:




内容支持置为空值: 



① 按钮支持自定义【按钮文本不能超过4个字符 】:




3.1.4 模板卡片

① 消息推送规则设置,消息类型选择【模板卡片】消息:


 

② 企业微信回调配置,将云桥中消息推送目标应用的回调地址填写至企业微信对应应用中:


 

    在企业微信后台找到推送目标应用,点击【设置API接收】:


 

    URLTokenEncodingAESKey复制填写到企微,保存即可:



模块卡片消息示例:

消息到达:


审批后效果:



退回消息:


 

③ 注意事项:

    需要在流程工作流设置中开启【消息入口显示操作按钮】,如不开启则不会有快捷审批按钮:


 

 

    需要推送模板卡片类型的消息,必须保证推送的消息是【待办】类型的 (工作流程只有 待处理流程、退回流程、抄送流程、转发流程、传阅流程、意见征询流程  这几个事件的消息支持待办, 其他的提醒反馈、催办等消息是不支持待办的),否则会推送失败。


 3.2消息撤回

① 可以在云桥消息推送日志里,找到对应的消息推送记录,点击撤回,即可撤回推送到企业微信的消息:



 

② 也可以在消息中心【消息推送设置】-【推送日志】里,找到对应的消息推送记录,点击撤回:




 

③ 撤回示例:



 

注意:企业微信消息仅支持撤回24小时内推送的消息。




4. 通讯录同步

4.1前提

    云桥组织架构同步分三种:

①  企业微信 的组织架构同步到 云桥(不修改OA的组织架构)



 

②  企业微信 的组织结构同步到 云桥 同时同步到OA(修改OA的组织架构)



 

③ OA 的组织架构同步到 云桥,同时同步到 企业微信(默认在同步前会先执行从企业微信同步组织用户绑定关系,以保证从OA同步的时候正确比对用户和部门信息


 

4.2同步功能相关配置

① 执行同步前,需要已经集成过对应应用;



 

② 进入【通讯录管理】,未进行过配置,在执行【从企业微信同步组织用户绑定关系】时,首先会提示配置【接口参数设置】,切换到【接口参数设置】页面,选择集成的应用,点击保存;

注意:选择的应用,在企业微信管理后台对应应用的可见范围必须包含部门,不能只单独选择用户!!!

【从企业微信同步组织用户绑定关系】同步的部门和用户范围,就是所选择应用的应用可见范围!!!





 

接口权限-只读:只能执行【从企业微信同步组织用户绑定关系】同步到云桥,不能在云桥通讯录调整数据,一切以企业号的组织架构为准;

选择应用:选择同步依赖的应用;



 

接口权限-读写:需要配置通讯录密钥(填写企业微信管理后台【管理工具】-【通讯录同步】中的Secre ),可以执行【从企业微信同步组织用户绑定关系】同步到云桥,也可以执行【同步通讯录到企业微信】;

注意:通过通讯录密钥获取企业微信通讯录部门和人员信息,需要配置企业可信IP,操作如下;



 

4.2.1 从企业微信同步组织用户绑定关系


 

新用户关联系统:设置本次同步过来的新成员(即云桥中不存在关联关系员)是否要自动建立与OA组织架构中用户的关联关系。具体使用见4.3.1章节

是否定时同步:定时任务,开启可执行定时从企业微信同步组织架构。

4.2.2是否同步到OA



 

    是否同步到OA:总开关,决定是否将云桥本地的数据同步到E10组织架构,默认关闭

具体可参考:从云桥同步到E10

4.2.3同步通讯录到企业微信

① 基本设置



 

顶级部门:执行【同步通讯录到企业微信】,会将选择的部门以及用户,挂载到选择的顶级部门下面;

新用户是否添加到企业微信:设置从OA同步过来的新成员是否要调用企业微信接口自动创建到企业微信通讯录中;

新用户是否邀请加入:设置从OA同步过来的新成员是否要调用企业微信接口发送邀请加入该团队的信息;

用户所在部门是否包含兼职部门:默认只同步用户的主部门,开启后,同步范围中包含用户的兼职部门,则会同步到企业微信;

用户所在部门是否完全以本系统为准:

当用户在企业微信端所在的部门存在多个时:例如,用户在企业微信端在部门AB下,而在系统端在部门C下,如果选是,同步效果就是该用户在企业微信端只在部门C下;如果选否,同步效果就是该用户在企业微信端同时在ABC三个部门下;

当用户在企业微信端所在的部门只有一个时:不受此配置控制,同步效果始终以系统为准;

离职用户处理方式:禁用表示ecology中的离职用户将在企业微信中被设置为禁用状态,即此用户将禁止使用企业微信但通讯录中还可以查询到此用户并会占有企业微信后台的用户数量;删除表示离职用户将从企业微信中删除,通讯录中不在有此用户,不占用企业微信后台的用户数,需要注意删除后此用户在企业微信中此企业下的消息记录即企业微信自身业务功能的数据也将被删除,即删除后重新添加此用户将是一条新的成员数据,历史数据都将消失,为了避免误操作,建议此处选择禁用模式

禁用用户几天后删除 :默认不填即不删除;如果配置为0天,则表示不删除;如果配置为7,则表示用户被禁用之后7天后删除;只支持正整数天后删除;可以在用户详情卡片中查看具体禁用时间;

禁用成员是否移动到统一部门:如果离职成员处理方式选择的是禁用,且开启了此配置,离职成员将被禁用并移动到部门名称是已禁用用户的部门下(默认部门名称是已禁用用户,用户可以根据需要自定义部门的名称);

用户绑定:将OA用户和企业微信用户关联。详情见 【4.2.4 用户绑定/解绑】

用户字段对应关系:该配置可以将成员在EC系统的里个人信息,同步到成员在企业微信里的个人信息里;

对外字段对应关系:该配置可以将成员在EC系统的里个人信息,同步到成员在企业微信里的对外个人信息里;

 

② 范围设置

    系统默认会将系统中的所有部门及用户数据同步到企业微信的通讯录中,同步范围不需要做任何设置;

如果有特殊的需要只将一部分部门及用户同步到企业微信的通讯录中,则可以设置需要同步的部门及用户范围(也可以部门和用户分开设置);

不在此范围内的并且已经与系统建立关联关系的部门或用户将会被从企业微信中删除,并且删除操作不可逆转,所以请谨慎选择范围。

 



 

分部/部门范围:不选择特定分部/部门,默认为全部

用户范围(包含):在此范围内的用户将被添加或者更新到企业微信

用户范围(排除):在此范围内的用户不会被添加到企业微信,如果用户已关联了企业微信用户,同步后将被删除。谨慎选择

注:部门和用户可以分开设置;

用户范围(排除)的优先级高于 用户范围(包含);

 

③ 安全设置和定时设置



 

用户减少数量阈值:本次同步的OA用户数量和上一次相比,减少的数量超过x,将停止同步OA用户信息,x可以自己设置;

定时设置:设置是否开启定时自动执行同步通讯录到企业微信的操作。

4.2.4 用户绑定/解绑

    OA用户和企业微信用户绑定的方式有多种:

① 手动绑定(需要配置应用)

    用户完成应用集成之后,可以直接访问应用,然后输入正确的系统账号密码后,对应集成的企业微信集成-通讯录管理中会记录用户的企业微信账号信息以及绑定关系。




 

② 自动绑定设置

    有两个设置的地方:一个地方配置之后,另外一处也会开启自动同步;修改任意一处,也会变更另外一处的设置。

从企业微信同步组织用户绑定关系-->新用户关联系统账号(使用见4.3.1

同步通讯录到企业微信-->用户绑定(使用见4.3.2

注意:若任意一处开启了关联设置,此时用户访问应用,也可通过关联设置自动关联;



 

③ 关联导入



 

    将已经同步到云桥本地的数据导出,并且将需要绑定的OA用户的对应字段写入到文档关联字段那一列,上传文档,点击导入按钮,即可将关联关系写入。

    例如:企业微信用户B要绑定OA用户的B1,选择的关联字段是【手机号】,在导出的B这一栏的关联字段中,填写B1的手机号,保存后将文件再导入,并且关联字段选择【手机号】,然后点击导入按钮即可。



 

④ 用户卡片绑定/解绑




 

⑤ 批量解绑

    解除云桥本地所有用户和OA用户的关联关系;



 

4.3同步功能使用说明

    云桥主要是将企业微信和OA的组织架构关联起来,所以同步前需要确认组织架构以企业微信端为准,还是以OA端为准!

4.3.1 以企业微信组织架构为准

    首先执行【从企业微信同步组织用户绑定关系】,然后把用户在企业微信中的身份和在OA系统中的身份关联上,使用如下任何一种方式:

    方法一:手动关联(见4.2.4)。

    方法二:在 从企业微信同步时进行自动关联:需要在【从企业微信同步组织用户绑定关系】时,开启【新用户关联系统账号】,配置关联字段之后,进行同步。

    例如:用户在 企业微信的身份 OA身份 使用 企业微信账号 匹配OA系统工号 进行关联。



 

    后续可以在 【从企业微信同步组织用户绑定关系】时,开启定时同步,每隔一段时间将企业微信的组织架构的变动更新到云桥。



 

    如果不希望在OA修改组织架构或者在云桥菜单中修改后影响到企业微信的组织架构,可以开启通讯录的只读模式:只允许企业微信的修改同步到云桥本地。


 

    是否同步到OA可以参考章节4.2.2

4.3.2 OA组织架构为准

    分为两种情况:

4.3.2.1 企业微信没有组织架构

(默认已经执行过从企业微信同步组织用户绑定关系)

① 无需进行用户账号绑定。

② 执行【同步通讯录到企业微信】,执行完成后,云桥会把OA的用户创建到企业微信,并且自动把用户在企业微信中的身份和在OA系统中的身份关联上。在创建企业微信用户时,企业微信用户的账号使用的是OA用户如下配置字段的值:


 

4.3.2.2 企业微信有组织架构

(默认已经执行过从企业微信同步组织用户绑定关系)

① 设置企业微信历史用户(即企业微信已存在的用户)账号绑定,选择如下任意一种方式进行关联:

    方法一:手动关联(见4.2.4

    方法二:自动关联,在第二步执行同步的时候配置用户匹配字段。



 

    注:如果自动绑定无法满足将企业微信用户和OA用户关联,可以在从OA同步前先使用手动绑定关联这些用户。

② 设置顶级部门

    是否设置顶级部门决定了同步后的组织架构;

    部门关联的逻辑是:层级相同且部门名称相同,在执行同步的时候,会自动关联,否则,在云桥和企业微信新建部门。关联上的部门前面会有一个黑色实心原点,代表已关联;

    举例说明:分为两种情况,没有设置顶级部门和设置了顶级部门;

没有设置顶级部门,默认同步OA整体组织架构



 

    如下图所示,根据层级和名称首先进行顶级部门匹配,则OA顶级部门【演示部门】去匹配云桥顶级部门【演示部门】,可以匹配。一级部门能够匹配上的只有【部门A】,则其他没有匹配上的部门,会在云桥和企业微信新建。




 

    同步后效果(可以先同步模拟同步查看效果):橘色为匹配,紫色为新增;



 

    注:如果顶级部门的名称不相同,例如【Re部门】和【演示部门】名称不同,则顶级部门无法匹配,同步立刻中止。



 

    提示如下:



 

设置了顶级部门,默认同步OA整体组织架构。选定【其他部门】为此次同步的顶级部门:



 

    如图所示,组织架构层级对应如下:



 

    执行同步,会将OARe部门】及其下级部门,同步到云桥【其他部门】下,作为顶级部门。

    根据部门匹配的原则,OA一级部门【Re部门】和顶级部门下的一级部门没有名称相同的,直接新建。

    同步效果如图:




 

4.3.3 其他注意事项

① 当企业微信的组织架构发生变化之后,需要在执行【同步通讯录到企业微信】之前,先执行【从企业微信同步组织结构绑定关系】。

② 如果该企业微信用户已经关联OA的账号,那么从OA同步的时候,用户匹配字段的配置将不会修改原有的绑定关系,该配置只针对未关联OA的企业微信用户。

③ 接口参数设置,如果设置了只读权限,所有在云桥对组织架构进行的操作(不包括用户手动关联用户),都不能操作。

5. 考勤同步

① 请登录企业微信管理后台https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome,找到应用管理里面的打卡应用,获取打卡应用的agentid和Secret;(若没有agentid和Secret,按照下述另外一种方式配置

 

② 在云桥配置企业微信打卡应用的agentid和Secret,点击保存;


 

注意:2023年12月1日0点起,企业微信不再支持通过系统打卡应用secret调用接口,存量企业暂不受影响https://developer.work.weixin.qq.com/document/51165,受影响的企业可以按照如下配置:

第一步、点击设置,选择一个自建应用;




 


 

第二步、复制自建应用的agentidSecret



 

第三步、将复制的自建应用的agentidSecret配置到云桥-企业微信-考勤同步中,点击保存;


 


③ 手动执行同步:



 

④ 定时同步:新建定时规则


 

 

6. 扫码登录

    此功能主要实现通过企业微信自带的扫一扫功能扫描OA系统首页的二维码进行登录OA系统,具体位置如下图:



 

    如果在未集成企业微信和应用的情况下,直接点击后面的【设置】按钮,会提示请先添加企业微信,故配置扫码登录功能前,请先集成企业微信和应用,参考手册第12点【1.企业集成、2.应用集成】。

① 点击扫码登录功能后面的【设置】按钮,进入配置页面,先点击开启按钮,再选择集成的应用后保存,如下图所示:



 

② 打开OA系统登录首页,扫码入口在右上角,如下图所示:



 

③ 使用手机端企业微信自带的扫一扫功能,扫OA系统登录首页二维码,如下图所示:



 

④ 扫完之后,需要选择租户(也就是团队名称)及集成的企业名称,如下图所示:


 

⑤ 选择完企业之后,如果人员在集成企业的通讯录里无关联关系且未开启自动关联(如下图1),则会出现此界面(如下图2):

 




 

⑥ 需要人员建立了关联关系后才可正常登录oa系统,具体建立关联的操作方法可参考此文档【4.2.4用户绑定/解绑】中的手动绑定自动绑定设置(开启了关联设置,此时用户访问应用,也可通过关联设置自动关联)用户卡片绑定;扫码选择完企业后,若建立了关联关系,就能正常登录oa系统页面,效果如下图所示:




 

 

 

7. 客户管理

    功能入口:



 

7.1功能配置

① 接口设置:接口调用模式可以选择 使用客户联系秘钥 或者 使用企业微信应用秘钥;


 

客户联系秘钥:

    第一步:请登录企业微信管理后台https://work.weixin.qq.com/wework_admin/frame#customer/analysis,【客户与上下游】-【客户】中查看secret



 

    第二步: 点击客户管理,选择接口调用模式-使用客户联系秘钥;



 

企业微信应用密钥:

    第一步:企业微信管理后台给用户使用外部联系人的权限;



 

    第二步:新建一个应用在云桥里集成(使用之前的应用也可以),具体参考该文档第2点【应用集成】;

    第三步:给该应用授权获取外部联系人的权限,勾选应用后面的方框,点击保存;

 


 

    第四步:点击客户管理,选择接口调用模式-使用企业微信应用秘钥;



 

7.2外部联系人列表

7.2.1外部联系人手动同步

① 选择 使用客户联系密钥 ,点击外部联系人列表,点击同步,能获取到企业里 所有人的外部联系人



 

企业微信用户A有关联OA账号A1,外部联系人能同步到关联的OA账号A1的【通讯录】-【外部互联】里;

    例如企业微信用户岳梦娇关联了OA用户岳梦娇:



 

    OA用户岳梦娇的账号【通讯录】-【外部互联】里面可以看到同步过来的外部联系人:



 

    在外部联系人列表里面就显示为已关联:



 

企业微信用户A无关联关系,外部联系人不能同步到【通讯录】-【外部互联】里,即在外部联系人列表里面的外部联系人是无关联状态。

 

② 选择 使用企业微信应用密钥 ,点击外部联系人列表,点击同步,能获取到应用可见范围内有 外部联系人使用权限的人员的外部联系人

企业微信用户A有关联OA账号A1,外部联系人能同步到关联的OA账号A1的【通讯录】-【外部互联】里;

企业微信用户A无关联关系,外部联系人不能同步到【通讯录】-【外部互联】里,即在外部联系人列表里面的外部联系人是无关联状态。

注:以上提到的同步的外部联系人都需要给内部用户开启使用外部联系人权限。

7.2.2外部联系人自动同步

① 接口调用模式选择 使用客户联系密钥

    复制图中回调相关参数: 




    将复制的参数配置到企业管理后台-【客户与上下游】-【客户】-【接收事件服务器】中:

 


 

   之后新增的外部联系人就能自动同步到外部联系人列表里,企业微信用户A有关联OA账号A1,外部联系人能同时同步到关联的OA账号A1的【通讯录】-【外部互联】里(企业微信用户A无关联关系,外部联系人不能同步到【通讯录】-【外部互联】里,即在外部联系人列表里面的外部联系人是无关联状态)。

 

② 接口调用模式选择 使用企业微信应用密钥:

    首先,分别在 云桥 企业微信后台 找到选择的应用,

 

 



 

     然后点击接收消息:



 

    分别复制回调urlTokenEncodingAESKey到企业微信后台对应的应用-【接收消息】中,点击保存:

 




 

 

    之后新增的外部联系人就能自动同步到外部联系人列表里,企业微信用户A有关联OA账号A1,外部联系人能同时同步到关联的OA账号A1的【通讯录】-【外部互联】里(企业微信用户A无关联关系,外部联系人不能同步到【通讯录】-【外部互联】里,即在外部联系人列表里面的外部联系人是无关联状态)。

    具体的功能使用说明可参考:私有环境外部联系人

8. 消息存档

    使用前提:需要购买企业微信会话内容存档功能或者申请试用体验,具体可以咨询企业微信。

① 请登录企业微信管理后台https://work.weixin.qq.com/wework_admin/frame#manageTools,找到【管理工具】里面的【会话内容存档】 ,查看 Secret


 

② 访问云桥-【企业微信集成】-【消息存档】,点击【设置】配置消息存档同步Secret


 

③ 依赖的应用需要选择具有消息存档权限的应用,具体的应用集成可以参考【2.应用集成】;

 

9. 其他功能说明

9.1企业微信-聊天附件栏+工具栏配置

① 功能入口如图:



 

② 功能配置可参考:https://yq.weaver.com.cn/eb/qa/view/#/question/d8409a3d4453479bbb91749c0dd51c64

9.2更多设置

① 功能入口:



 

② 功能说明:

    目前在企业微信应用中,点击右上角更多打开的菜单包括传播类(转发、微信、收藏)、基本类(调整字体、刷新)以及保护类(复制链接、Safari、邮件),可以通过该功能进行控制显示哪些菜单项;

③ 功能示例:以下说明都是已IOS为例;

【隐藏所有非基础功能按钮】,点击隐藏所有非基础功能按钮之后,手机端只会展示基础功能的按钮,如下图:



 

【分享到同事吧】和【分享到朋友圈】暂不支持单独隐藏,即按钮是置灰的,不支持选中,但是可以通过【隐藏所有非基础功能按钮】来隐藏

【发消息】和【消息通知】不支持隐藏,即按钮是置灰的,不支持选中,无法通过【隐藏所有非基础功能按钮】来隐藏

【隐藏所有非基础功能按钮】之后,再点击其他的按钮,无法启用对应的按钮(此种情况禁止单独启用按钮,必须先点击【展示所有非基础功能按钮】)



 

默认展示所有功能按钮,在没有点击【隐藏所有非基础功能按钮】的情况下,所有的蓝色按钮都支持单独选中,控制此菜单项是否展示;

 

 

 

 

9.3回调设置

① 功能入口:


 

② 功能说明:企业微信需要实现针对企业微信不同动作的回调自动回复不同的内容,比如用户在企业微信应用会话中输入的内容,我们可以根据用户的动作来设置回复不同的内容给用户。

③ 功能配置:

首先,在云桥找到需要接收回调消息的应用,复制【接收消息】页面的参数:


 

在企业微信管理后台-【应用管理】,找到需要接收回调消息的应用,设置API接收:


 

将云桥复制的参数填写到对应位置,点击保存:


 

开启云桥-应用详情-接收消息里面的【是否开启应用回调】开关:


 

④ 回调规则设置:

回调设置新建具体的消息回复规则:


 

规则名称:填写该条规则的名称;

用户动作:指用户给企业微信应用发送的是文字消息还是图片消息;

匹配方式:

             【包含】用户给企业微信应用发送文字内容包含设置的关键字,则匹配上该规则,按照该规则自动给用户回复;

             【开头】用户给企业微信应用发送文字内容的开头文字是设置的关键字,则匹配上该规则,按照该规则自动给用户回复;

             【结束】用户给企业微信应用发送文字内容的末尾文字是设置的关键字,则匹配上该规则,按照该规则自动给用户回复;

             【完全匹配】用户给企业微信应用发送文字内容等于设置的关键字,则匹配上该规则,按照该规则自动给用户回复;

             【直接托管】用户给企业微信应用发送文字消息,无论发送什么文字内容,都给予同样的回复;

关键字:通过关键字和用户发送的文字消息进行比对,匹配对应的规则,按照该规则自动给用户回复;关键字字数限制50个字符;

注意:只有当用户动作是【发送文字】,才有匹配方式和关键字!

回复内容:用户给企业微信应用发消息,匹配上该条规则后,可以在回复内容里面设置自动给用户发送的内容;回复内容字数限制1500个字符;

优先级:优先级数字越小,表示优先级越高,系统会优先执行优先级高的规则,最小值为1,最大值为100,不支持小数

启用:启用或者关闭当前规则

删除/批量删除:



 

⑤ 功能演示:

用户发送的文字消息,包含关键字:


 

 

用户发送的文字消息,开头是关键字:


 


 

用户发送的文字消息,结尾是关键字:


 


 

用户发送的文字消息,等于关键字:


 

 

用户发送的文字消息,无论发送什么文字内容,都给予同样的回复:


 


 


用户发送的图片消息:


 


 


⑥ 其他说明:

自动回复支持换行符</br>


 


 

自动回复支持超链接


 


 

9.4查看企微域名对应的ip清单

① 功能入口

 

 

 

② 功能说明:

有的客户不开放所有的IP,只开放个别,但是企业微信偶尔又会下线一些IP,这样就会导致这些开放个别IP的客户,可能正好用到的就是被下线的IP,就导致无法使用,通过企业微信提供的接口获取到企业微信接口IP清单,在小提示中点击【点击此处】即可查看,便于客户自行调整。

 

注:查看ip清单需要开通云桥服务器访问https://weapp.eteams.cn的网络权限。


 


Download Log in Enable for free

Scan with WeChat to register and install

在线咨询
  • WeCom service group

    另存
  • Pre-sales consultant

    另存
  • QQ group

    413040701

    Join

Follow us

021-50388680

sales@eteams.cn

Live