创建新老分流码

POST

/open-api/new_old_contact_way/create

同步创建新老分流码并进入默认分组。operate_ext_id 用于记录创建人。
新客户入群时传自动拉群任务 ID，服务端解析实际业务码 ID 和 join_group_type。
短链生成失败不回滚创建结果，此时 short_link 为 null，并返回 warnings。

请求参数

Query 参数

Body 参数application/json必填

示例

新老客户分别打开网页新客户进入群二维码自动拉群任务

{
    "name": "官网分流",
    "operate_ext_id": "zhangsan",
    "old_user_config": {
        "add_type": "user",
        "filter_type": "any",
        "open_type": "link",
        "msg_data": {
            "msg_type": "link",
            "url": "https://www.example.com/old-user"
        }
    },
    "new_user_config": {
        "add_type": "link",
        "show_type": "default",
        "link_url": "https://www.example.com/new-user",
        "display_text": "继续访问"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

新老客户分别打开网页新客户进入群二维码自动拉群任务

curl --location --globoff 'https://open.weibanzhushou.com/open-api/new_old_contact_way/create?access_token=' \
--header 'Content-Type: application/json' \
--data '{
    "name": "官网分流",
    "operate_ext_id": "zhangsan",
    "old_user_config": {
        "add_type": "user",
        "filter_type": "any",
        "open_type": "link",
        "msg_data": {
            "msg_type": "link",
            "url": "https://www.example.com/old-user"
        }
    },
    "new_user_config": {
        "add_type": "link",
        "show_type": "default",
        "link_url": "https://www.example.com/new-user",
        "display_text": "继续访问"
    }
}'

返回响应

🟢200

application/json

成功或业务失败

Bodyapplication/json

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "id": 17001,
        "name": "官网分流",
        "creator": {
            "id": 9001,
            "ext_id": "zhangsan",
            "name": "张三",
            "avatar": "https://cdn.example.com/avatar.png"
        },
        "created_at": 1785830400,
        "origin_url": "https://ugc.example.com/api/new_old_contact_way/entry?qr_id=17001&_c=example",
        "short_link": "https://s.example.com/a1b2c3",
        "share_link": "https://s.example.com/a1b2c3",
        "old_user_config": {
            "add_type": "user",
            "filter_type": "any",
            "staff_ext_id_list": [],
            "department_ext_id_list": [],
            "group_ext_id_list": [],
            "open_type": "link",
            "msg_data": {
                "msg_type": "link",
                "url": "https://www.example.com/old-user"
            },
            "staff_list": [],
            "department_list": [],
            "group_list": []
        },
        "new_user_config": {
            "add_type": "link",
            "show_type": "default",
            "contact_way_id": null,
            "link_url": "https://www.example.com/new-user",
            "display_text": "继续访问",
            "poster_url": "",
            "qr_size": null,
            "qr_x": null,
            "qr_y": null,
            "target": null
        }
    }
}

修改于 2026-08-19 08:01:29

查询回款单详情

更新新老分流码