准备工作：

1、需有经过备案的域名；

2、BeX5 V3.7必须部署到一个外网服务器上，外网访问地址，需映射到准备好的域名及端口上；

3、申请好的企业微信号，或者申请体验号。

步骤：

  1. 企业微信后台，添加应用，创建管理组；
  2. 管理员账号登陆BeX5，配置企业微信及应用相关参数；
  3. 企业微信后台，配置回调参数；
  4. 管理员账号登陆BeX5，同步组织、同步菜单；
  5. 企业微信后台，邀请关注；
  6. 员工关注后即可使用；
  7. 消息服务配置及注意事项。

 

 一.企业微信后台，添加应用，创建管理组

  1.添加应用

  • 进入“企业应用”，“自建应用”，创建应用；
  • 进入创建应用后，上传应用LOGO，填写应用名称、功能介绍，选择可见范围等信息；
  • 本文，是将BeX5首页作为企业微信菜单的入口，功能权限是通过BeX5中权限进行控制。

二.管理员账号登陆BeX5，配置企业微信及应用相关参数

进入“协同办公”——“系统工具”——“企业微信配置”功能；此时，只需完成界面中的“第一步，配置应用”。具体参数如下：

  • CorpID：微信后台，设置——功能设置——权限管理——你添加的管理组——“CorpID”
  • Secret：  微信后台，企业应用——新建的应用——“Secret”

注意：不同的操作需要更换不同的secret，例如同步到通讯录，需要从微信后台获 取同步通讯录的secret，同步某个应用的分组，当前应用推送消息则需要当前这个应用的 secret，修改secret之后需要重启服务！

  • 微信管理员账号：需要是微信通讯录中已有成员的微信帐号。
  • 应用ID(AgentId)：微信后台，应用中心——新增的应用中的“应用ID”
  • 可信域名：BeX5的服务，需配置域名
  • Token：随机获取字符串
  • EncodingAESKey：随机获取字符串

     设置完成，进行保存，自动生成回调URL，可进行拷贝，回调的URL是根据可信域名生成的。

1499828609(1)

三.企业微信后台，配置回调参数

  1. “企业应用”——选择刚才新建的应用——“接收消息”——配置参数；
  2. 设置回调URL及密钥，具体参数如下：
  • URL：BeX5“企业微信配置”中拷贝“回调地址”
  • Token：BeX5“企业微信配置”中拷贝“Token”
  • EncodingAESKey：BeX5“企业微信配置”中拷贝“EncodingAESKey”

注意事项：

  1. 有时保存回调地址的时候会发生连接超时的情况，如果BeX5的控制台没有报错，那可以多次保存。
  2. URL以“http://”或者“https://”开头，http支持80端口，http上支持443端口；
  3. http://demo.justep.cn/x5/UI2/SA/weixin/weixinCallback.j?configKey=wx415777370afff2291其中：demo.justep.cn用自己服务的域名进行替换configKey：CorpID+应用ID
  4. Token和EncodingAESKey两边都可以随机获取，只需保证一致即可。

 
1499823715(1)

四.管理员账号登陆BeX5，同步组织、同步菜单

进入“协同办公”—系统工具—企业微信配置

  1. 点击“同步组织机构”。

同步组织机构需要重新获取Secret  微信后台——管理工具——通讯录同步——secret

1499825461(1)

将通讯录同步的中secret拷贝到bex5 中的secret中，点击保存配置，最后在点击数据同步中的同步组织机构，就可以将bex5中的通讯录同步到微信中了。

  1. 点击“同步菜单”，目前系统默认将首页设置在菜单中了，可以修改名称。

使用菜单同步功能时，需要更换当前这个应用的secret。

企业应用——当前创建的应用——secret，将应用的secret 拷贝到bex5的secret中，再次点击保存配置。如果要增加别的菜单，增加后，点击“同步菜单”按钮即可

注意事项：

  • 如果“组织机构”节点下，只有一个机构节点，那么该节点不会同步到微信通讯录中，如果是多个，那么这多个节点都会同步到微信通讯录中。
  • 微信通讯录没有岗位的概念，所以只能同步部门和人员。
  • 同步要求人员的邮箱或者手机号不能同时为空，否则该人员将不能同步成功。
  • 由于组织数据可能会比较多，采用了异步方式，所以点击同步按钮后，可以先继续别的操作，完成后将会有同步成功的提示，并且，在“协同办公”—系统工具—操作日志中可以查看同步的日志。
  • 如果同步组织后，在微信后台通讯录中查看不到，那么可以重新登陆微信后台管理再进行查看。

 

五.企业微信后台，邀请关注

微信后台——通讯录——选择人选——邀请关注
image2

六.员工关注后即可使用

  1. 被邀请的员工，收到邮件后，扫描二维码进行关注；
  2. 关注后需通过邮件或者手机号码进行验证，验证通过后，就能看到已经设置好的，有权限的应用。
  3. 打开首页后即可使用。

七.消息服务配置及注意事项

V3.2.1开始平台版本中内置消息服务，在本文中，将如何开启消息服务，实现将企业微信集成的BeX5中流程产生的待办任务通过消息服务推送到微信中。具体设置内容：

  1. 配置消息服务：配置消息服务，confserver.xml中<mqtt-server>tcp://localhost:1883</mqtt-server> ，打开。
  2. 将confserver.xml中<push-server>http://localhost:8080/PushServer</push-server> ，打开。
  3. 服务地址：配置消息服务打开消息时打开的功能的服务地址，confserver.xml中<external-address>http://XXXX</external-address>，这里配置访问BeX5服务的域名
  4. 流程开关：model/BIZ/system/config/interceptor.config.m中打开<item name=”ProcessPushEngine” value=”/system/logic/code,ProcessPushEngine,after”/>

完成以上配置后，就可以启动版本根节点中的消息服务“启动消息服务.bat”

注意当前推送是在应用中推送信息，所以要确认当前配置的secret应该是当前应用的secret。

之后就可以通过流转收到推送的信息了。