企业内部开发 服务端API 开发指南 自建应用与第三方应用的对接
自建应用与第三方应用的对接

目录

  • userid转换
  • external_userid转换
  •  

    为更好地保护企业与用户的数据,企业微信不允许第三方应用获取企业的明文userid与external_userid。而企业的自建应用在一些场景下需要与第三方服务商的应用对接,为此,企业微信提供了自建应用的转换接口,支持将第三方应用获取的userid、external_userid转换为企业主体对应的ID。

    userid转换

    将代开发应用或第三方应用获取的密文open_userid转换为明文userid。
    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/batch/openuserid_to_userid?access_token=ACCESS_TOKEN

    请求参数:

    {
      "open_userid_list":["xxx", "yyy"],
      "source_agentid":100001
    }

    参数说明:

    参数必须说明
    access_token企业自建应用或基础应用的调用接口凭证。获取方法查看“获取access_token
    open_userid_listopen_userid列表,最多不超过1000个。必须是source_agentid对应的应用所获取
    source_agentid企业授权的代开发自建应用或第三方应用的agentid

     

    权限说明:

    需要使用自建应用或基础应用的access_token
    成员需要同时在access_token和source_agentid所对应应用的可见范围内

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
        "userid_list": [
            {
                "open_userid": "xxx",
                "userid": "aaa",
            }
        ],
        "invalid_open_userid_list":["yyy"]
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    userid_list明文userid
    userid_list.open_userid转换成功的open_userid
    userid_list.userid转换成功的open_userid对应的userid
    invalid_open_userid_list不合法的open_userid列表

     

    external_userid转换

    将代开发应用或第三方应用获取的externaluserid转换成自建应用的externaluserid。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/from_service_external_userid?access_token=ACCESS_TOKEN

    请求参数:

    {
      "external_userid":"aaa",
      "source_agentid":100001
    }

    参数说明:

    参数必须说明
    access_token企业自建应用或基础应用的调用接口凭证。获取方法查看“获取access_token
    external_userid服务商主体的external_userid,必须是source_agentid对应的应用所获取
    source_agentid企业授权的代开发自建应用或第三方应用的agentid

     

    权限说明:

    需要使用自建应用或基础应用的access_token
    客户的跟进人,或者用户所在客户群的群主,需要同时在access_token和source_agentid所对应应用的可见范围内

    返回结果:

    {
        "errcode":0,
        "errmsg":"ok",
        "external_userid":"xxx",
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    external_userid企业主体的external_userid

     

    上一篇
    获取企业微信API域名IP段
    下一篇
    概述