149 lines
6.5 KiB
Python
149 lines
6.5 KiB
Python
"""客户标签管理工具"""
|
|
import os
|
|
|
|
import django
|
|
from pydantic import BaseModel, Field
|
|
|
|
from sixGuoDjango.settings import BASE_DIR
|
|
from wechat_token.token工具包 import sixToken
|
|
|
|
os.environ.setdefault(key="DJANGO_SETTINGS_MODULE", value=f"{BASE_DIR.name}.settings")
|
|
django.setup()
|
|
|
|
import jmespath
|
|
import requests
|
|
|
|
from requests import post
|
|
|
|
|
|
class wecom管理企业标签(BaseModel):
|
|
"""
|
|
管理企业标签
|
|
最后更新：2023/12/01
|
|
企业客户标签是针对企业的外部联系人进行标记和分类的标签，由企业统一配置后，企业成员可使用此标签对客户进行标记。
|
|
"""
|
|
wecom_token: str = sixToken.get_wecom_token()
|
|
agentid: str = Field(default="1000025", description="agentid")
|
|
|
|
def 获取企业标签库(self, ):
|
|
"""
|
|
在这里返回结果为:企业微信创建的所有的企业标签,不包含个人标签
|
|
企业可通过此接口获取企业客户标签详情。请求方式: POST(HTTP)
|
|
"""
|
|
pass
|
|
uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token={self.wecom_token}"
|
|
data = post(url=uri).json()
|
|
tag_group = jmespath.search(data=data, expression="tag_group")
|
|
for tag in tag_group:
|
|
print(tag)
|
|
|
|
return data
|
|
|
|
def 添加企业客户标签(self):
|
|
"""
|
|
企业可通过此接口向客户标签库中添加新的标签组和标签，每个企业最多可配置10000个企业标签。
|
|
注意:
|
|
1. 如果要向指定的标签组下添加标签，需要填写group_id参数；
|
|
2. 如果要创建一个全新的标签组以及标签，则需要通过group_name参数指定新标签组名称，
|
|
3. 如果填写的groupname已经存在，则会在此标签组下新建标签。
|
|
4. 如果填写了group_id参数，则group_name和标签组的order参数会被忽略。
|
|
不支持创建空标签组。
|
|
标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。
|
|
:return:
|
|
:rtype:
|
|
"""
|
|
uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token={self.wecom_token}"
|
|
请求数据示例 = {
|
|
"group_name": "我的新标签组",
|
|
"order": 1,
|
|
"tag": [
|
|
{"name": "标签1", "order": 1},
|
|
{"name": "标签2", "order": 2}
|
|
]
|
|
}
|
|
data = post(url=uri, json=请求数据示例).json()
|
|
print(data)
|
|
|
|
def 编辑客户企业标签(self, userid: str, external_userid: str, add_tag: str):
|
|
"""
|
|
企业可通过此接口为指定成员的客户添加上由企业统一配置的标签；注意，每个成员对同一个客户最多可以添加3000个标签。
|
|
:return:
|
|
:rtype:
|
|
"""
|
|
|
|
uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token={self.wecom_token}"
|
|
请求数据示例 = {
|
|
# "userid": "YuanBao1975", # 是 添加外部联系人的userid
|
|
"userid": userid, # 是 添加外部联系人的userid
|
|
# "external_userid": "wmj4zANAAAGlCZ2zNRhu1qzEMSBF0a9gs", # 这里测试的是葫芦娃本人的标签
|
|
"external_userid": external_userid, # 这里测试的是葫芦娃本人的标签
|
|
# "add_tag": ["etj4zANAAAGtArlV00IwBWzIqinXf5vQ"], # 要添加的标签列表一定要填写🆔(对某一个用户添加某些标签)
|
|
"add_tag": [add_tag], # 要添加的标签列表一定要填写🆔(对某一个用户添加某些标签)
|
|
# "remove_tag": [] # 要移除的标签列表(对某一个用户移除某些标签)
|
|
}
|
|
data = post(url=uri, json=请求数据示例).json()
|
|
print(data)
|
|
|
|
def 删除企业客户标签(self, 标签组ID, 标签子标签ID=None):
|
|
pass
|
|
"""删除已经创建的 企业标签 tag_id和group_id不可同时为空。如果一个标签组下所有的标签均被删除，则标签组会被自动删除"""
|
|
uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/del_corp_tag?access_token={self.wecom_token}"
|
|
删除的数据 = {
|
|
# "tag_id": [],
|
|
"group_id": [标签组ID],
|
|
}
|
|
postData = requests.post(url=uri, json=删除的数据)
|
|
print(postData.text)
|
|
# print(postData.json())
|
|
|
|
def 更新所有的用户性别组标签(self):
|
|
pass
|
|
|
|
def 打标签性别(self, userid: str, external_userid: str, gender: int):
|
|
"""
|
|
:param gender:
|
|
:type gender:
|
|
:param userid:
|
|
:type userid:
|
|
:param external_userid:
|
|
:type external_userid:
|
|
"""
|
|
print("单独更新用户性别标签")
|
|
if gender == 1:
|
|
self.编辑客户企业标签(
|
|
userid=userid, external_userid=external_userid,
|
|
add_tag="et74kdKAAAO9rCHIG-GcT7ZU_gsTslkg",
|
|
)
|
|
if gender == 2:
|
|
self.编辑客户企业标签(
|
|
userid=userid, external_userid=external_userid,
|
|
add_tag="et74kdKAAAJUou62OZwyu3LeavfmxAhw",
|
|
)
|
|
if gender == 0:
|
|
self.编辑客户企业标签(
|
|
userid=userid, external_userid=external_userid,
|
|
add_tag="et74kdKAAAI_VNWc-Gzakmo_jGnK-Glw",
|
|
)
|
|
|
|
def 给个微好友打标签(self, userID企微员工账号, external_userid要打标签的好友ID, add_tag要给好友添加的标签ID, remove_tag要对好友删除的标签ID=None):
|
|
if remove_tag要对好友删除的标签ID is None:
|
|
remove_tag要对好友删除的标签ID = []
|
|
pass
|
|
uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag"
|
|
请求数据 = {
|
|
"userid": "YuanBao",
|
|
"external_userid": "wm74kdKAAAwE4T5vvLoUgHq9dEu7eTgA", # 给小豆豆测试打标签
|
|
"add_tag": ["et74kdKAAAO9rCHIG-GcT7ZU_gsTslkg"], # 测试标签ID
|
|
# "remove_tag": ["et74kdKAAAO9rCHIG-GcT7ZU_gsTslkg"] # 删除企业微信好友的 标签
|
|
}
|
|
response_data = requests.post(url=uri, params={"access_token": self.wecom_token}, json=请求数据)
|
|
print(response_data.json())
|
|
|
|
|
|
if __name__ == '__main__':
|
|
pass
|
|
|
|
wecom管理企业标签().获取企业标签库()
|
|
# wecom管理企业标签().删除企业客户标签(标签组ID="etj4zANAAA1Zh_RyLIpjOr6IbuMPRB8g")
|
|
# wecom管理企业标签().添加企业客户标签()
|