微信

公众号设置

  1. POST - /wechat/confSet
参数 是否必填 说明
name 公众号名称,填写公众号的账号名称
description 描述,用于说明此公众号的功能及用途
account 公众号账号, 填写公众号的账号,一般为英文账号,如:9476400@qq.com
original 原始ID,原始ID不能修改,请谨慎填写,如:gh_9468ce6ce474
level 类型, 普通订阅号1、普通服务号2、认证订阅号3、认证服务号/认证媒体/政府订阅号4
app_key AppId
app_secret AppSecret
headimg 头像
qrcode 二维码

绑定信息获取

  1. GET - /wechat/getConf

查看接口状态

  1. GET - /wechat/checkApiStatus

获得token

  1. GET - /wechat/getToken
参数 是否必填 说明
refresh bool值,为true强行刷新tokenbool值,为true强行刷新token

获取所有标签

  1. GET - /wechat/userTagList

创建标签

  1. POST - /wechat/userTagCreate
参数 是否必填 说明
name 标签名

修改标签信息

  1. POST - /wechat/userTagUpdate
参数 是否必填 说明
id 标签id
name 标签名

删除标签

  1. POST - /wedhat/userTagDelete
参数 是否必填 说明
id 标签id

获取指定 openid 用户所属的标签

  1. GET - /wechat/userTagsByOpenid
参数 是否必填 说明
openid 用户openid

获取标签下用户列表

  1. GET - /wechat/userTagUsersOfTag
参数与 是否必填 说明
id 标签id
next_openid 从openid开始拉取,不填默认从开头拉取

批量为用户添加标签

  1. POST - /wechat/userTagTagUsers
参数 是否必填 说明
openids 用户openid数组
id 标签id

批量为用户移除标签

  1. POST - /wechat/userTagUntagUsers
参数 是否必填 说明
openids 用户openid数组
id 标签id

获取所有标签

  1. GET - /wechat/userTagList

创建标签

  1. POST - /wechat/userTagCreate
参数 是否必填 说明
name 标签名

修改标签信息

  1. POST - /wechat/userTagUpdate
参数 是否必填 说明
id 标签id
name 标签名

删除标签

  1. POST - /wedhat/userTagDelete
参数 是否必填 说明
id 标签id

获取指定 openid 用户所属的标签

  1. GET - /wechat/userTagsByOpenid
参数 是否必填 说明
openid 用户openid

获取标签下用户列表

  1. GET - /wechat/userTagUsersOfTag
参数与 是否必填 说明
id 标签id
next_openid 从openid开始拉取,不填默认从开头拉取

批量为用户添加标签

  1. POST - /wechat/userTagTagUsers
参数 是否必填 说明
openids 用户openid数组
id 标签id

批量为用户移除标签

  1. POST - /wechat/userTagUntagUsers
参数 是否必填 说明
openids 用户openid数组
id 标签id

新增永久素材说明

在微信里的图片,音乐,视频等等都需要先上传到微信服务器作为素材才可以在消息中使用。

对于常用的素材,开发者可通过本接口上传到微信服务器,永久使用。新增的永久素材也可以在公众平台官网素材管理模块中查询管理。

请注意:

1、最近更新:永久图片素材新增后,将带有URL返回给开发者,开发者可以在腾讯系域名内使用(腾讯系域名外使用,图片将被屏蔽)。

2、公众号的素材库保存总数量有上限:图文消息素材、图片素材上限为5000,其他类型为1000。

3、素材的格式大小等要求与公众平台官网一致:

图片(image): 2M,支持bmp/png/jpeg/jpg/gif格式

语音(voice):2M,播放长度不超过60s,mp3/wma/wav/amr格式

视频(video):10MB,支持MP4格式

缩略图(thumb):64KB,支持JPG格式

4、图文消息的具体内容中,微信后台将过滤外部的图片链接,图片url需通过”上传图文消息内的图片获取URL”接口上传图片获取。

5、”上传图文消息内的图片获取URL”接口所上传的图片,不占用公众号的素材库中图片数量的5000个的限制,图片仅支持jpg/png格式,大小必须在1MB以下。

6、图文消息支持正文中插入自己帐号和其他公众号已群发文章链接的能力。

微信永久素材图片上传

  1. POST - /wechat/materialUploadImage

注意:微信图片上传服务有敏感检测系统,图片内容如果含有敏感内容,如色情,商品推广,虚假信息等,上传可能失败。

