文档中心 > API类目 > 千牛接口

taobao.qiannniu.bcpush.subcribers.manage (私域运营-客户管理)

客服主管使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sex Number 可选 1 性别
trade_amount_end Number 可选 22 购买金额最大值
trade_time_start String 可选 2017-01-01 购买日期最小值
birthday_end Number 可选 12 截止月份
subscriber_nick String 可选 客户1 搜索的客户昵称
trade_count_start Number 可选 22 最小购买次数
page Number 可选 1 要取的页
trade_time_end String 可选 2018-01-01 购买日期最大值
grades Number [] 可选 1,2
  • 最大列表长度:20
  • 等级
    labels String [] 可选 11,22
  • 最大列表长度:20
  • 用户标签
    page_size Number 可选 10 每页个数
    trade_amount_start Number 可选 11 购买金额最小值
    birthday_start Number 可选 1 开始月份
    relation_manager_nick String 可选 商家测试帐号22 管理客服nick
    only_un_managed_subscribers Boolean 可选 true 只查询还没有客服管理的客户
    relation_manager_id Number 可选 12123 客服id
    last_contact_time_start Number 可选 1231231231 客服最近联系客户时间,开始
    last_contact_time_end Number 可选 1231231231 客服最近联系客户时间,结束
    last_reply_time_start Number 可选 1231231231 客户回复客服时间,开始
    last_reply_time_end Number 可选 1231231231 客户回复客服时间,结束
    status_gmt_modified_start Number 可选 1231231231 客户关系建立时间,开始
    status_gmt_modified_end Number 可选 1231231231 客户关系建立时间,结束
    order_by String 可选 last_trade_time 排序字段: last_contacted_ts-最近联系时间, last_trade_time-最近交易时间 status_gmt_modified-关系建立时间
    order_by_asc Boolean 可选 true 排序的升序和降序 true : 升序 false:降序
    tag String 可选 red 标记 红 red 黄 yellow 蓝 blue 绿 green
    crowd_tag_list String [] 可选 buy_prefer --是否爱购买(是否剁手党) share_prefer --是否爱分享 remark_prefer --是否爱评价 gift_prefer --是否爱赠品 discount_prefer --是否爱折扣 cashback_prefer--是否爱返现
  • 最大列表长度:20
  • 人群标签
    crowd_cart_tag_list String [] 可选 new_prefer --是否爱上新 price_expensive --是否高客单价 price_sensitive --是否价格明感 live_prefer --是否爱直播 weitao_prefer --是否爱微淘 group_chat_prefer --是否爱群聊 buyer_show_prefer --是否爱买家秀
  • 最大列表长度:20
  • 类目人群标签
    trade_count_end Number 可选 10 最大购买次数

    响应参数

    名称 类型 示例值 描述
    result ResultTo result
    • └ error_message
    • String
    • demo
    • errorMessage
    • module
    • PagingDo
    • module
    • └ total_count
    • Number
    • 1000
    • 总个数
    • └ page_size
    • Number
    • 10
    • 每页个数
    • └ current_page
    • Number
    • 1
    • 当前页
    • datas
    • BotsUserSubscribeRelationDo []
    • json
    • 见https://lark.alipay.com/zdf5hu/technote/bzng8b#qmgnye
    • └ birthday
    • Number
    • 40
    • 生日
    • └ sex
    • Number
    • 20
    • 性别
    • └ visible
    • Number
    • 40
    • 在千牛端是否可见
    • └ status_gmt_modified
    • Date
    • 1524710372812
    • 关系建立时间
    • └ label_ids
    • String
    • KxsulTK
    • cem标签
    • └ status
    • Number
    • 40
    • 状态
    • └ tag
    • String
    • RaFtFTW
    • 客服号tag
    • └ relation_manager_nick
    • String
    • noEBkoW
    • 客服nick
    • └ last_reply_ts
    • Date
    • 1524710372812
    • 最近回复时间
    • └ un_subscribe_reason
    • String
    • FjywnOf
    • unSubscribeReason
    • └ subscriber_nick
    • String
    • GLurtTv
    • 买家nick
    • └ today_first_contacted_ts
    • Date
    • 1524710372812
    • 今天首次联系时间
    • └ relation_manager_id
    • Number
    • 722216739239316480
    • 客服id
    • └ trade_count
    • Number
    • 7342747524062553088
    • 交易次数
    • └ bot_account_id
    • Number
    • 7546255004503460864
    • 卖家id
    • └ contact_status
    • Number
    • 0
    • 可联系状态
    • └ last_trade_time
    • Date
    • 1524710372812
    • 最近交易时间
    • └ subscriber_id
    • Number
    • 7599772168496980992
    • 买家id
    • └ config
    • String
    • BTgNWsR
    • config
    • └ grade
    • Number
    • 38
    • 等级
    • └ bot_nick
    • String
    • xEzCLdP
    • botNick
    • └ last_contacted_ts
    • Date
    • 1524710372812
    • 最近联系时间
    • └ trade_amount
    • Number
    • 3131402863988350976
    • 交易金额
    • └ sales_leads_task_contents
    • String []
    • 销售线索
    • └ crowd_tags
    • String
    • buy_prefer --是否爱购买(是否剁手党) share_prefer --是否爱分享 remark_prefer --是否爱评价 gift_prefer --是否爱赠品 discount_prefer --是否爱折扣 cashback_prefer--是否爱返现
    • 人群标签
    • └ crowd_cart_tags
    • String
    • new_prefer --是否爱上新 price_expensive --是否高客单价 price_sensitive --是否价格明感 live_prefer --是否爱直播 weitao_prefer --是否爱微淘 group_chat_prefer --是否爱群聊 buyer_show_prefer --是否爱买家秀
    • 行业人群标签
    • └ total_page
    • Number
    • 100
    • 总页数
    • └ error_code
    • Number
    • 123
    • errorCode
    • └ success
    • Boolean
    • false
    • success
    • attachment
    • Attachment
    • {"is_invited":"false"}
    • 附加属性,做非页面展示内容支持
    • └ is_invited
    • String
    • false
    • 最近31天是否有做过新手邀请

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    QiannniuBcpushSubcribersManageRequest req = new QiannniuBcpushSubcribersManageRequest();
    req.setSex(1L);
    req.setTradeAmountEnd(22L);
    req.setTradeTimeStart("2017-01-01");
    req.setBirthdayEnd(12L);
    req.setSubscriberNick("客户1");
    req.setTradeCountStart(22L);
    req.setPage(1L);
    req.setTradeTimeEnd("2018-01-01");
    req.setGrades("1,2");
    req.setLabels("11,22");
    req.setPageSize(10L);
    req.setTradeAmountStart(11L);
    req.setBirthdayStart(1L);
    req.setRelationManagerNick("商家测试帐号22");
    req.setOnlyUnManagedSubscribers(true);
    req.setRelationManagerId(12123L);
    req.setLastContactTimeStart(1231231231L);
    req.setLastContactTimeEnd(1231231231L);
    req.setLastReplyTimeStart(1231231231L);
    req.setLastReplyTimeEnd(1231231231L);
    req.setStatusGmtModifiedStart(1231231231L);
    req.setStatusGmtModifiedEnd(1231231231L);
    req.setOrderBy("last_trade_time");
    req.setOrderByAsc(true);
    req.setTag("red");
    req.setCrowdTagList("buy_prefer   --是否爱购买(是否剁手党) share_prefer  --是否爱分享 remark_prefer --是否爱评价 gift_prefer --是否爱赠品 discount_prefer --是否爱折扣 cashback_prefer--是否爱返现");
    req.setCrowdCartTagList("new_prefer --是否爱上新 price_expensive  --是否高客单价 price_sensitive --是否价格明感 live_prefer --是否爱直播 weitao_prefer --是否爱微淘 group_chat_prefer --是否爱群聊 buyer_show_prefer --是否爱买家秀");
    req.setTradeCountEnd(10L);
    QiannniuBcpushSubcribersManageResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <qiannniu_bcpush_subcribers_manage_response>
        <result>
            <error_message>demo</error_message>
            <module>
                <total_count>1000</total_count>
                <page_size>10</page_size>
                <current_page>1</current_page>
                <datas>
                    <bots_user_subscribe_relation_do>
                        <birthday>40</birthday>
                        <sex>20</sex>
                        <visible>40</visible>
                        <status_gmt_modified>1524710372812</status_gmt_modified>
                        <label_ids>KxsulTK</label_ids>
                        <status>40</status>
                        <tag>RaFtFTW</tag>
                        <relation_manager_nick>noEBkoW</relation_manager_nick>
                        <last_reply_ts>1524710372812</last_reply_ts>
                        <un_subscribe_reason>FjywnOf</un_subscribe_reason>
                        <subscriber_nick>GLurtTv</subscriber_nick>
                        <today_first_contacted_ts>1524710372812</today_first_contacted_ts>
                        <relation_manager_id>722216739239316480</relation_manager_id>
                        <trade_count>7342747524062553088</trade_count>
                        <bot_account_id>7546255004503460864</bot_account_id>
                        <contact_status>0</contact_status>
                        <last_trade_time>1524710372812</last_trade_time>
                        <subscriber_id>7599772168496980992</subscriber_id>
                        <config>BTgNWsR</config>
                        <grade>38</grade>
                        <bot_nick>xEzCLdP</bot_nick>
                        <last_contacted_ts>1524710372812</last_contacted_ts>
                        <trade_amount>3131402863988350976</trade_amount>
                        <sales_leads_task_contents>
                            <string></string>
                        </sales_leads_task_contents>
                        <crowd_tags>buy_prefer   --是否爱购买(是否剁手党) share_prefer  --是否爱分享 remark_prefer --是否爱评价 gift_prefer --是否爱赠品 discount_prefer --是否爱折扣 cashback_prefer--是否爱返现</crowd_tags>
                        <crowd_cart_tags>new_prefer --是否爱上新 price_expensive  --是否高客单价 price_sensitive --是否价格明感 live_prefer --是否爱直播 weitao_prefer --是否爱微淘 group_chat_prefer --是否爱群聊 buyer_show_prefer --是否爱买家秀</crowd_cart_tags>
                    </bots_user_subscribe_relation_do>
                </datas>
                <total_page>100</total_page>
            </module>
            <error_code>123</error_code>
            <success>false</success>
            <attachment>
                <is_invited>false</is_invited>
            </attachment>
        </result>
    </qiannniu_bcpush_subcribers_manage_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部