批量获取会话信息接口
POST
/api/v2/system/convertIds
当type=1时，传imContactIds、externalUserIds、coworkerWecomUserIds、coworkerImContactIds都可以查到对应私聊的chatid，最大支持500个
当type=2时，传wecomChatIds或imRoomIds都可以查到对应的群聊chatid，最大支持500个
也可以只传chatid反查
请求参数
Query 参数
Body 参数application/json
示例
{
"type": 1,
"imBotId": "16888*****578438",
"imContactIds": ["78813****9110143", "7881302****47451"]
// "externalUserIds": ["wmrRhyBgAAT2*****BFhZyYxB_FF3Q", "wmrRhyBgAAv*****AoGkAYsUo6XzCQ"]
// "wecomChatIds": ["wrrRhyBgAAC1*****1xfuuM3bH44lQ", "wrrRhyBgAApR*****oI_HVvpc5N7FjQ"]
// "imRoomIds": ["R:10704*****961273", "R:10730*****041976"]
// "chatIds": ["685191b6ae3093e2f315dc4b", "685191b8ae3093e2f315e056"]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ae-bg.ddregion.com/hub-api/api/v2/system/convertIds?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
"type": 1,
"imBotId": "16888*****578438",
"imContactIds": ["78813****9110143", "7881302****47451"]
// "externalUserIds": ["wmrRhyBgAAT2*****BFhZyYxB_FF3Q", "wmrRhyBgAAv*****AoGkAYsUo6XzCQ"]
// "wecomChatIds": ["wrrRhyBgAAC1*****1xfuuM3bH44lQ", "wrrRhyBgAApR*****oI_HVvpc5N7FjQ"]
// "imRoomIds": ["R:10704*****961273", "R:10730*****041976"]
// "chatIds": ["685191b6ae3093e2f315dc4b", "685191b8ae3093e2f315e056"]
}'返回响应
🟢200成功
application/json
Body
示例
{
"errcode": 0,
"errmsg": "ok",
"data": [
{
//私聊数据示例
"imBotId": "16888****6578438",
"wecomUserId": "zhangsan",
"imContactId": "788130****110143",
"externalUserId": "wmrRhyBgAA*******XBFhZyYxB_FF3Q",
"chatId": "6810a6fe365ca423b224a13d"
},
{
//群聊数据示例
"imBotId": "16888****6578438",
"wecomUserId": "zhangsan",
"wecomChatId": "wrrRhyBgAAC*****7P1xfuuM3bH44lQ",
"imRoomId": "R:107309****041976",
"chatId": "685191b8a****e2f315e056"
}
]
}修改于 2026-03-31 07:13:32