第三方应用开发 服务端API 家校沟通 基础接口 手机号转外部联系人ID
手机号转外部联系人ID
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
手机号转外部联系人ID
最后更新:2023/11/30

请求方式:POST(HTTPS

请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/batch_to_external_userid?access_token=ACCESS_TOKEN

请求示例

{
    "mobiles": [
        "10000000000",
        "10000000001"
    ]
}

参数说明:

参数必须说明
access_token调用接口凭证
mobiles家长手机号列表,最多支持100个

权限说明:
调用的应用需要满足如下的权限

应用类型权限要求
自建应用配置到「 家校沟通- 读取和编辑家校通讯录的应用」中
第三方应用需拥有「家校沟通」使用和编辑 权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "success_list": [
        {
            "mobile": "18900000000",
            "external_userid": "aaabbbcccc"
        }
    ],
    "fail_list": [
        {
            "errcode": 60136,
            "errmsg": "record not found",
            "mobile": "10000000001"
        }
    ]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
success_list转换成功列表
success_list.mobile手机号
success_list.external_userid外部联系人的userid(家长关注后才会返回该字段)
fail_list转换失败列表
fail_list.errcode返回码
fail_list.errmsg对返回码的文本描述内容
fail_list.mobile手机号
上一篇
外部联系人openid转换
下一篇
管理「老师可查看班级」模式