url 只有上传图片素材有返回值。

参数 是否必须 说明
media form-data中媒体文件标识,有filename、filelength、content-type等信息

返回:

  1. {
  2. "media_id":MEDIA_ID,
  3. "url":URL
  4. }

URL 新增的图片素材的图片URL(仅新增图片素材时会返回该字段)

微信永久素材语音上传

  1. POST - /wechat/materialUploadVoice
参数 是否必填 说明
media form-data中媒体文件标识,有filename、filelength、content-type等信息

语音 大小不超过 5M,长度不超过 60 秒,支持 mp3/wma/wav/amr 格式。

返回:

  1. {
  2. "media_id":MEDIA_ID,
  3. }

微信永久素材视频上传

  1. POST - /wechat/materialUploadVideo
参数 是否必填 说明
media form-data中媒体文件标识,有filename、filelength、content-type等信息
title 视频标题
description 视频描述

返回:

  1. {
  2. "media_id":MEDIA_ID,
  3. }

微信永久素材缩略图上传

  1. POST - /wechat/materialUploadThumb
参数 是否必填 说明
media form-data中媒体文件标识,有filename、filelength、content-type等信息

用于视频封面或者音乐封面。

返回:

  1. {
  2. "media_id":MEDIA_ID,
  3. }

微信永久素材图文消息创建

  1. POST - /wechat/materialUploadArticle
参数 是否必填 说明
media 数组,多组图文

media包含参数说明:

参数 是否必须 说明
title 标题
thumb_media_id 图文消息的封面图片素材id(必须是永久mediaID)
author 作者
digest 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空。如果本字段为没有填写,则默认抓取正文前64个字。
show_cover_pic 是否显示封面,0为false,即不显示,1为true,即显示
content 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS,涉及图片url必须来源 “上传图文消息内的图片获取URL”接口获取。外部图片url将被过滤。
content_source_url 图文消息的原文地址,即点击“阅读原文”后的URL

提交数据示例:

  1. [
  2. {
  3. "title": TITLE,
  4. "thumb_media_id": THUMB_MEDIA_ID,
  5. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  6. "author": AUTHOR,
  7. "digest": DIGEST,
  8. "content": CONTENT,
  9. "url": URL,
  10. "content_source_url": CONTETN_SOURCE_URL
  11. },
  12. {
  13. "title": TITLE,
  14. "thumb_media_id": THUMB_MEDIA_ID,
  15. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  16. "author": AUTHOR,
  17. "digest": DIGEST,
  18. "content": CONTENT,
  19. "url": URL,
  20. "content_source_url": CONTETN_SOURCE_URL
  21. },
  22. ]

返回:

  1. {
  2. "media_id":MEDIA_ID
  3. }

返回的即为新增的图文消息素材的media_id。

微信永久素材图文消息修改

  1. POST - /wechat/materialUpdateArticle
参数 是否必填 说明
media_id 要更新的文章的 mediaId
article 文章内容
index 要更新的文章在图文消息中的位置(多图文消息时,此字段才有意义,单图片忽略此参数),第一篇为 0;

article包含参数说明:

参数 是否必须 说明
title 标题
thumb_media_id 图文消息的封面图片素材id(必须是永久mediaID)
author 作者
digest 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空
show_cover_pic 是否显示封面,0为false,即不显示,1为true,即显示
content 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS
content_source_url 图文消息的原文地址,即点击“阅读原文”后的URL

提交数据示例:

  1. {
  2. "media_id":MEDIA_ID,
  3. "index":INDEX,
  4. "article": {
  5. "title": TITLE,
  6. "thumb_media_id": THUMB_MEDIA_ID,
  7. "author": AUTHOR,
  8. "digest": DIGEST,
  9. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  10. "content": CONTENT,
  11. "content_source_url": CONTENT_SOURCE_URL
  12. }
  13. }

微信永久素材图文消息图片上传

  1. POST - /wechat/materialUploadArticleImage
参数 是否必填 说明
media form-data中媒体文件标识,有filename、filelength、content-type等信息

返回值中 url 就是上传图片的 URL,可用于后续群发中,放置到图文消息中。

本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式,大小必须在1MB以下。

微信永久素材获取单条

  1. GET - /wechat/materialGet
参数 是否必填 说明
media_id 素材ID

