回复

公共属性

每一种类型的回复都有如下属性:

name value
type 回复类型
source 回复的来源用户,通常是发送回复的用户。
target 回复的目标用户
time 回复的发送时间

每一种类型的回复都有一个 render 方法将回复转换成 XML 字符串:

from wechatpy.replies import TextReply

reply = TextReply()
reply.source = 'user1'
reply.target = 'user2'
reply.content = 'test'

xml = reply.render()

你可以在构建 Reply 时传入一个合法的 Message 对象来自动生成 source 和 target:

reply = TextReply(content='test', message=message)

文本回复

class wechatpy.replies.TextReply(**kwargs)[源代码]

文本回复 详情请参阅 http://mp.weixin.qq.com/wiki/9/2c15b20a16019ae613d413e30cac8ea1.html

render()

Render reply from Python object to XML string

name value
type text
content 回复正文

图片回复

class wechatpy.replies.ImageReply(**kwargs)[源代码]

图片回复 详情请参阅 http://mp.weixin.qq.com/wiki/9/2c15b20a16019ae613d413e30cac8ea1.html

render()

Render reply from Python object to XML string

name value
type image
media_id 通过上传多媒体文件,得到的 id

语音回复

class wechatpy.replies.VoiceReply(**kwargs)[源代码]

语音回复 详情请参阅 http://mp.weixin.qq.com/wiki/9/2c15b20a16019ae613d413e30cac8ea1.html

render()

Render reply from Python object to XML string

name value
type voice
media_id 通过上传多媒体文件,得到的 id

视频回复

class wechatpy.replies.VideoReply(**kwargs)[源代码]

视频回复 详情请参阅 http://mp.weixin.qq.com/wiki/9/2c15b20a16019ae613d413e30cac8ea1.html

render()

Render reply from Python object to XML string

name value
type video
media_id 通过上传多媒体文件,得到的 id
title 视频回复的标题
description 视频回复的描述

音乐回复

class wechatpy.replies.MusicReply(**kwargs)[源代码]

音乐回复 详情请参阅 http://mp.weixin.qq.com/wiki/9/2c15b20a16019ae613d413e30cac8ea1.html

render()

Render reply from Python object to XML string

name value
type music
thumb_media_id 缩略图的媒体 id,通过上传多媒体文件,得到的 id
title 音乐回复的标题
description 音乐回复的描述
music_url 音乐链接
hq_music_url 高质量音乐链接,WiFi 环境优先使用该链接播放音乐

图文回复

class wechatpy.replies.ArticlesReply(**kwargs)[源代码]

图文回复 详情请参阅 http://mp.weixin.qq.com/wiki/9/2c15b20a16019ae613d413e30cac8ea1.html

render()

Render reply from Python object to XML string

name value
type news

你需要给 ArticlesReply 添加 article 来增加图文,使用 ArticlesReply 的 add_article 方法或者设置 ArticlesReply 的 articles 属性。article 应当是 dict like 的对象(只要其能响应和 dict 一致的 get 方法即可),其应当包含如下属性(键值):

name value
title 图文回复标题
description 图文回复描述
image 图片链接
url 点击图文消息跳转链接

使用示例:

from wechatpy.replies import ArticlesReply
from wechatpy.utils import ObjectDict

reply = ArticlesReply(message=message)
# simply use dict as article
reply.add_article({
    'title': 'test',
    'description': 'test',
    'image': 'image url',
    'url': 'url'
})
# or you can use ObjectDict
article = ObjectDict()
article.title = 'test'
article.description = 'test'
article.image = 'image url'
article.url = 'url'
reply.add_article(article)

将消息转发到多客服

class wechatpy.replies.TransferCustomerServiceReply(**kwargs)[源代码]

将消息转发到多客服 详情请参阅 http://mp.weixin.qq.com/wiki/5/ae230189c9bd07a6b221f48619aeef35.html

render()

Render reply from Python object to XML string

name value
type transfer_customer_service

回复空串

class wechatpy.replies.EmptyReply[源代码]

回复空串

微信服务器不会对此作任何处理,并且不会发起重试

render()[源代码]

Render reply from Python object to XML string

微信服务器不会对此作任何处理,并且不会发起重试, 可以使用客服消息接口进行异步回复。

快速构建回复

wechatpy 提供了一个便捷的 create_reply 函数用来快速构建回复 :

from wechatpy import create_reply

empty_reply = create_reply('')

text_reply = create_reply('text reply', message=message)

articles = [
    {
        'title': 'test',
        'description': 'test',
        'image': 'image url',
        'url': 'url'
    },
    # add more ...
]

articles_reply = create_reply(articles, message=message)