企微接入

1. 打开企微企业管理后台,找到企业ID(corpId)

登录企微,点击左上角头像打开菜单,点击管理企业。


然后在浏览器打开企业管理后台。


在我的企业中可以看到企业ID(corpId)。


2. 创建应用,找到企业ID(AgentId和Secret)

切换到应用管理,点击创建应用。


输入应用名称等信息。


找到AgentId和Secret信息。


点击查看,在弹窗中点击发送。


然后会收到企业微信团队发送的信息,然后点击查看。


然后就可以复制Secret信息了。


3. 查看斑斑部署电脑/服务器的公网IP

能用浏览器的可以访问这个地址 https://ip.cn/  查看,其他的情况可以问AI。

注意:必须是固定的公网IP,不清楚这个概念的可以问AI


4. 设置可信域名

对接企微必须有与企微认证主体一致的备案域名,点击“设置可信域名”。


两个位置都填入域名,例如:www.banban.work,然后点击“申请校验域名”。

pic1.1.png


然后按照要求放置验证文件。

pic1.2.png


5. 设置可信IP

对接企微必须有固定的公网IP,否则用不了。


将上面查到的部署斑斑的电脑/服务器的公网固定IP填到这里。

6. 企业微信授权登录

打开企业微信授权登录设置。


在Web网页设置中添加斑斑工作台服务地址。

注意:工作台服务地址一定要绑定域名(就是上面设置的可信域名),不能直接使用IP。


工作台服务地址在斑斑客户端中复制。

注意:这里的服务地址已经修改为域名地址了,没有带端口号是使用了https协议的默认443端口

image.png


7. 斑斑后台通讯录同步

打开斑斑工作台,在企业微信的基本设置中填入上面获取到的CorpID、AgentId和Secret,然后点击开始检测。

image.png


如果需要在流程中使用企微审批通知,则需要填写下面两个参数。

注意:这里先不填,需要等下面第8步完成后再返回来设置这个。

image.png


检测通过后就可以进行通讯录同步了。

image.png


如果我们希望本地账号和企微完全一致,可以直接点击右上角的自动同步按钮。系统会 根据企微通讯录自动创建对应的部门和成员并建立关联。(自动同步后默认密码是123456)

如果本地有已经创建的账号,也可通过手动选择进行关联,同一个企微账号可以和本地多个账号关联,在设置时需要从部门往下逐级关联。


8. 企微接收消息设置

在企微管理后台“接收消息”中点击“设置API接收”。

注意:务必在上面第7步完成后才能进行这一步

pic2.png

在弹窗中填入上面的可信域名(注意:要在域名后拼接弹窗中的路径参数"/wecom/callback/")。

pic12.png


Token和EncodingAESKey可以直接点击随机获取来生成。(注意:这两个参数需要填入斑斑后台

下方的消息事件类型可以根据你的具体需求来勾选(注意:审批状态通知 必选)。

pic13.png


9. 配置斑斑后台企微接收消息

在斑斑后台填入上面获取的Token和EncodingAESKey,然后点击保存。

image.png

10. 企微登录工作台

打开斑斑工作台,点击企微登录。


然后就可以扫码登录了。


11. 流程节点设置企微通知

在斑斑的应用编辑中,流程节点里的审批、办理和抄送三个节点可以设置企微消息推送。

image.png