图文素材:

  1. {
  2. "news_item": [
  3. {
  4. "title":TITLE,
  5. "thumb_media_id"::THUMB_MEDIA_ID,
  6. "show_cover_pic":SHOW_COVER_PIC(0/1),
  7. "author":AUTHOR,
  8. "digest":DIGEST,
  9. "content":CONTENT,
  10. "url":URL,
  11. "content_source_url":CONTENT_SOURCE_URL
  12. },
  13. //多图文消息有多篇文章
  14. ]
  15. }

视频消息素材:

  1. {
  2. "title":TITLE,
  3. "description":DESCRIPTION,
  4. "down_url":DOWN_URL,
  5. }

微信永久素材获取列表

  1. GET - /wechat/materialList
参数 是否必填 说明
type 素材的类型,图片(image)、视频(video)、语音 (voice)、图文(news
offset 从全部素材的该偏移位置开始返回,可选,默认 0,0 表示从第一个素材 返回
count 返回素材的数量,可选,默认 20, 取值在 1 到 20 之间

图片、语音、视频 等类型的返回如下

  1. {
  2. "total_count": TOTAL_COUNT,
  3. "item_count": ITEM_COUNT,
  4. "item": [{
  5. "media_id": MEDIA_ID,
  6. "name": NAME,
  7. "update_time": UPDATE_TIME,
  8. "url":URL
  9. },
  10. //可能会有多个素材
  11. ]
  12. }

永久图文消息素材列表的响应如下:

  1. {
  2. "total_count": TOTAL_COUNT,
  3. "item_count": ITEM_COUNT,
  4. "item": [{
  5. "media_id": MEDIA_ID,
  6. "content": {
  7. "news_item": [{
  8. "title": TITLE,
  9. "thumb_media_id": THUMB_MEDIA_ID,
  10. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  11. "author": AUTHOR,
  12. "digest": DIGEST,
  13. "content": CONTENT,
  14. "url": URL,
  15. "content_source_url": CONTETN_SOURCE_URL
  16. },
  17. //多图文消息会在此处有多篇文章
  18. ]
  19. },
  20. "update_time": UPDATE_TIME
  21. },
  22. //可能有多个图文消息item结构
  23. ]
  24. }

获取素材计数

  1. GET - /wechat/materialStats

结果:

  1. {
  2. "voice_count":COUNT,
  3. "video_count":COUNT,
  4. "image_count":COUNT,
  5. "news_count":COUNT
  6. }

删除永久素材

  1. POST - /wechat/materialDelete
参数 是否必填 说明
media_id 素材ID

本地图文添加

本地图文模块,属于服务器内部的存储,和微信数据无关。

  1. POST - /wechat/localNewsAdd
参数 是否必填 说明
media 数组

media包含参数说明:

参数 是否必填 说明
title 标题
cover_pic 封面图链接
link 链接
link.action 行为,具体见链接说明
link.param 参数,具体见链接说明

请求示例:

  1. [
  2. {
  3. "title" : "本地图文示例",
  4. "cover_pic" : "https://www.fashop.cn/logo.png",
  5. "link" : {
  6. "action" : "goods",
  7. "param" : {
  8. "id" : 20
  9. }
  10. }
  11. },
  12. {
  13. "title" : "本地图文示例",
  14. "cover_pic" : "https://www.fashop.cn/logo.png",
  15. "link" : {
  16. "action" : "goods",
  17. "param" : {
  18. "id" : 20
  19. }
  20. }
  21. }
  22. ]

本地图文修改

  1. POST - /wechat/localNewsEdit
参数 是否必填 说明
id 图文id
media 数组

media包含参数说明:

参数 是否必填 说明
title 标题
cover_pic 封面图链接
link 链接
link.action 行为,具体见链接说明
link.param 参数,具体见链接说明

请求示例:

  1. [
  2. {
  3. "title" : "本地图文示例",
  4. "cover_pic" : "https://www.fashop.cn/logo.png",
  5. "link" : {
  6. "action" : "goods",
  7. "param" : {
  8. "id" : 20
  9. }
  10. }
  11. },
  12. {
  13. "title" : "本地图文示例",
  14. "cover_pic" : "https://www.fashop.cn/logo.png",
  15. "link" : {
  16. "action" : "goods",
  17. "param" : {
  18. "id" : 20
  19. }
  20. }
  21. }
  22. ]

本地图文删除

  1. POST - /wechat/localNewsDel
参数 是否必填 说明
id 图文id

本地图文列表

  1. POST - /wechat/localNews
参数 是否必填 说明
page 分页
rows 条数

自动回复开关设置

  1. POST - /wechat/autoReplyStatusSet
参数 是否必填 说明
status 是,可选填 是否开启自动回复功能,开启 1 、关闭 0

自动回复开关设置获取

  1. GET - /wechat/autoReplyStatusGet

返回

  1. {
  2. "status" : 1
  3. }

被关注自动回复内容设置获取

  1. GET - /wechat/autoReplySubscribeGet

返回

  1. {
  2. "reply_content" : {
  3. "type" : "text",
  4. "content" : "你好,我是机器人(●—●)"
  5. }
  6. }

被关注自动回复内容设置

  1. POST - /wechat/autoReplySubscribeSet
参数 是否必填 说明
reply_content 是,可选填 回复内容
reply_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
reply_content.content 当type为text时必填 文本内容
reply_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
reply_content.local_news_id 当type 为 local_news 时必填 本地图文ID

shop表字段

请求示例:

文本

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "text",
  6. "content" : "fashop是个商城系统",
  7. }
  8. }

