API接口文档

客户id置换接口

POST

https://aa-hub.ddregion.com/api/v1/customer/relation

通过此接口可以使用imContactId、unionId、externalUserId中的任意一个换到另外两个id以及添加的托管账号和群聊

请求参数

Query 参数

token

string

可选

Body 参数application/json

imContactId

string

客户imContactId

可选

unionId

string

客户unionId

可选

externalUserId

string

客户externalUserId

可选

示例

{
  "imContactId": "string",
  "unionId": "string",
  "externalUserId": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://aa-hub.ddregion.com/api/v1/customer/relation?token=' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

data

object

必需

orgId

string

企业id

必需

unionId

string

客户unionId

必需

externalUserIds

array [object {2}]

必需

imContactId

string

客户imContactId

必需

imBots

array [object {2}]

必需

wecomChatIds

array[string]

所在群聊

必需

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "orgId": "646d855d60c66476e70518g8",
    "unionId": "oDEUm6v-fp0TDLwTwS2CNVvVUgDA",
    "externalUserIds": [
      {
        "externalUserId": "wmrRhyBgAAO_U3HWMS928XTEEGY-rdzg",
        "corpId": "ww5ecc1acd5dc2568d"
      }
    ],
    "imContactId": "7881301204958266",
    "imBots": [
      {
        "imBotId": "1688858069965437",
        "wxUserId": "name"
      }
    ],
    "wecomChatIds": [
      "wrrRhyBgAAvrrmMWV3LS342wH-IDyQWg",
      "wrrRhyBgAAsa5CoqzikjuxElryrxWedQ",
      "wrrRhyBgAAlYQ52L47pVtXfwoC-c12_Q"
    ]
  }
}

修改于 2025-01-09 16:58:26

修改备注

客户同步接口