Name

QQ::weixin::work::corpgroup::batch

DESCRIPTION

FUNCTION

external_userid_to_pending_id(access_token, hash);

external_userid查询pending_id 最后更新：2023/03/30

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/97357

请求说明：

external_userid的说明

external_userid是企业微信用于表示企业的外部联系人而设立的id，且满足以下条件 假设同一个微信用户属于多个下游企业的外部联系人 1.同一上游企业获取到不同企业的外部联系人的external_userid不一致。 2.不同一上游企业获取同一个企业的同一个外部联系人的external_userid也不一致。

pending_id的说明

pending_id主要用于关联微信unionid与外部联系人external_userid，可理解为临时外部联系人ID； 上游企业可通过此接口将微信unionid转为pending_id，当微信用户成为下游企业客户后，可使用上下游external_userid转pending_id接口将下游external_userid转换为pending_id，建立unionid => pending_id => external_userid的映射关系； pending_id有效期90天，共享应用内唯一。

请求包结构体为：

        {
          "chat_id":"xxxxxx",
          "external_userid":["oAAAAAAA", "oBBBBB"]
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
    external_userid     是       上游或下游企业外部联系人id，最多同时查询100个
        chat_id 否       群id，如果有传入该参数，则只检查群主是否在可见范围，同时会忽略在该群以外的external_userid。如果不传入该参数，则只检查客户跟进人是否在可见范围内。

权限说明：

调用该接口的应用必须是上下游共享的自建应用或代开发应用 应用需要具有客户联系权限 该客户的跟进人或其所在客户群群主必须在应用的可见范围之内 上游应用须调用过unionid转pending_id接口 上游和下游企业须认证或验证；若为代开发应用，服务商必须已认证

RETURN 返回结果：

        {
                "errcode":0,
                "errmsg":"ok",
                "result":[
                         {
                                "external_userid":"oAAAAAAA",
                                "pending_id":"pAAAAA"
                         },
                         {
                                "external_userid":"oBBBBB",
                                "pending_id":"pBBBBB"
                         }
                 ]
        }

RETURN 参数说明：

        参数              说明
    errcode         出错返回码，为0表示成功，非0表示调用失败
    errmsg      对返回码的文本描述内容
    result      转换结果
        result.external_userid  转换的external_userid
        result.pending_id       该微信账号还未成为企业客户时，返回的临时外部联系人ID