企微机器人列表

POST

/wxworkapi/robot/list

获取Work-bot平台已创建且已完成绑定的企业微信机器人列表

返回参数officialUserId：机器人对应的企业成员官方userid，在企业微信自建应用模式下与企业微信官方接口【通讯录管理>读取成员】中获取到的userid一致。在企业微信第三方应用【通讯录管理>读取成员】接口获取到的是open_userid与机器人officialuserId不一致。
示例：PiaoLiang***

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
  "robotKey": "f0dd39a9axxxf231f2e41f45"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.example.com/wxworkapi/robot/list' \
--header 'token: cf95e27e49a58a63798dc48e13b6f866' \
--header 'request_id: {{$string.alphanumeric(length=32)}}' \
--header 'Content-Type: application/json' \
--data '{
  "robotKey": "f0dd39a9axxxf231f2e41f45"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "msg": "OK",
    "code": "0",
    "model": [
        {
            "aliasName": "测试",
            "headImg": "https://wework.qpic.cn/wwpic/977757_2Vo-hDxbS2a3ouH_1699949473/0",
            "corpid": "ww5484e1410f7f3845",
            "loginType": "1",
            "nickName": "漂亮***",
            "mobile": "1326xxxx602",
            "wxid": "1688856063489699",
            "expireDateStart": "",
            "lastLoginTime": "2025-03-13 02:19:41",
            "companyId": 1970325046037717,
            "robotKey": "64ab3e40aa4048148cf12f4393c10dea",
            "robotStatus": 2,
            "clientCode": "account1",
            "masterClientCode": "account1",
            "expireDateEnd": "",
            "officialUserId": "PiaoLiang***",
            "internalUserId": "PiaoLiang***"
        }
    ]
}

修改于 2026-08-25 07:56:59

创建机器人

获取登录二维码