图片

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "image",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "url" : "http://xxxxxxxxxxxxxxxxxx.jpg"
  9. }
  10. }
  11. }

图文

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "news",
  6. "media_id" : MEDIA_ID,
  7. "extra" : [
  8. {
  9. "title": TITLE,
  10. "thumb_media_id": THUMB_MEDIA_ID,
  11. "author": AUTHOR,
  12. "digest": DIGEST,
  13. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  14. "content": CONTENT,
  15. "content_source_url": CONTENT_SOURCE_URL
  16. },
  17. {
  18. "title": TITLE,
  19. "thumb_media_id": THUMB_MEDIA_ID,
  20. "author": AUTHOR,
  21. "digest": DIGEST,
  22. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  23. "content": CONTENT,
  24. "content_source_url": CONTENT_SOURCE_URL
  25. }
  26. ]
  27. }
  28. }

音频

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "voice",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "name" : "1521009709656服装大甩卖.mp3"
  9. }
  10. }
  11. }

视频

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "video",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "title":TITLE,
  9. "description":DESCRIPTION,
  10. "down_url":DOWN_URL
  11. }
  12. }
  13. }

本地图文

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "local_news",
  6. "local_news_id" : LOCAL_NEWS_ID,
  7. "extra" : [
  8. {
  9. "title" : "xxxxxxxxx",
  10. "cover_pic" : "http://xxxxxxxxxx.jpg"
  11. },
  12. {
  13. "title" : "xxxxxxxxx",
  14. "cover_pic" : "http://xxxxxxxxxx.jpg"
  15. }
  16. ]
  17. }
  18. }

开启/关闭

  1. POST - /wechat/autoReplyKeywordsSet
参数 是否必填 说明
status 开关,开1、关0
  1. {
  2. "status" : 1
  3. }

关键词规则列表

  1. GET - /wechat/replyKeywordsList
参数 是否必填 说明
keywords 搜索关键,支持规则名称搜索和关键词搜索

关键词规则添加

  1. POST - /wechat/autoReplyKeywordsAdd
参数 是否必填 说明
rule_name 规则名称
keywords 触发的关键词集合,数组,最多10组
keywords.key 要匹配的关键词,最长30字符
keywords.match_mode 匹配模式,contain代表消息中含有该关键词即可,equal表示消息内容必须和关键词严格相同
reply_mode 回复模式,reply_all代表全部回复,random_one代表随机回复其中一条,回复内容,最多5条
reply_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
reply_content.content 当type为text时必填 文本内容
reply_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
reply_content.local_news_id 当type 为 local_news 时必填 本地图文ID

关键词回复和被关注的回复数据结构是一样的

请求数据示例:

  1. {
  2. "rule_name" : "回复fashop是什么",
  3. "keywords" : [
  4. {
  5. "match_mode" : "contain",
  6. "key" : "是什么", // 如果用户给公众号发“是什么”,此处应该有消息回复
  7. },
  8. {
  9. "match_mode" : "contain",
  10. "key" : "fashop", // 如果用户给公众号发“fashop”,此处应该有消息回复
  11. },
  12. {
  13. "match_mode" : "contain",
  14. "key" : "什么", // 如果用户给公众号发“什么”,此处应该有消息回复
  15. }
  16. ],
  17. "replay_content" : [
  18. {
  19. "type" : "text",
  20. "content" : "fashop是个商城系统",
  21. },
  22. {
  23. "type" : "image",
  24. "media_id" : MEDIA_ID,
  25. },
  26. {
  27. "type" : "voice",
  28. "media_id" : MEDIA_ID,
  29. },
  30. {
  31. "type" : "video",
  32. "media_id" : MEDIA_ID,
  33. },
  34. {
  35. "type" : "news",
  36. "media_id" : MEDIA_ID,
  37. },
  38. {
  39. "type" : "local_news",
  40. "local_news_id" : LOCAL_NEWS_ID,
  41. }
  42. ],
  43. "reply_mode" : "reply_all"
  44. }

