企业微信对接指南

UMS 目前支持企业微信中的发送应用消息功能,支持的消息类型包含:文本消息、图片消息、文件消息、外链图文、图文消息、小程序通知消息。

注:企业群发消息在后续计划中,敬请期待。

申请企业微信的应用

1、在企业微信官网页面,点击注册,填写企业信息与管理员信息即可注册成功,如果已有企业微信,则直接点击登录jpush_web

2、登录企业微信的管理后台后,点击「应用管理」,在自建应用中选择「创建应用」 jpush_web

3、设置「应用logo/应用名称/应用介绍/可见范围」即可创建成功,如果企业已经有了一个小程序,可以直接点击「已有小程序快速创建」,使用小程序的管理员微信扫码授权即可。也可以选择在创建应用成功后,再在「应用主页」中设置「关联小程序」。如果需要使用「小程序通知消息」这种类型,则必须关联小程序。 jpush_web jpush_web

基本配置与鉴权

1、在“管理后台-应用管理-点击某具体应用-详情”页中可以获得 AgentId 和 Secret 信息 jpush_web

2、在“管理后台-我的企业”中可以获得企业 ID 信息 jpush_web

3、将上述信息配置到 UMS 企业微信通道信息中去,即可通过 UMS 给企业微信发送消息。 jpush_web

上传 userID

1、一般如果企业已接入了企业微信,则会调官方 API 将员工批量导入企业微信,其中所设置的 userID 即发送消息时所需要填写的目标 ID。

2、如果是首次测试,可以在管理后台手动添加一个成员,其中「账号」即 userID jpush_web

3、如果通讯录中已有成员,则点击该成员,在详情也能看到他的账号 jpush_web

4、将通过上述方式获取到的企业微信 userid 上传到 UMS 用户体系中。企业微信的 userID 在同一个企业内多个应用中通用,因此在 UMS 的绑定标识为 all,示例:

  • 在 UMS 控制台上点击文件上传,企业微信 userID 在 UMS 中的命名是:wechatwk_userid,Excel 内容参考: jpush_web
  • 调用 rest API 上传的 JSON 示例如下,详情请参考 rest API - 用户管理
[{
    "userid": "zhangsan",
    "set":{
        "wechatwk":"zhangsan"
    }
}]

发送消息

配置成功后即可开始使用官网控制台发送消息,阅读控制台操作指南

还可以调用 API 进行发送,阅读 REST API 文档


Copyright 2011-2020, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.