企业微信

• 信息
  

  术语	描述
  corpid	每个企业唯一的企业id
  userid	每个成员唯一的账号id
  tagid	每个标签唯一的标签id
  external_userid	企业外部联系人的id
  agentid	每个应用唯一的应用id
  secret	密钥
  access_token	获取企业微信后台信息的凭证,由corpid和secret产生

API

token

• 请求方式: GET
• 请求地址: https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
• 参数
  

  参数	是否必填	说明
  corpid	是	企业id
  coprsecret	是	密钥

通讯录管理

成员管理

• 获取成员ID列表
• 请求方式: POST
• 请求地址: https://qyapi.weixin.qq.com/cgi-bin/user/list_id?access_token=ACCESS_TOKEN
• 参数
  

  参数	是否必填	说明
  access_token	是	凭证
  cursor	否	分页查询的游标,上一次调用返回
  limit	否	分页,取值1 ~ 10000

客户联系

企业服务人员管理

• 获取配置了客户联系功能的成员列表
  • 请求方式: GET
  • 请求地址: https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_follow_user_list?access_token=ACCESS_TOKEN
  • 参数
    

    参数	是否必填	说明
    access_token	是	凭证

客户管理

• 获取客户列表
  • 请求方式: GET
  • 请求地址: https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN&userid=USERID
  • 参数
    

    参数	是否必填	说明
    access_token	是	凭证
    userid	是	企业成员的userid

• 获取客户详情
  • 请求方式: GET
  • 请求地址: https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get?access_token=ACCESS_TOKEN&external_userid=EXTERNAL_USERID&cursor=CURSOR
  • 参数
    

    参数	是否必填	说明
    access_token	是	凭证
    external_userid	外部联系人的userid
    cursor	否	上次请求返回的cursor

• 批量获取客户详情
  • 请求方式: POST
  • 请求地址: https://qyapi.weixin.qq.com/cgi-bin/externalcontact/batch/get_by_user?access_token=ACCESS_TOKEN
  • 参数
    

    参数	是否必填	说明
    access_token	是	凭证
    userid_list	成员id列表
    cursor	否	上次请求返回的cursor
    limit	否	分页,最大值100,默认50

• 编辑企业客户标签
  • 请求方式: POST
  • 请求地址: https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token=ACCESS_TOKEN
  • 参数
    

    参数	是否必填	说明
    access_token	是	凭证
    userid	是	企业成员的userid
    external_userid	是	外部联系人id
    add_tag	否	要标记的标签列表
    remove_tag	否	要移除的标签列表