关键词规则修改

  1. POST - /wechat/autoReplyKeywordsEdit
参数 是否必填 说明
id 规则id
rule_name 规则名称
keywords 触发的关键词集合,数组
keywords.match_mode 匹配模式,contain代表消息中含有该关键词即可,equal表示消息内容必须和关键词严格相同
keywords.key 要匹配的关键词
reply_mode 回复模式,reply_all代表全部回复,random_one代表随机回复其中一条
replay_content 回复内容
replay_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
replay_content.content 当type为text时必填 文本内容
replay_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
replay_content.local_news_id 当type 为 local_news 时必填 本地图文ID

关键词回复和被关注的回复数据结构是一样的

请求数据示例:

  1. {
  2. "id" : 1,
  3. "rule_name" : "回复fashop是什么",
  4. "keywords" : [
  5. {
  6. "match_mode" : "contain",
  7. "key" : "是什么", // 如果用户给公众号发“是什么”,此处应该有消息回复
  8. },
  9. {
  10. "match_mode" : "contain",
  11. "key" : "fashop", // 如果用户给公众号发“fashop”,此处应该有消息回复
  12. },
  13. {
  14. "match_mode" : "contain",
  15. "key" : "什么", // 如果用户给公众号发“什么”,此处应该有消息回复
  16. }
  17. ],
  18. "replay_content" : [
  19. {
  20. "type" : "text",
  21. "content" : "fashop是个商城系统",
  22. },
  23. {
  24. "type" : "image",
  25. "media_id" : MEDIA_ID,
  26. },
  27. {
  28. "type" : "voice",
  29. "media_id" : MEDIA_ID,
  30. },
  31. {
  32. "type" : "video",
  33. "media_id" : MEDIA_ID,
  34. },
  35. {
  36. "type" : "news",
  37. "media_id" : MEDIA_ID,
  38. },
  39. {
  40. "type" : "local_news",
  41. "local_news_id" : LOCAL_NEWS_ID,
  42. }
  43. ],
  44. "reply_mode" : "reply_all"
  45. }

规则关键词删除

  1. POST - /wechat/autoReplyKeywordsDel
参数 是否必填 说明
id 规则id

规则关键词详情

  1. POST - /wechat/autoReplyKeywordsInfo
参数 是否必填 说明
id 规则id

自动回复开关设置

  1. POST - /wechat/autoReplyStatusSet
参数 是否必填 说明
status 是,可选填 是否开启自动回复功能,开启 1 、关闭 0

自动回复开关设置获取

  1. GET - /wechat/autoReplyStatusGet

返回

  1. {
  2. "status" : 1
  3. }

被关注自动回复内容设置获取

  1. GET - /wechat/autoReplySubscribeGet

返回

  1. {
  2. "reply_content" : {
  3. "type" : "text",
  4. "content" : "你好,我是机器人(●—●)"
  5. }
  6. }

被关注自动回复内容设置

  1. POST - /wechat/autoReplySubscribeSet
参数 是否必填 说明
reply_content 是,可选填 回复内容
reply_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
reply_content.content 当type为text时必填 文本内容
reply_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
reply_content.local_news_id 当type 为 local_news 时必填 本地图文ID

shop表字段

请求示例:

文本

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "text",
  6. "content" : "fashop是个商城系统",
  7. }
  8. }

图片

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "image",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "url" : "http://xxxxxxxxxxxxxxxxxx.jpg"
  9. }
  10. }
  11. }

图文

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "news",
  6. "media_id" : MEDIA_ID,
  7. "extra" : [
  8. {
  9. "title": TITLE,
  10. "thumb_media_id": THUMB_MEDIA_ID,
  11. "author": AUTHOR,
  12. "digest": DIGEST,
  13. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  14. "content": CONTENT,
  15. "content_source_url": CONTENT_SOURCE_URL
  16. },
  17. {
  18. "title": TITLE,
  19. "thumb_media_id": THUMB_MEDIA_ID,
  20. "author": AUTHOR,
  21. "digest": DIGEST,
  22. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  23. "content": CONTENT,
  24. "content_source_url": CONTENT_SOURCE_URL
  25. }
  26. ]
  27. }
  28. }

