• 免费试用
  • 电话咨询

    客服热线

    400-607-5151

  • 在线客服

    企业微信扫码添加在线客服

首页/帮助/企业微信知识/企业微信常见问题/微信企业号的agentid怎么查看?如何获取?

微信企业号的agentid怎么查看?如何获取?

       企业应用中的URL链接(包括自定义菜单或者消息中的链接),可以通过OAuth2.0来获取员工的身份信息。
  注意,此URL的域名,必须完全匹配企业应用设置项中的'可信域名',否则获取用户信息时会返回50001错误码。


一、企业获取code

  企业如果需要员工在跳转到企业网页时带上员工的身份信息,需构造如下的链接:
  https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

    参数说明


  参数
  必须
  说明

  appid    是    企业的CorpID
  redirect_uri    是    授权后重定向的回调链接地址,请使用urlencode对链接进行处理
  response_type    是    返回类型,此时固定为:code
  scope    是    应用授权作用域,此时固定为:snsapi_base
  state    否    重定向后会带上state参数,企业可以填写a-zA-Z0-9的参数值
  #wechat_redirect    是    微信终端使用此参数判断是否需要带上身份信息

  员工点击后,页面将跳转至 redirect_uri/?code=CODE&state=STATE,企业可根据code参数获得员工的userid。


二、获取成员信息


  
请求说明
  Https请求方式:GET
  https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE&agentid=AGENTID

  参数说明

  参数

  必须
  说明

  access_token    是    调用接口凭证
  code    是    通过员工授权获取到的code,每次员工授权带上的code将不一样,code只能使用一次,5分钟未被使用自动过期
  agentid    是    跳转链接时所在的企业应用ID
  权限说明
  管理员须拥有agent的使用权限;agentid必须和跳转链接时所在的企业应用ID相同。
  返回结果
  a)正确时返回示例如下:
  {    “UserId”:”USERID” }

  参数
  说明

  UserId    员工UserID
  出错时返回示例如下:
  {    "errcode": "40029",    "errmsg": "invalid code" }