sixGuoDjango/wechat_项目工具包/企业微信工具包/客户标签管理工具.py

"""客户标签管理工具"""
import os

import django

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 datetime

import jmespath
import requests

from requests import post


class wecom管理企业标签:
    """
    管理企业标签
    最后更新：2023/12/01
    企业客户标签是针对企业的外部联系人进行标记和分类的标签，由企业统一配置后，企业成员可使用此标签对客户进行标记。
    """

    @classmethod
    def 获取企业标签库(cls):
        """
        在这里返回结果为:企业微信创建的所有的企业标签,不包含个人标签
        企业可通过此接口获取企业客户标签详情。请求方式: POST(HTTP)
        """
        pass
        wecom_token = sixToken.get_wecom_token()
        uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token={wecom_token}"
        data = post(url=uri).json()
        print(data)
        tag_group = jmespath.search(data=data, expression="tag_group")
        for tag in tag_group:
            print(tag)

        return data

    @classmethod
    def 添加企业客户标签(cls):
        """
        企业可通过此接口向客户标签库中添加新的标签组和标签，每个企业最多可配置10000个企业标签。
        注意:
        1.  如果要向指定的标签组下添加标签，需要填写group_id参数；
        2.  如果要创建一个全新的标签组以及标签，则需要通过group_name参数指定新标签组名称，
        3.  如果填写的groupname已经存在，则会在此标签组下新建标签。
        4.  如果填写了group_id参数，则group_name和标签组的order参数会被忽略。
        不支持创建空标签组。
        标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。
        :return:
        :rtype:
        """
        wecom_token = sixToken.get_wecom_token()
        uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token={wecom_token}"
        请求数据示例 = {
            "group_id": "etj4zANAAA1Zh_RyLIpjOr6IbuMPRB8g",  # 否	标签组id
            # "group_name": "泰州市",  # 否	标签组名称，最长为30个字符
            "order": 1,
            "tag": [
                {
                    "name": "未知",  # 是	添加的标签名称，最长为30个字符
                    "order": 1,  # 否	标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
                    },
                ],
            # "agentid": 1000014,  # 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
            }
        data = post(url=uri, json=请求数据示例).json()
        print(data)

    @classmethod
    def 编辑客户企业标签(cls, userid: str, external_userid: str, add_tag: str):
        """
        企业可通过此接口为指定成员的客户添加上由企业统一配置的标签；注意，每个成员对同一个客户最多可以添加3000个标签。
        :return:
        :rtype:
        """

        wecom_token = sixToken.get_wecom_token()
        uri = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token={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)

    @classmethod
    def 更新所有的企业标签并存储到数据库(cls):
        pass
        data = cls.获取企业标签库()
        tag_group = jmespath.search(data=data, expression="tag_group", )
        for tag_list in tag_group:
            print(tag_list)
            # tag_list = jmespath.search(data=tag_list, expression="tag", )
            group_id = jmespath.search(data=tag_list, expression="group_id", )
            group_name = jmespath.search(data=tag_list, expression="group_name", )
            create_time = jmespath.search(data=tag_list, expression="create_time", )
            # create_time = pydash.get(obj=tag_list, path="create_time", )
            # 需要将时间戳转为时间格式
            print(create_time, "========", )
            create_time_1 = datetime.datetime.fromtimestamp(create_time)
            #

            tag_child_list = jmespath.search(data=tag_list, expression="tag", )

    @classmethod
    def 更新所有的用户性别组标签(cls):
        pass

    @classmethod
    def 打标签性别(cls, 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:
            cls.编辑客户企业标签(
                userid=userid, external_userid=external_userid,
                add_tag="et74kdKAAAO9rCHIG-GcT7ZU_gsTslkg",
                )
        if gender == 2:
            cls.编辑客户企业标签(
                userid=userid, external_userid=external_userid,
                add_tag="et74kdKAAAJUou62OZwyu3LeavfmxAhw",
                )
        if gender == 0:
            cls.编辑客户企业标签(
                userid=userid, external_userid=external_userid,
                add_tag="et74kdKAAAI_VNWc-Gzakmo_jGnK-Glw",
                )

    def 给个微好友打标签(self):
        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"] # 删除企业微信好友的 标签
            }
        wecom_token = sixToken.get_wecom_token()
        response_data = requests.post(url=uri, params={"access_token": wecom_token}, json=请求数据)
        print(response_data.json())


if __name__ == '__main__':
    pass
    wecom管理企业标签.获取企业标签库()
    # wecom管理企业标签.添加企业客户标签()
    # wecom管理企业标签.更新所有的用户性别组标签()
    # wecom管理企业标签.更新所有的企业标签并存储到数据库()
    # wecom管理企业标签.获取企业标签库()
    # wecom管理企业标签().给个微好友打标签()