分配离职成员的客户

POST

http://127.0.0.1/cgi-bin/externalcontact/resigned/transfer_customer

最后修改时间：2022-08-30 03:03:36

责任人：未设置

企业可通过此接口，分配离职成员的客户给其他成员。

handover_userid必须是已离职用户。
external_userid必须是handover_userid的客户（即配置了客户联系功能的成员所添加的联系人）。

权限说明：企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。第三方应用需拥有“企业客户权限->客户联系->离职分配”权限接替成员必须在此第三方应用或自建应用的可见范围内。接替成员需要配置了客户联系功能。接替成员需要在企业微信激活且已经过实名认证。

文档ID: 27272
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/94081
https://open.work.weixin.qq.com/api/doc/90001/90143/94100

请求参数

Query 参数

Body 参数application/json

示例

{
    "handover_userid": "zhangsan",
    "takeover_userid": "lisi",
    "external_userid": [
        "woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB",
        "woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/externalcontact/resigned/transfer_customer?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "handover_userid": "zhangsan",
    "takeover_userid": "lisi",
    "external_userid": [
        "woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB",
        "woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA"
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "string",
    "customer": [
        {
            "errcode": 0,
            "external_userid": "string"
        }
    ]
}

修改于 2022-08-30 03:03:36

获取待分配的离职成员列表

查询客户接替状态