准备工作:

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。

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