python web微信应用（三） 微信智能聊天机器人

---

前言

本篇文章作为系列第三篇文章，将实现一个微信智能聊天机器人：

系列其它文章请参考：
python web微信应用（一） 微信协议分析

python web微信应用（二） webwx 模块源码

python web微信应用（四） 监测自己被群组消息 @

python web微信应用（五） 自动下载接收的图片/语音/视频

python web微信应用（六） 监测微信撤回的消息

一、webwx 模块介绍

当前支持消息来源: 群组、公众号、联系人、自己
当前支持消息类型: 文本，位置，链接，图片，语音，视频，名片，表情，文件，撤回
不同消息类型所携带的字段也不同，具体如下：

类型	字段
必有字段	'senderType': 字符串类型，取值 “GROUP/SUBSCRIPTION/CONTACT/MYSELF/UNSUPPORTED”, 表示消息来源于群组/公众号/联系人/自己/不支持 'senderName': 字符串类型，表示发送者的身份，由系统分配，@@开头表示群组，@开头表示联系人或者公众号 'msgType': 字符串类型，取值 “TEXT/POSITION/IMAGE/VOICE/VIDEO/CARD/ANIMATION/FILE/REVOKE/UNSUPPORTED”, 表示消息类型是文本/位置/图片/语音/视频/名片/表情/文件/撤回/不支持 'msgId': 字符串类型，表示消息的唯一 id，由系统分配
senderType:
GROUP	'groupNickName': 字符串类型，表示发送者所在的群组昵称 'userNickName': 字符串类型，表示发送者的昵称 'userDisplayName': 字符串类型，表示发送者设置的自己在该群的显示名称，没有则为 ‘’ 'meIsAt': 布尔类型，表示自己是否被 @
SUBSCRIPTION	'subscriptionNickName': 字符串类型，表示发送者公众号昵称
CONTACT	'contactNickName': 字符串类型，表示发送者昵称 'contactRemarkName': 字符串类型，表示发送者备注名
MYSELF	'myNickName': 字符串类型，表示自己的昵称
msgType:
TEXT	'content': 字符串类型，表示接收到的消息内容
POSITION	'x': 字符串类型，浮点数，表示纬度 'y': 字符串类型，浮点数，表示经度 'scale': 字符串类型，整数，表示缩放比例 'label': 字符串类型，表示位置的标签名称 'poiname': 字符串类型，表示位置的具体名称
IMAGE	'imgHeight': 整数类型，表示图片高度 'imgWidth': 整数类型，表示图片宽度 'mediaId': 字符串类型，表示图片在服务器的资源 id，由系统分配，用于下载使用 'downloadFunc': 函数类型，表示下载图片的函数 调用 msg['downloadFunc'](msg)，将下载图片到当前目录，保存文件名为 img_mediaId.jpg
VOICE	'voiceLength': 整数类型，表示语音时长，单位毫秒 'mediaId': 字符串类型，表示图片在服务器的资源 id，由系统分配，用于下载使用 'downloadFunc': 函数类型，表示下载语音的函数 调用 msg['downloadFunc'](msg)，将下载语音到当前目录，保存文件名为 voice_mediaId.mp3
VIDEO	'imgHeight': 整数类型，表示视频高度 'imgWidth': 整数类型，表示视频宽度 'playLength': 整数类型，表示视频时长，单位秒 'mediaId': 字符串类型，表示视频在服务器的资源 id，由系统分配，用于下载使用 'downloadFunc': 函数类型，表示下载视频的函数 调用 msg['downloadFunc'](msg)，将下载视频到当前目录，保存文件名为 video_mediaId.mp4
CARD	'username': 字符串类型，表示微信号 'nickname': 字符串类型，表示昵称 'alias': 字符串类型，表示别名 'province': 字符串类型，表示省 'city': 字符串类型，表示城市 'sex': 字符串类型，表示性别，0-未知 1-男 2-女 'regionCode': 字符串类型，表示注册地
ANIMATION	'imgHeight': 整数类型，表示表情高度 'imgWidth': 整数类型，表示表情宽度
FILE	'fileName': 字符串类型，表示文件名 'encryFileName': 字符串类型，表示 encry 文件名 'fileSize': 字符串类型，表示文件大小，单位字节 'mediaId': 字符串类型，表示视频多媒体 id，由系统分配，用于下载使用 'downloadFunc': 函数类型，表示下载文件的函数 调用 msg['downloadFunc'](msg)，将下载文件到当前目录，保存文件名为 ‘fileName’ 字段值
REVOKE	'revokedMsgId': 字符串类型，表示被撤回的那条消息的 id
UNSUPPORTED	没有可选字段

二、微信智能聊天

智能聊天机器人实现分为三个步骤：

1. 从发送方接收消息
   通过 webwx 模块可以接收联系人/群组/公众号发来的文本/图片/语音/视频/位置/表情/文件等消息类型，不同消息类型能获取到不同的消息内容
2. 生成智能聊天内容
   通过 emotibot 或 tuling 机器人，我们可以获取智能聊天内容。首先在这些机器人网站上申请一个账号，获取 API_ID 或者 APP_KEY 等信息，然后 POST 请求就可以获取智能的聊天回复内容
3. 发送聊天内容到发送方
   通过 webwx 模块可以发送 文本、图片、视频、普通文件到联系人/群组/公众号

下面是智能聊天的完整代码：
对来自联系人，备注名是张三，消息类型是普通文本的消息进行特定处理，通过emotibot 或 tuling 机器人获取聊天内容，然后发送回给张三，从而实现智能聊天

import json
import requests
import webwx

EMOTIBOT_API_ID = "xxx" # 申请的 API_ID
EMOTIBOT_API_URL = "http://idc.emotibot.com/api/ApiKey/openapi.php"

TULING_API_KEY = "xxx"  # 申请的 API_KEY
TULING_API_URL = "http://openapi.tuling123.com/openapi/api/v2"

def emotibot(req_text):
    params = {
        "cmd": "chat",
        "appid": EMOTIBOT_API_ID,
        "userid": "xiaoming",
        "text": req_text,
        "location": "hangzhou"
    }

    resp = requests.request("post", EMOTIBOT_API_URL, params=params)
    dic = json.loads(resp.text)
    resp_text = dic["data"][0]["value"]
    return resp_text

def tuling(req_text):
    req = {
        "reqType": 0,
        "perception": {
            "inputText": {
                "text": req_text
            },
            "selfInfo": {
                "location": {
                    "city": "hangzhou",
                    "province": "zhejiang",
                    "street": "dongxin street"
                }
            }
        },
        "userInfo": {
            "apiKey": TULING_API_KEY,
            "userId": "xiaoming"
        }
    }

    resp = requests.request("post", TULING_API_URL, json=req)
    dic = json.loads(resp.text)
    resp_text = dic["results"][0]["values"]["text"]
    return resp_text

def msg_handle(self, msg):
    if msg['senderType'] == 'CONTACT' and msg['contactRemarkName'] == u'张三' and msg['msgType'] == 'TEXT':
        req_text = msg['content']
        # resp_text = emotibot(req_text) # 使用 emotibot 机器人获取聊天内容
        resp_text = tuling(req_text)     # 使用 tuling 机器人获取聊天内容
        self.send_text(resp_text, msg['senderName'])

if __name__ == '__main__':
    weChat = webwx.webwx()
    weChat.register_msg_handle(msg_handle)
    weChat.login()
    weChat.run()