WeWorkBot

Weworkbot

El robot creado para aplicaciones de auto-construido de WeChat Enterprise puede realizar una respuesta pasiva y el envío activo de varios tipos de mensajes.

Ahora compatible:

• Recibir y procesar tipos de mensajes como texto ( text ), imagen ( image ), voz ( voice ), video ( video ), ubicación ( location ) y enlace ( link );
• Respuesta pasiva con tipos de mensajes como text , image , voice , video y news ;
• Envíe activamente mensajes de aplicación con tipos de mensajes como text , image , voice , video , markdown , texto gráfico ( mpnews ), texto gráfico ( news ), tarjeta de texto ( textcard ), archivo ( file ) y otros tipos de mensajes;
• Gestión de material de archivo, incluida la carga de archivos temporales, la carga de imágenes, la carga asíncrona de los archivos, la descarga de archivos, etc.;
• Funciones como iniciar chats grupales, cambiar la información de chat grupal, obtener sesiones de chat de grupo y enviar mensajes de aplicación a chats grupales (para restricciones específicas, consulte el documento oficial);

confiar

No hay muchas bibliotecas de las que dependan, consulte requirements.txt .

Instalar

Actualmente es compatible con Python >= 3.9 , el resto de las versiones no se prueban.

La biblioteca de Python ahora se lanza y se puede instalar a través de pip install wwbot .

Código de muestra

El siguiente código de muestra muestra el uso simple de WeWorkBot . Este ejemplo muestra cómo responder a un mensaje de un 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 ver ejemplos más completos, consulte exampls/echo_bot.py .

Lista de tareas

• Fusionar las partes de URL de "Verificación de interfaz" y "Recepción de mensajes" sin dos registros
• Implementar cargas de recursos temporales, para que pueda enviar mensajes multimedia como voz o video arbitrarios
• Admite más tipos de mensajes de aplicación
• Hacer que la definición y la transformación de los mensajes sean más elegantes
• Creado en una biblioteca de Python. Esto no es lo suficientemente elegante ahora
• Mejorar DOC y ReadMe, incluidos los métodos para obtener CORP_ID y otros parámetros (No escribo más, soy vago. Solo hay unas pocas interfaces en total, lo que no es suficiente para escribir)

ilustrar

El código se actualiza como desee, principalmente depende de si hay algún espacio o no. Por lo general, se actualizará con frecuencia los fines de semana.