准备工作:

  1. 需有经过备案的域名,且端口是80或443;
  2. BeX5 V3.2.1必须部署到一个外网服务器上,外网访问地址,需映射到准备好的域名及端口上;
  3. 申请好的微信企业号,或者申请体验号。

步骤:

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

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

       1.添加应用

  • 进入“应用中心”,“我的应用”,新增;
  • 填写,应用名称、功能介绍等信息;
  • 设置,应用可见范围,此时,选择企业号的根节点即可。微信的权限是到应用级的,不能到功能级,本文,是将BeX5首页作为微信企业号菜单的入口,功能权限是通过BeX5中权限进行控制。

1.weixin-newapp

      2.创建管理组

  •  进入“设置”——“功能设置”——“权限管理”——“新建管理组”;
  • 填写:名称,管理员可以先不进行设置;
  • 下一步,设置通讯录权限:需对通讯录根节点设置“管理权限”,只有设置该权限,才能同步组织机构;
  • 设置应用权限:只有设置该权限,才能正常进行应用菜单的同步操作。

1.weixin-newmanage

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

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

  • CorpID:微信后台,设置——功能设置——权限管理——你添加的管理组——“CorpID”
  • Secret:  微信后台,设置——功能设置——权限管理——你添加的管理组——“Secret”
  • 微信管理员账号:需要是微信通讯录中已有成员的微信帐号。
  • 应用ID:微信后台,应用中心——新增的应用中的“应用ID”
  • 可信域名:BeX5的服务,需配置域名(可不填写)
  • Token:随机获取字符串
  • EncodingAESKey:随机获取字符串

     设置完成,进行保存,自动生成回调URL,可进行拷贝

2.weixin-BeX5conf

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

  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两边都可以随机获取,只需保证一致即可。

3.weixin-callback

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

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

  1. 点击“同步组织机构”。
  2. 点击“同步菜单”,目前系统默认将首页设置在菜单中了,可以修改名称。如果要增加别的菜单,增加后,点击“同步菜单”按钮即可

4.weixin-syn

注意事项:

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

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

微信后台——通讯录——点击人员——邀请关注

5.weixin-focus

六.员工关注后即可使用

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

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

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

  1. 配置消息服务:配置消息服务,\conf\server.xml中<mqtt-server>tcp://localhost:1883</mqtt-server> ,打开。
  2. 服务地址:配置消息服务打开消息时打开的功能的服务地址,\conf\server.xml中<external-address>http://XXXX</external-address>,这里配置访问BeX5服务的域名
  3. 流程开关:Model\biz\system\config\Interceptor.config.m中打开<item name=”ProcessPushEngine” value=”/system/logic/code,ProcessPushEngine,after”/>

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

本文由WeX5君整理,WeX5一款开源免费的html5开发工具H5 App开发就用WeX5!

阅读其他app 开发相关文章:http://doc.wex5.com/?p=3443