企业微信2.0版本与微信企业号产品合并,企业号现已升级为企业微信,BeX5中企业微信的集成参考http://docs.wex5.com/bex5weiwork/
准备工作:
- 需有经过备案的域名,且端口是80或443;
- BeX5 V3.2.1必须部署到一个外网服务器上,外网访问地址,需映射到准备好的域名及端口上;
- 申请好的微信企业号,或者申请体验号。
步骤:
- 微信企业号后台,添加应用,创建管理组;
- 管理员账号登陆BeX5,配置微信企业号及应用相关参数;
- 微信企业号后台,配置回调参数;
- 管理员账号登陆BeX5,同步组织、同步菜单;
- 微信企业号后台,邀请关注;
- 员工关注后即可使用;
- 消息服务配置及注意事项。
一.微信企业号后台,添加应用,创建管理组
1.添加应用
- 进入“应用中心”,“我的应用”,新增;
- 填写,应用名称、功能介绍等信息;
- 设置,应用可见范围,此时,选择企业号的根节点即可。微信的权限是到应用级的,不能到功能级,本文,是将BeX5首页作为微信企业号菜单的入口,功能权限是通过BeX5中权限进行控制。
2.创建管理组
- 进入“设置”——“功能设置”——“权限管理”——“新建管理组”;
- 填写:名称,管理员可以先不进行设置;
- 下一步,设置通讯录权限:需对通讯录根节点设置“管理权限”,只有设置该权限,才能同步组织机构;
- 设置应用权限:只有设置该权限,才能正常进行应用菜单的同步操作。
二.管理员账号登陆BeX5,配置微信企业号及应用相关参数
进入“协同办公”——“系统工具”——“微信企业号配置”功能;此时,只需完成界面中的“第一步,配置应用”。具体参数如下:
- CorpID:微信后台,设置——功能设置——权限管理——你添加的管理组——“CorpID”
- Secret: 微信后台,设置——功能设置——权限管理——你添加的管理组——“Secret”
- 微信管理员账号:需要是微信通讯录中已有成员的微信帐号。
- 应用ID:微信后台,应用中心——新增的应用中的“应用ID”
- 可信域名:BeX5的服务,需配置域名(可不填写)
- Token:随机获取字符串
- EncodingAESKey:随机获取字符串
设置完成,进行保存,自动生成回调URL,可进行拷贝
三.微信企业号后台,配置回调参数
- “应用中心”——选择刚才新建的应用——“模式选择”——开启回调;
- 设置回调URL及密钥,具体参数如下:
- URL:BeX5“微信企业号配置”中拷贝“回调地址”
- Token:BeX5“微信企业号配置”中拷贝“Token”
- EncodingAESKey:BeX5“微信企业号配置”中拷贝“EncodingAESKey”
注意事项:
- 有时保存回调地址的时候会发生连接超时的情况,如果BeX5的控制台没有报错,那可以多次保存。
- URL以“http://”或者“https://”开头,http支持80端口,http上支持443端口;
- http://demo.justep.cn/x5/UI2/SA/weixin/weixinCallback.j?configKey=wx415777370afff2291其中:demo.justep.cn用自己服务的域名进行替换configKey:CorpID+应用ID
- Token和EncodingAESKey两边都可以随机获取,只需保证一致即可。
四.管理员账号登陆BeX5,同步组织、同步菜单
进入“协同办公”—系统工具—微信企业号配置
- 点击“同步组织机构”。
- 点击“同步菜单”,目前系统默认将首页设置在菜单中了,可以修改名称。如果要增加别的菜单,增加后,点击“同步菜单”按钮即可
注意事项:
- 如果“组织机构”节点下,只有一个机构节点,那么该节点不会同步到微信通讯录中,如果是多个,那么这多个节点都会同步到微信通讯录中。
- 微信通讯录没有岗位的概念,所以只能同步部门和人员。
- 同步要求人员的邮箱或者手机号不能同时为空,否则该人员将不能同步成功。
- 由于组织数据可能会比较多,采用了异步方式,所以点击同步按钮后,可以先继续别的操作,完成后将会有同步成功的提示,并且,在“协同办公”—系统工具—操作日志中可以查看同步的日志。
- 如果同步组织后,在微信后台通讯录中查看不到,那么可以重新登陆微信后台管理再进行查看。
五.微信企业号后台,邀请关注
微信后台——通讯录——点击人员——邀请关注
六.员工关注后即可使用
- 被邀请的员工,收到邮件后,扫描二维码进行关注;
- 关注后需通过邮件或者手机号码进行验证,验证通过后,就能看到已经设置好的,有权限的应用。
- 打开首页后即可使用。
七.消息服务配置及注意事项
V3.2.1开始平台版本中内置消息服务,在本文中,将如何开启消息服务,实现将微信企业号集成的BeX5中流程产生的待办任务通过消息服务推送到微信中。具体设置内容:
- 配置消息服务:配置消息服务,\conf\server.xml中<mqtt-server>tcp://localhost:1883</mqtt-server> ,打开。
- 服务地址:配置消息服务打开消息时打开的功能的服务地址,\conf\server.xml中<external-address>http://XXXX</external-address>,这里配置访问BeX5服务的域名
- 流程开关: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
评一波