音频

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "voice",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "name" : "1521009709656服装大甩卖.mp3"
  9. }
  10. }
  11. }

视频

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "video",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "title":TITLE,
  9. "description":DESCRIPTION,
  10. "down_url":DOWN_URL
  11. }
  12. }
  13. }

本地图文

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "local_news",
  6. "local_news_id" : LOCAL_NEWS_ID,
  7. "extra" : [
  8. {
  9. "title" : "xxxxxxxxx",
  10. "cover_pic" : "http://xxxxxxxxxx.jpg"
  11. },
  12. {
  13. "title" : "xxxxxxxxx",
  14. "cover_pic" : "http://xxxxxxxxxx.jpg"
  15. }
  16. ]
  17. }
  18. }

开启/关闭

  1. POST - /wechat/autoReplyKeywordsSet
参数 是否必填 说明
status 开关,开1、关0
  1. {
  2. "status" : 1
  3. }

关键词规则列表

  1. GET - /wechat/replyKeywordsList
参数 是否必填 说明
keywords 搜索关键,支持规则名称搜索和关键词搜索

关键词规则添加

  1. POST - /wechat/autoReplyKeywordsAdd
参数 是否必填 说明
rule_name 规则名称
keywords 触发的关键词集合,数组,最多10组
keywords.key 要匹配的关键词,最长30字符
keywords.match_mode 匹配模式,contain代表消息中含有该关键词即可,equal表示消息内容必须和关键词严格相同
reply_mode 回复模式,reply_all代表全部回复,random_one代表随机回复其中一条,回复内容,最多5条
reply_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
reply_content.content 当type为text时必填 文本内容
reply_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
reply_content.local_news_id 当type 为 local_news 时必填 本地图文ID

关键词回复和被关注的回复数据结构是一样的

请求数据示例:

  1. {
  2. "rule_name" : "回复fashop是什么",
  3. "keywords" : [
  4. {
  5. "match_mode" : "contain",
  6. "key" : "是什么", // 如果用户给公众号发“是什么”,此处应该有消息回复
  7. },
  8. {
  9. "match_mode" : "contain",
  10. "key" : "fashop", // 如果用户给公众号发“fashop”,此处应该有消息回复
  11. },
  12. {
  13. "match_mode" : "contain",
  14. "key" : "什么", // 如果用户给公众号发“什么”,此处应该有消息回复
  15. }
  16. ],
  17. "replay_content" : [
  18. {
  19. "type" : "text",
  20. "content" : "fashop是个商城系统",
  21. },
  22. {
  23. "type" : "image",
  24. "media_id" : MEDIA_ID,
  25. },
  26. {
  27. "type" : "voice",
  28. "media_id" : MEDIA_ID,
  29. },
  30. {
  31. "type" : "video",
  32. "media_id" : MEDIA_ID,
  33. },
  34. {
  35. "type" : "news",
  36. "media_id" : MEDIA_ID,
  37. },
  38. {
  39. "type" : "local_news",
  40. "local_news_id" : LOCAL_NEWS_ID,
  41. }
  42. ],
  43. "reply_mode" : "reply_all"
  44. }

关键词规则修改

  1. POST - /wechat/autoReplyKeywordsEdit
参数 是否必填 说明
id 规则id
rule_name 规则名称
keywords 触发的关键词集合,数组
keywords.match_mode 匹配模式,contain代表消息中含有该关键词即可,equal表示消息内容必须和关键词严格相同
keywords.key 要匹配的关键词
reply_mode 回复模式,reply_all代表全部回复,random_one代表随机回复其中一条
replay_content 回复内容
replay_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
replay_content.content 当type为text时必填 文本内容
replay_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
replay_content.local_news_id 当type 为 local_news 时必填 本地图文ID

关键词回复和被关注的回复数据结构是一样的

