WeWorkBot

WeWorkBot

Enterprise WeChatの自動構築アプリケーション向けに構築されたロボットは、さまざまな種類のメッセージの受動的な返信と積極的な送信を実現できます。

今サポートされています：

• テキスト（ text ）、画像（ image ）、音声（ voice ）、ビデオ（ video ）、場所（ location ）、リンク（ link ）などのメッセージタイプを受信および処理します。
• text 、 image 、 voice 、 video 、 newsなどのメッセージタイプを使用した受動的な返信。
• text 、 image 、 voice 、 video 、 markdown 、グラフィックテキスト（ mpnews ）、グラフィックテキスト（ news ）、テキストカード（ textcardカード）、ファイル（ file ）、その他のメッセージタイプなどのメッセージタイプを使用してアプリケーションメッセージを積極的に送信します。
• 一時的なファイルのアップロード、写真のアップロード、ファイルの非同期のアップロード、ファイルのダウンロードなど。
• グループチャットの開始、グループチャット情報の変更、グループチャットセッションの取得、グループチャットへのアプリケーションメッセージの送信などの機能（特定の制限については、公式ドキュメントを参照してください）。

頼る

依存するライブラリは多くありません。 requirements.txtを参照してください。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を参照してください。

TODOリスト

• 2つの登録なしで「インターフェイス検証」と「メッセージ受信」のURL部分をマージする
• 任意の音声やビデオなどのマルチメディアメッセージを送信できるように、一時的なリソースのアップロードを実装してください
• より多くのアプリケーションメッセージタイプをサポートします
• メッセージの定義と変換をよりエレガントにします
• Pythonライブラリに作成されました。これは今では十分にエレガントではありません
• corp_idやその他のパラメーターを取得する方法を含む、docとreadmeを改善する（もう書いていない、私は怠け者です。合計でいくつかのインターフェイスしかありません。これはまったく書くのに十分ではありません）

説明します

コードは、主にスペースがあるかどうかに依存します。通常、週末に頻繁に更新されます。