WeWorkBot

Weworkbot

Der Roboter, der für selbstgebaute Unternehmensanwendungen erstellt wurde, kann die passive Antwort und das aktive Senden verschiedener Arten von Nachrichten realisieren.

Jetzt unterstützt:

• Empfangen und verarbeitete Nachrichtentypen wie Text ( text ), Bild ( image ), Sprache ( voice ), Video ( video ), Ort ( location ) und Link ( link );
• Passive Antwort mit Nachrichtentypen wie text , image , voice , video und news ;
• Senden Sie aktiv Anwendungsnachrichten mit Nachrichtentypen wie text , image , voice , video , markdown , Grafiktext ( mpnews ), Grafiktext ( news ), Textkarte ( textcard ), Datei ( file ) und anderen Nachrichtentypen.
• Dateimaterialverwaltung, einschließlich Hochladen temporärer Dateien, Hochladen von Bildern, asynchronem Hochladen von Dateien, Herunterladen von Dateien usw.;
• Funktionen wie das Initiieren von Gruppenchats, das Ändern von Gruppen -Chat -Informationen, das Erhalten von Gruppen -Chat -Sitzungen und das Senden von Bewerbungsnachrichten an Gruppen -Chats (für bestimmte Einschränkungen finden Sie im offiziellen Dokument).

verlassen

Es gibt nicht viele Bibliotheken, von denen abhängig ist, bitte beziehen Sie sich auf requirements.txt .

Installieren

Derzeit unterstützt Python >= 3.9 , der Rest der Versionen werden nicht getestet.

Die Python -Bibliothek ist jetzt veröffentlicht und kann über pip install wwbot installiert werden.

Beispielcode

Der folgende Beispielcode zeigt die einfache Verwendung von WeWorkBot an. In diesem Beispiel wird angezeigt, wie Sie auf eine Nachricht eines Texttyps ( text ) antworten:

 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 )

Weitere Beispiele finden Sie unter exampls/echo_bot.py .

TODO -Liste

• Führen Sie die URL -Teile der "Schnittstellenüberprüfung" und "Nachrichtenempfang" ohne zwei Registrierungen zusammen
• Implementieren Sie temporäre Ressourcen -Uploads, damit Sie Multimedia -Nachrichten wie willkürliche Sprache oder Video senden können
• Unterstützen Sie mehr Anwendungsnachrichtentypen
• Machen Sie die Definition und Transformation von Nachrichten eleganter
• Erstellt in eine Python -Bibliothek. Dies ist jetzt nicht elegant genug
• Verbessern Sie DOC und Readme, einschließlich Methoden zum Erhalten von Corp_ID und anderen Parametern (Nicht mehr schreibe, ich bin faul. Es gibt insgesamt nur wenige Schnittstellen, was nicht ausreicht, um überhaupt zu schreiben)

veranschaulichen

Der Code wird wie Sie möchten, hängt hauptsächlich davon ab, ob Platz vorhanden ist oder nicht. Es wird normalerweise am Wochenende häufig aktualisiert.