请求数据示例:

  1. {
  2. "id" : 1,
  3. "rule_name" : "回复fashop是什么",
  4. "keywords" : [
  5. {
  6. "match_mode" : "contain",
  7. "key" : "是什么", // 如果用户给公众号发“是什么”,此处应该有消息回复
  8. },
  9. {
  10. "match_mode" : "contain",
  11. "key" : "fashop", // 如果用户给公众号发“fashop”,此处应该有消息回复
  12. },
  13. {
  14. "match_mode" : "contain",
  15. "key" : "什么", // 如果用户给公众号发“什么”,此处应该有消息回复
  16. }
  17. ],
  18. "replay_content" : [
  19. {
  20. "type" : "text",
  21. "content" : "fashop是个商城系统",
  22. },
  23. {
  24. "type" : "image",
  25. "media_id" : MEDIA_ID,
  26. },
  27. {
  28. "type" : "voice",
  29. "media_id" : MEDIA_ID,
  30. },
  31. {
  32. "type" : "video",
  33. "media_id" : MEDIA_ID,
  34. },
  35. {
  36. "type" : "news",
  37. "media_id" : MEDIA_ID,
  38. },
  39. {
  40. "type" : "local_news",
  41. "local_news_id" : LOCAL_NEWS_ID,
  42. }
  43. ],
  44. "reply_mode" : "reply_all"
  45. }

规则关键词删除

  1. POST - /wechat/autoReplyKeywordsDel
参数 是否必填 说明
id 规则id

规则关键词详情

  1. POST - /wechat/autoReplyKeywordsInfo
参数 是否必填 说明
id 规则id

自动回复开关设置

  1. POST - /wechat/autoReplyStatusSet
参数 是否必填 说明
status 是,可选填 是否开启自动回复功能,开启 1 、关闭 0

自动回复开关设置获取

  1. GET - /wechat/autoReplyStatusGet

返回

  1. {
  2. "status" : 1
  3. }

被关注自动回复内容设置获取

  1. GET - /wechat/autoReplySubscribeGet

返回

  1. {
  2. "reply_content" : {
  3. "type" : "text",
  4. "content" : "你好,我是机器人(●—●)"
  5. }
  6. }

被关注自动回复内容设置

  1. POST - /wechat/autoReplySubscribeSet
参数 是否必填 说明
reply_content 是,可选填 回复内容
reply_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
reply_content.content 当type为text时必填 文本内容
reply_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
reply_content.local_news_id 当type 为 local_news 时必填 本地图文ID

shop表字段

请求示例:

文本

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "text",
  6. "content" : "fashop是个商城系统",
  7. }
  8. }

图片

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "image",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "url" : "http://xxxxxxxxxxxxxxxxxx.jpg"
  9. }
  10. }
  11. }

图文

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "news",
  6. "media_id" : MEDIA_ID,
  7. "extra" : [
  8. {
  9. "title": TITLE,
  10. "thumb_media_id": THUMB_MEDIA_ID,
  11. "author": AUTHOR,
  12. "digest": DIGEST,
  13. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  14. "content": CONTENT,
  15. "content_source_url": CONTENT_SOURCE_URL
  16. },
  17. {
  18. "title": TITLE,
  19. "thumb_media_id": THUMB_MEDIA_ID,
  20. "author": AUTHOR,
  21. "digest": DIGEST,
  22. "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  23. "content": CONTENT,
  24. "content_source_url": CONTENT_SOURCE_URL
  25. }
  26. ]
  27. }
  28. }

音频

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "voice",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "name" : "1521009709656服装大甩卖.mp3"
  9. }
  10. }
  11. }

视频

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "video",
  6. "media_id" : MEDIA_ID,
  7. "extra" : {
  8. "title":TITLE,
  9. "description":DESCRIPTION,
  10. "down_url":DOWN_URL
  11. }
  12. }
  13. }

本地图文

  1. {
  2. "status" : 1,
  3. "replay_content" :
  4. {
  5. "type" : "local_news",
  6. "local_news_id" : LOCAL_NEWS_ID,
  7. "extra" : [
  8. {
  9. "title" : "xxxxxxxxx",
  10. "cover_pic" : "http://xxxxxxxxxx.jpg"
  11. },
  12. {
  13. "title" : "xxxxxxxxx",
  14. "cover_pic" : "http://xxxxxxxxxx.jpg"
  15. }
  16. ]
  17. }
  18. }

开启/关闭

  1. POST - /wechat/autoReplyKeywordsSet
参数 是否必填 说明
status 开关,开1、关0
  1. {
  2. "status" : 1
  3. }

关键词规则列表

  1. GET - /wechat/replyKeywordsList
参数 是否必填 说明
keywords 搜索关键,支持规则名称搜索和关键词搜索

关键词规则添加

  1. POST - /wechat/autoReplyKeywordsAdd
