QQ::weixin::work::externalcontact::customer_strategy
客户联系规则组管理 最后更新:2023/12/01
https://developer.work.weixin.qq.com/document/path/94883
获取规则组列表
https://developer.work.weixin.qq.com/document/path/94883#获取规则组列表
企业可通过此接口获取企业配置的所有客户规则组id列表。
{ "cursor":"CURSOR", "limit":1000 }
参数 必须 说明 access_token 是 调用接口凭证 cursor 否 分页查询游标,首次调用可不填 limit 否 分页大小,默认为1000,最大不超过1000
调用客户联系规则组接口的应用需要满足如下的权限:
应用类型 权限要求 自建应用 配置到「客户联系 可调用接口的应用」中 代开发应用 具有「管理客户联系规则组」权限 第三方应用 具有「管理客户联系规则组」权限
提示 应用仅能获取和管理由本应用创建的规则组
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
{ "errcode": 0, "errmsg": "ok", "strategy": [ { "strategy_id":1 }, { "strategy_id":2 } ], "next_cursor":"NEXT_CURSOR" }
参数 说明 errcode 返回码 errmsg 对返回码的文本描述内容 strategy_id 规则组id next_cursor 分页游标,用于查询下一个分页的数据,无更多数据时不返回
获取规则组详情
https://developer.work.weixin.qq.com/document/path/94883#获取规则组详情
企业可以通过此接口获取某个客户规则组的详细信息。
{ "strategy_id":1 }
参数 必须 说明 access_token 是 调用接口凭证 strategy_id 是 规则组id
{ "errcode": 0, "errmsg": "ok", "strategy": { "strategy_id":1, "parent_id":0, "strategy_name": "NAME", "create_time": 1557838797, "admin_list":[ "zhangsan", "lisi" ], "privilege": { "view_customer_list":true, "view_customer_data":true, "view_room_list":true, "contact_me":true, "join_room":true, "share_customer":false, "oper_resign_customer":true, "oper_resign_group":true, "send_customer_msg":true, "edit_welcome_msg":true, "view_behavior_data":true, "view_room_data":true, "send_group_msg":true, "room_deduplication":true, "rapid_reply":true, "onjob_customer_transfer":true, "edit_anti_spam_rule":true, "export_customer_list":true, "export_customer_data":true, "export_customer_group_list":true, "manage_customer_tag":true } } }
参数 说明 errcode 返回码 errmsg 对返回码的文本描述内容 strategy_id 规则组id parent_id 父规则组id, 如果当前规则组没父规则组,则为0 strategy_name 规则组名称 create_time 规则组创建时间戳 admin_list 规则组管理员userid列表 privilege.view_customer_list 查看客户列表,基础权限,不可取消 privilege.view_customer_data 查看客户统计数据,基础权限,不可取消 privilege.view_room_list 查看群聊列表,基础权限,不可取消 privilege.contact_me 可使用联系我,基础权限,不可取消 privilege.join_room 可加入群聊,基础权限,不可取消 privilege.share_customer 允许分享客户给其他成员,默认为true privilege.oper_resign_customer 允许分配离职成员客户,默认为true privilege.oper_resign_group 允许分配离职成员客户群,默认为true privilege.send_customer_msg 允许给企业客户发送消息,默认为true privilege.edit_welcome_msg 允许配置欢迎语,默认为true privilege.view_behavior_data 允许查看成员联系客户统计 privilege.view_room_data 允许查看群聊数据统计,默认为true privilege.send_group_msg 允许发送消息到企业的客户群,默认为true privilege.room_deduplication 允许对企业客户群进行去重,默认为true privilege.rapid_reply 配置快捷回复,默认为true privilege.onjob_customer_transfer 转接在职成员的客户,默认为true privilege.edit_anti_spam_rule 编辑企业成员防骚扰规则,默认为true privilege.export_customer_list 导出客户列表,默认为true privilege.export_customer_data 导出成员客户统计,默认为true privilege.export_customer_group_list 导出客户群列表,默认为true privilege.manage_customer_tag 配置企业客户标签,默认为true
如果规则组具有父规则组则其管理范围必须是父规则组的子集。
获取规则组管理范围
https://developer.work.weixin.qq.com/document/path/94883#获取规则组管理范围
企业可通过此接口获取某个客户规则组管理的成员和部门列表。
{ "strategy_id":1, "cursor":"CURSOR", "limit":1000 }
参数 必须 说明 access_token 是 调用接口凭证 strategy_id 是 规则组id cursor 否 分页游标 limit 否 每个分页的成员/部门节点数,默认为1000,最大为1000
{ "errcode": 0, "errmsg": "ok", "range": [ { "type":1, "userid":"zhangsan" }, { "type":2, "partyid":1 } ], "next_cursor":"NEXT_CURSOR" }
参数 说明 errcode 返回码 errmsg 对返回码的文本描述内容 range.type 节点类型,1-成员 2-部门 range.userid 管理范围内配置的成员userid,仅type为1时返回 item.partyid 管理范围内配置的部门partyid,仅type为2时返回 next_cursor 分页游标,用于查询下一个分页的数据,无更多数据时不返回
创建新的规则组
https://developer.work.weixin.qq.com/document/path/94883#创建新的规则组
企业可通过此接口创建一个新的客户规则组。该接口仅支持串行调用,请勿并发创建规则组。
{ "parent_id":0, "strategy_name": "NAME", "admin_list":[ "zhangsan", "lisi" ], "privilege": { "view_customer_list":true, "view_customer_data":true, "view_room_list":true, "contact_me":true, "join_room":true, "share_customer":false, "oper_resign_customer":true, "send_customer_msg":true, "edit_welcome_msg":true, "view_behavior_data":true, "view_room_data":true, "send_group_msg":true, "room_deduplication":true, "rapid_reply":true, "onjob_customer_transfer":true, "edit_anti_spam_rule":true, "export_customer_list":true, "export_customer_data":true, "export_customer_group_list":true, "manage_customer_tag":true }, "range": [ { "type":1, "userid":"zhangsan" }, { "type":2, "partyid":1 } ] }
参数 必须 说明 access_token 是 调用接口凭证 parent_id 否 父规则组id strategy_name 是 规则组名称 admin_list 是 规则组管理员userid列表,不可配置超级管理员,每个规则组最多可配置20个负责人 privilege.view_customer_list 否 查看客户列表,基础权限,不可取消 privilege.view_customer_data 否 查看客户统计数据,基础权限,不可取消 privilege.view_room_list 否 查看群聊列表,基础权限,不可取消 privilege.contact_me 否 可使用联系我,基础权限,不可取消 privilege.join_room 否 可加入群聊,基础权限,不可取消 privilege.share_customer 否 允许分享客户给其他成员,默认为true privilege.oper_resign_customer 否 允许分配离职成员客户,默认为true privilege.oper_resign_group 否 允许分配离职成员客户群,默认为true privilege.send_customer_msg 否 允许给企业客户发送消息,默认为true privilege.edit_welcome_msg 否 允许配置欢迎语,默认为true privilege.view_behavior_data 否 允许查看成员联系客户统计,默认为true privilege.view_room_data 否 允许查看群聊数据统计,默认为true privilege.send_group_msg 否 允许发送消息到企业的客户群,默认为true privilege.room_deduplication 否 允许对企业客户群进行去重,默认为true privilege.rapid_reply 否 配置快捷回复,默认为true privilege.onjob_customer_transfer 否 转接在职成员的客户,默认为true privilege.edit_anti_spam_rule 否 编辑企业成员防骚扰规则,默认为true privilege.export_customer_list 否 导出客户列表,默认为true privilege.export_customer_data 否 导出成员客户统计,默认为true privilege.export_customer_group_list 否 导出客户群列表,默认为true privilege.manage_customer_tag 否 配置企业客户标签,默认为true range.type 是 规则组的管理范围节点类型 1-成员 2-部门 range.userid 否 规则组的管理成员id range.partyid 否 规则组的管理部门id
单次最多可配置20个管理员和100个管理节点 如果要创建的规则组具有父规则组,则其管理范围必须是父规则组的子集,且将完全继承父规则组的权限配置(privilege将被忽略) 管理组的最大层级为5层 每个管理组的管理范围内最多支持3000个节点
{ "errcode": 0, "errmsg": "ok", "strategy_id":1 }
参数 说明 errcode 返回码 errmsg 对返回码的文本描述内容 strategy_id 规则组id
编辑规则组及其管理范围
https://developer.work.weixin.qq.com/document/path/94883#编辑规则组及其管理范围
企业可通过此接口编辑规则组的基本信息和修改客户规则组管理范围。该接口仅支持串行调用,请勿并发修改规则组。
{ "strategy_id":1, "strategy_name": "NAME", "admin_list":[ "zhangsan", "lisi" ], "privilege": { "view_customer_list":true, "view_customer_data":true, "view_room_list":true, "contact_me":true, "join_room":true, "share_customer":false, "oper_resign_customer":true, "oper_resign_group":true, "send_customer_msg":true, "edit_welcome_msg":true, "view_behavior_data":true, "view_room_data":true, "send_group_msg":true, "room_deduplication":true, "rapid_reply":true, "onjob_customer_transfer":true, "edit_anti_spam_rule":true, "export_customer_list":true, "export_customer_data":true, "export_customer_group_list":true, "manage_customer_tag":true }, "range_add": [ { "type":1, "userid":"zhangsan" }, { "type":2, "partyid":1 } ], "range_del": [ { "type":1, "userid":"lisi" }, { "type":2, "partyid":2 } ] }
参数 必须 说明 access_token 是 调用接口凭证 strategy_id 是 规则组id strategy_name 否 规则组名称 admin_list 否 管理员列表,如果为空则不对负责人做编辑,如果有则覆盖旧的负责人列表 privilege 否 权限配置,如果为空则不对权限做编辑,如果有则覆盖旧的权限配置 range_add.type 否 向管理范围添加的节点类型 1-成员 2-部门 range_add.userid 否 向管理范围添加成员的userid,仅type为1时有效 range_add.partyid 否 向管理范围添加部门的partyid,仅type为2时有效 range_del.type 否 从管理范围删除的节点类型 1-成员 2-部门 range_del.userid 否 从管理范围删除的成员的userid,仅type为1时有效 range_del.partyid 否 从管理范围删除的部门的partyid,仅type为2时有效
单次最多可配置20个管理员和100个管理节点 如果规则组具有父管理组则其管理范围必须是父规则组的子集,且将完全继承父规则组的权限配置(privilege将被忽略)
{ "errcode": 0, "errmsg": "ok" }
参数 说明 errcode 返回码 errmsg 对返回码的文本描述内容
删除规则组
https://developer.work.weixin.qq.com/document/path/94883#删除规则组
企业可通过此接口删除某个规则组。
To install QQ::weixin::work, copy and paste the appropriate command in to your terminal.
cpanm
cpanm QQ::weixin::work
CPAN shell
perl -MCPAN -e shell install QQ::weixin::work
For more information on module installation, please visit the detailed CPAN module installation guide.