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 지원하며 나머지 버전은 테스트되지 않습니다.

파이썬 라이브러리가 현재 릴리스되었으며 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 목록

• 두 개의 등록없이 "인터페이스 확인"및 "메시지 수신"의 URL 부분을 병합하십시오.
• 임시 리소스 업로드를 구현하여 임의의 음성 또는 비디오와 같은 멀티미디어 메시지를 보낼 수 있습니다.
• 더 많은 응용 프로그램 메시지 유형을 지원합니다
• 메시지의 정의와 변환을 더 우아하게 만듭니다
• 파이썬 라이브러리로 만들어졌습니다. 이것은 지금 충분히 우아하지 않습니다
• CORP_ID 및 기타 매개 변수를 얻는 방법을 포함하여 DOC 및 README 향상 (더 이상 글을 쓰지 않고 게으른다. 총 몇 개의 인터페이스 만있다.

설명

코드는 원하는대로 업데이트됩니다. 주로 공간이 있는지 여부에 따라 다릅니다. 일반적으로 주말에 자주 업데이트됩니다.