参数 是否必填 说明
rule_name 规则名称
keywords 触发的关键词集合,数组,最多10组
keywords.key 要匹配的关键词,最长30字符
keywords.match_mode 匹配模式,contain代表消息中含有该关键词即可,equal表示消息内容必须和关键词严格相同
reply_mode 回复模式,reply_all代表全部回复,random_one代表随机回复其中一条,回复内容,最多5条
reply_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
reply_content.content 当type为text时必填 文本内容
reply_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
reply_content.local_news_id 当type 为 local_news 时必填 本地图文ID

关键词回复和被关注的回复数据结构是一样的

请求数据示例:

  1. {
  2. "rule_name" : "回复fashop是什么",
  3. "keywords" : [
  4. {
  5. "match_mode" : "contain",
  6. "key" : "是什么", // 如果用户给公众号发“是什么”,此处应该有消息回复
  7. },
  8. {
  9. "match_mode" : "contain",
  10. "key" : "fashop", // 如果用户给公众号发“fashop”,此处应该有消息回复
  11. },
  12. {
  13. "match_mode" : "contain",
  14. "key" : "什么", // 如果用户给公众号发“什么”,此处应该有消息回复
  15. }
  16. ],
  17. "replay_content" : [
  18. {
  19. "type" : "text",
  20. "content" : "fashop是个商城系统",
  21. },
  22. {
  23. "type" : "image",
  24. "media_id" : MEDIA_ID,
  25. },
  26. {
  27. "type" : "voice",
  28. "media_id" : MEDIA_ID,
  29. },
  30. {
  31. "type" : "video",
  32. "media_id" : MEDIA_ID,
  33. },
  34. {
  35. "type" : "news",
  36. "media_id" : MEDIA_ID,
  37. },
  38. {
  39. "type" : "local_news",
  40. "local_news_id" : LOCAL_NEWS_ID,
  41. }
  42. ],
  43. "reply_mode" : "reply_all"
  44. }

关键词规则修改

  1. POST - /wechat/autoReplyKeywordsEdit
参数 是否必填 说明
id 规则id
rule_name 规则名称
keywords 触发的关键词集合,数组
keywords.match_mode 匹配模式,contain代表消息中含有该关键词即可,equal表示消息内容必须和关键词严格相同
keywords.key 要匹配的关键词
reply_mode 回复模式,reply_all代表全部回复,random_one代表随机回复其中一条
replay_content 回复内容
replay_content.type 是,text文本、image图片、news图文 、voice音频、 video视频、local_news 本地图文
replay_content.content 当type为text时必填 文本内容
replay_content.media_id 当type为imagenewsvoicevideo、时必填 微信永久素材ID
replay_content.local_news_id 当type 为 local_news 时必填 本地图文ID

关键词回复和被关注的回复数据结构是一样的

请求数据示例:

  1. {
  2. "id" : 1,
  3. "rule_name" : "回复fashop是什么",
  4. "keywords" : [
  5. {
  6. "match_mode" : "contain",
  7. "key" : "是什么", // 如果用户给公众号发“是什么”,此处应该有消息回复
  8. },
  9. {
  10. "match_mode" : "contain",
  11. "key" : "fashop", // 如果用户给公众号发“fashop”,此处应该有消息回复
  12. },
  13. {
  14. "match_mode" : "contain",
  15. "key" : "什么", // 如果用户给公众号发“什么”,此处应该有消息回复
  16. }
  17. ],
  18. "replay_content" : [
  19. {
  20. "type" : "text",
  21. "content" : "fashop是个商城系统",
  22. },
  23. {
  24. "type" : "image",
  25. "media_id" : MEDIA_ID,
  26. },
  27. {
  28. "type" : "voice",
  29. "media_id" : MEDIA_ID,
  30. },
  31. {
  32. "type" : "video",
  33. "media_id" : MEDIA_ID,
  34. },
  35. {
  36. "type" : "news",
  37. "media_id" : MEDIA_ID,
  38. },
  39. {
  40. "type" : "local_news",
  41. "local_news_id" : LOCAL_NEWS_ID,
  42. }
  43. ],
  44. "reply_mode" : "reply_all"
  45. }

规则关键词删除

  1. POST - /wechat/autoReplyKeywordsDel
参数 是否必填 说明
id 规则id

规则关键词详情

  1. POST - /wechat/autoReplyKeywordsInfo
参数 是否必填 说明
id 规则id