WeWorkBot

Weworkbot

O robô criado para aplicativos corporativos WECHAT auto-construídos pode realizar uma resposta passiva e o envio ativo de vários tipos de mensagens.

Agora suportado:

• Tipos de mensagens recebidos e processados, como texto ( text ), imagem ( image ), voz ( voice ), vídeo ( video ), localização ( location ) e link ( link );
• Resposta passiva com tipos de mensagens como text , image , voice , video e news ;
• Envie ativamente mensagens de aplicativo com tipos de mensagens como text , image , voice , video , markdown , texto gráfico ( mpnews ), texto gráfico ( news ), cartão de texto ( textcard ), arquivo ( file ) e outros tipos de mensagens;
• Gerenciamento de material de arquivo, incluindo o upload de arquivos temporários, carregando imagens, carregando de forma assíncrona, baixando arquivos, etc.;
• Funções como iniciar bate -papos em grupo, mudar as informações de bate -papo em grupo, obter sessões de bate -papo em grupo e enviar mensagens de aplicativo para bate -papos em grupo (para restrições específicas, consulte o documento oficial);

confiar

Não há muitas bibliotecas que dependem, consulte requirements.txt .

Instalar

Atualmente, suporta Python >= 3.9 , o restante das versões não é testado.

A biblioteca Python agora é lançada e pode ser instalada via pip install wwbot .

Código de amostra

O código de amostra a seguir mostra o uso simples do WeWorkBot . Este exemplo mostra como responder a uma mensagem de um tipo de texto ( 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 )

Para exemplos mais completos, consulte exampls/echo_bot.py .

Lista de tarefas

• Mesclar as partes da URL da "verificação da interface" e "recepção de mensagens" sem dois registros
• Implementar uploads temporários de recursos, para que você possa enviar mensagens multimídia, como voz arbitrária ou vídeo
• Apoiar mais tipos de mensagens de aplicativos
• Torne a definição e a transformação de mensagens mais elegantes
• Criado em uma biblioteca Python. Isso não é elegante o suficiente agora
• Melhore o DOC e o ReadMe, incluindo métodos para obter corp_id e outros parâmetros (Não escrevendo mais, sou preguiçoso. Existem apenas algumas interfaces no total, o que não é suficiente para escrever)

ilustrar

O código é atualizado como você quiser, depende principalmente se existe algum espaço ou não. Geralmente será atualizado com frequência nos fins de semana.