企业微信API使用基本教程

企业微信创建自建应用

应用管理登录企业微信后台>点击创建应用程序,填写应用信息创建。

创建应用

API获取配置表参数值

1、corpid:企业ID。我的企业在企业微信后台>获取企业信息。

获取corpid

2、corpsecret:使用凭证密钥。获取自建应用细节。

获取申请凭证密钥

如果使用通讯录相关的话API则corpsecret管理工具>在通讯录同步中获取。

与获取通讯录有关API

3、AesKey及token:加密的AES KEY和消息token。

如果外部联系人变更回调等事件信息他事件信息,则在自建应用程序细节中>接收消息>设置API在接收中获得。

找到“设置API接收”

获取

在管理工具中接收通讯录相关回调事件的信息>通讯录同步>在接收事件服务器中获取。

通讯录同步

设置接收事件服务器

获取

云函数使用

1、根据企业微信API创建云函数的模板

创建云函数

2、配置参数按上述填写。

填写参数

3、编程API。可使用$modules.wcworkApi调用部分已封装API,使用$output输出。

编写API

可以查看鼠标移入API说明。

查看API说明

4、保存测试。

编写完成后,单击右上角的保存按钮保存代码,并打开此云函数。

先1再2啊看清楚

在线调试工具在编程下方展开,点击测试,查看操作结果。

测试

5、在功能中调用云函数。

确保云函数正确打开后,在功能中创建API步骤,选择自定义API选择相应的云函数进行调用。

调用云函数

Webhook使用

1、以类似云函数的方式创建webhook,并配置相关参数。

配置参数

2、代码下格式编写代码

       async function hook($req,$resp,$modules = modules) { get 要求验证有效性if ($req.method == "GET") { 处理已封装,可直接调用 $resp.body = await modules.wxworkApi.getVerifyMsg($req); } else if ($req.method == "POST") { 无法保证在五秒内处理完成,先回复(企业微信服务器在五秒内收不到响应会断掉连接) $resp.body = "success"; let handle = async () => { 将数据转换成json let data = await modules.wxworkApi.getMsgData($req); if (data.Event == "change_contact" && data.ChangeType == "create_party") { TODO handle(); } }

3、保存代码,** webhook路径。

保存后 **

4、在企业微信背景的信息回调配置中(自建应用)API在接收信息或通讯录同步中设置接收信息服务器) ** 的webhook路径粘贴到url中。保存时验证有效性。

粘贴

5、直接打开浏览器webhook路径应显示“ok。使用企业微信进行相关操作触发回调进行检测webhook处理结果。

验证

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               

扫码免费用

源码支持二开

申请免费使用

在线咨询