WeWorkBot

WeWorkbot

Робот, созданный для предприятия, построенных в приложениях WeChat, может реализовать пассивный ответ и активную отправку различных типов сообщений.

Теперь поддерживается:

• Получать и обработанные типы сообщений, такие как текст ( text ), изображение ( image ), голос ( voice ), видео ( video ), местоположение ( location ) и ссылка ( link );
• Пассивный ответ с типами сообщений, такими как text , image , voice , video и news ;
• Активная отправка сообщений приложения с типами сообщений, такими как text , image , voice , video , markdown , графический текст ( mpnews ), графический текст ( news ), текстовая карточка ( textcard ), файл ( file ) и другие типы сообщений;
• Управление материалами файла, включая загрузку временных файлов, загрузку изображений, асинхронную загрузку файлов, загрузку файлов и т. Д.;
• Такие функции, как инициирование групповых чатов, изменение информации о групповом чате, получение групповых сессий чата и отправка сообщений приложений в групповые чаты (для конкретных ограничений, пожалуйста, обратитесь к официальному документу);

полагаться

Есть не так много библиотек, от которых зависят, пожалуйста, обратитесь к requirements.txt .

Установить

В настоящее время поддерживает Python >= 3.9 , остальные версии не проверены.

Библиотека Python теперь выпускается и может быть установлена ​​через pip install wwbot .

Пример кода

На следующем примере кода показано простое использование WeWorkBot . В этом примере показано, как ответить на сообщение типа текста ( text ):

 from flask import Flask
from wwbot import WWBot
from wwbot . msg import Message , TextMessage

# 注册一个文本消息的事件监听
@ WWBot . on ( WWBot . TEXT )
def text_handler ( msg : TextMessage ) -> Message :
    '''
    msg参数代表接收到的消息被解析后的实例
    '''
    # 从消息中提取消息内容字段
    # 关于接收到的消息格式具体定义，参考 https://developer.work.weixin.qq.com/document/path/90239
    msg_content : str = msg . content
    # 作为示例，直接使用接收到的消息作为回复，相当于一个 echo bot
    return TextMessage ( msg . from_username , msg . to_username , msg . agent_id , msg_content )

# WeWorkBot运行在Flask框架之上
app : Flask = Flask ( 'WWBot' )
# 企业ID 
corp_id : str = 'corp_id'
# 企业自建应用的secret 可以创建自建应用后在应用详情页面查看
corp_secret : str = 'corp_secret'
# 自建应用启用API接收消息时，配置的“Token”参数
token : str = 'token'
# 自建应用启用API接收消息时，配置的“EncodingAESKey”参数
aes_key : bytes = base64 . b64decode ( 'aes_key' )
# 接收消息回调时的url path部分
callback_path : str = '/wwbot'

# 配置机器人
WWBot . config ( app , corp_id , corp_secret , token , aes_key , callback_path = callback_path )

if __name__ == '__main__' :
    app . run ( '0.0.0.0' , 31221 )

Для получения более полных примеров, пожалуйста, обратитесь к exampls/echo_bot.py .

Список Тодо

• Объединить части URL -адреса «проверки интерфейса» и «прием сообщений» без двух регистраций
• Реализовать временные загрузки ресурсов, чтобы вы могли отправлять мультимедийные сообщения, такие как произвольный голос или видео
• Поддержать больше типов сообщений приложения
• Сделайте определение и преобразование сообщений более элегантными
• Создано в библиотеку Python. Сейчас это недостаточно элегантно
• Улучшение DOC и README, включая методы получения CORP_ID и других параметров (Больше не пишу, я ленивый. Всего есть всего несколько интерфейсов, чего вообще недостаточно, чтобы писать)

иллюстрировать

Код обновляется, как вам нравится, в основном зависит от того, есть ли место или нет. Обычно он часто обновляется по выходным.