WeWorkBot

Weworkbot

Le robot construit pour les applications auto-construites d'entreprise WeChat peut réaliser une réponse passive et l'envoi actif de différents types de messages.

Maintenant soutenu:

• Recevoir et les types de messages traités tels que le texte ( text ), l'image ( image ), la voix ( voice ), la vidéo ( video ), l'emplacement ( location ) et le lien ( link );
• Réponse passive avec des types de messages tels que text , image , voice , video et news ;
• Envoyez activement des messages d'application avec des types de messages tels que text , image , voice , video , markdown , du texte graphique ( mpnews ), du texte graphique ( news ), de la carte texte ( textcard ), du fichier ( file ) et d'autres types de messages;
• Gestion du matériel de fichiers, y compris le téléchargement de fichiers temporaires, le téléchargement d'images, le téléchargement de fichiers, le téléchargement de fichiers, etc.;
• Des fonctions telles que le lancement de chats de groupe, la modification des informations de chat de groupe, l'obtention de sessions de chat de groupe et l'envoi de messages de candidature aux chats de groupe (pour des restrictions spécifiques, veuillez vous référer au document officiel);

compter sur

Il n'y a pas beaucoup de bibliothèques qui dépendent, veuillez vous référer aux requirements.txt .

Installer

Prend en charge Python >= 3.9 , les autres versions ne sont pas testées.

La bibliothèque Python est maintenant publiée et peut être installée via pip install wwbot .

Exemple de code

L'exemple de code suivant montre l'utilisation simple de WeWorkBot . Cet exemple montre comment répondre à un message d' un type de texte ( 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 )

Pour des exemples plus complets, veuillez vous référer aux exampls/echo_bot.py .

Liste de TOD

• Fusionner les parties de l'URL de la «vérification de l'interface» et de la «réception de messages» sans deux inscriptions
• Implémentez les téléchargements de ressources temporaires, afin que vous puissiez envoyer des messages multimédias tels que la voix ou la vidéo arbitraire
• Prise en charge de plus de types de messages d'application
• Rendre la définition et la transformation des messages plus élégants
• Créé dans une bibliothèque Python. Ce n'est pas assez élégant maintenant
• Améliorez Doc et ReadMe, y compris les méthodes pour obtenir CORP_ID et d'autres paramètres (Je n'écrit plus, je suis paresseux. Il n'y a que quelques interfaces au total, ce qui ne suffit pas du tout)

illustrer

Le code est mis à jour comme vous le souhaitez, dépend principalement de la question de savoir s'il y a un espace ou non. Il sera généralement mis à jour fréquemment le week-end.