微信公众号90个接口开发详解

字号+ 作者:admin 来源:未知 2017-12-29 09:44 我要评论( )

一、对话服务类 1. 基础支持 1.1 获取accesstoken 为了验证实际第三方服务器通信使用,对公众号功能设计没有实际作用。 1.2 获取微信服务器...

  一、对话服务类
 
  1. 基础支持
 
  1.1 获取accesstoken 为了验证实际第三方服务器通信使用,对公众号功能设计没有实际作用。
 
  1.2 获取微信服务器IP地址 为了核验和微信服务器之间的通信是安全的,检查微信服务器IP防止伪造服务器和公众号服务通信,对公众号功能设计没有实际作用。
 
  2. 接收消息
 
  2.1 验证消息真实性。微信服务器核验第三方服务器消息,对公众号功能设计没有实际作用。
 
  2.2 接收普通消息。微信服务器接收用户发送的文本消息,并且根据文本消息做出自动回复,回复结果由第三方服务器返回给微信服务器,微信服务器再推送给用户,此项回复内容可以是查字典式的一来一回回复,也可以是类似于微软小冰一样的智能机器人,内容都靠第三方服务器返回。
 
  2.3 接收事件推送。在用户和微信公众号产生交互的过程中,用户的一些操作动作(点击公众号菜单拉取消息、点击公众号菜单跳转链接、关注/取消关注、上报地理位置、扫描带参数的二维码)使得微信服务器通过事件推送的形式通知第三方服务器获取该信息,有些动作允许第三方服务器回复用户,有些不允许;这里可以让第三方做的事情有用户关注时候给用户返回相应指定内容或者模板化的内容、用户扫描带参数的二维码时候关注公众号并且给用户返回二维码所应返回指定内容、用户上报地理位置时候根据用户的地理位置匹配对应信息、用户点击自定义菜单的时候根据用户点击行为自动返回内容或者直接跳转链接。
 
  2.4 接收语音识别结果。当普通微信用户向公众号发录制的语音消息时,微信服务器会将语音会话解析为文本通话并转发至第三方服务器,后续可反馈功能可参照“接收普通消息”接口。
 
  3. 发送消息
 
  3.1 自动回复。用户发送消息给公众号时,第三方服务器根据用户发送的信息进行响应并给用户在公众号内返回对应的信息(目前支持系统给用户回复文本、图片、图文、语音、视频、音乐),自动回复接口只能在用户主动向公众号发送消息的时候才能触及。
 
  3.2 客服消息。当用户和公众号产生特定的动作交互时候,微信会把消息数据推送给第三方服务器,第三方服务器可以在48小时内调用客服接口发消息给普通微信用户,此接口主要用于客服等有人工消息处理环节的功能。目前通道允许的动作列表有:用户发送消息、点击自定义菜单、关注公众号、扫描二维码、用户支付成功、用户维权。第三方也可以利用此通道的48小时连接机制,在48小时内推送多条内容给用户。
 
  3.3 群发消息。公众平台为订阅号提供每天一次的群发权限;为服务号提供每自然月4条的群发权限。具备开发能力的第三方和公众号运营者可以通过高级群发接口实现更灵活的群发。第三方可以结合微信用户openid和自有用户的交易等数据,给用户打各种tag并且依据这些tag给用户实现分类,群发接口支持按照分类给用户推送不同的内容,支撑差异化、精细化公众号运营。
 
  3.4 模板消息。模板消息用于公众号向用户发送重要的服务通知,微信官方要求模板消息只能用于符合要求的场景中(比如刷卡通知、下单通知、厂家发货通知、配送通知等),模板消息本身不支持公众号运营者推送营销类消息以及其他骚扰用户的消息类型,但是因为模板消息的屏蔽机制采用了用户举报机制,所以正常情况下推送些赠送给用户的优惠券或者优惠活动本身只要用户不举报是没有问题的,所以善用模板消息可以更好的触达用户,用模板消息实现优惠券推送、发货通知等通知也可以友好的改善用户的感受并且有效的降低短信通知的成本。目前每个公众号可以设置25套不同模板去做消息提醒。
 
  3.5 一次性订阅消息。公众号开发者可以用“一次性订阅消息”让微信用户授权第三方应用或公众号,获得发送一次订阅消息给到授权微信用户的机会。授权微信用户可以不需要关注公众号。微信用户每授权一次,开发者可获得一次下发消息的权限。对于已关注公众号的,消息将下发到公众号会话;未关注公众号的,将下发到服务通知。用户授权后就可以给用户推送一条订阅模板消息了。
 
  4. 用户管理
 
  4.1 用户分组管理。第三方开发者可以用用户分组及标签管理接口实现对公众号内的用户打标签、查询标签、修改标签、删除标签等操作。目前一个公众号可以给用户创建100个标签;每个用户微信平台支持给用户打20个标签。微信平台也支持批量为用户打标签,以及批量获取某些标签用户。通过用户分组及打标签功能,公众号运营者即可精确设置用户微信分组,并依据分组进行用户信息推送、营销设置等种种运营活动。也可以基于这些用户及标签用行业+AI的方式进行运营思考和实践。
 
  4.2 设置用户备注名。开发者可以通过该接口对指定的用户设置备注名,目前该接口只给微信认证的服务号。可以结合该接口和推送等通道使用一起运营。
 
  4.3 获取用户基本信息。在关注者与公众号产生消息交互后,公众号可获得关注的OpenId(加密后的微信号,每个用户对每个公众号的OpenID是唯一的。对于不同公众号,同一用户的openid不同),公众号可通过本接口来根据OpenID获取用户基本信息,包括昵称、头像、性别、所在城市、语言和关注时间等信息。 另外,如果该公司主体下有多个公众号、小程序之类的应用,并且有统一用户体系的需求,可以在微信开放平台绑定后使用UnionId(同一用户,对同一个公司主体下的不同应用,unionid是相同的)机制来打通用户信息。巧用此接口,就可以将小程序内的各类用户行为和数据、公众号里的各种数据有效打通,可以进行比如公众号通过模板消息推送一个优惠券,用户点击模板消息里的卡券直表。公众号可以通过本接口来获取该公众号的关注者列表,关注者列表由一串OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成。一次拉取调用最多拉取10000个关注者的OpenID,可以通过多次拉取的方式来满足需求。此接口可以便于第三方平台和微信官方同步用户数据。
 
  4.5 获取用户地理位置。开通了上报地理位置接口的公众号,用户在关注后进入公众号时候,会有个弹出让用户确认是否允许公众号使用其地理位置,弹框确认只出现一次,之后只能在公众号详情页面进行操作。用户同意上报位置后,每次进入公众号会话时,都会上报用户的位置信息,第三方开发者可以保存这些用户位置信息进行用户画像并为各种营销、运营做决策。
 
  5. 推广支持
 
  5.1 生成带参数的二维码。为了绑定用户渠道推广分析和用户绑定等场景需求,公众平台可以提供生成带参数的二维码接口。使用该接口可以获取数量很多的不同场景二维码,用户扫描后,公众号可以接收到该二维码对应的事件推送。目前带参数的二维码分为2种类型:
 
  5.1.1 临时二维码,临时二维码有过期时间,最长可以在生成后30天过期,临时二维码虽然保存时间较短,但能够生成极大数量,临时二维码可用于账号绑定、大量即时售出商品营销动作等,举例来说,某企业可以将每一件出售商品上都贴一张临时二维码,并且在上面打印着扫描此二维码随机抽取超大红包等字样,这样可以有效提升二维码扫描,此时可以设置一定频率的红包中奖率即可,大部分用户都可以最后扫完赠送一个金额不等的抵金券,反复引导此用户因为优惠券原因反复下单。
 
  5.1.2 永久二维码,永久二维码没有过期时间,但数量较少(目前最多10万个),永久二维码可以用于账号绑定、用户来源统计等场景。举例来说,企业可以给所有销售人员都配置一个永久二维码,这样当销售人员外出去拓展的时候,需要让所有被拓展对象扫一下这个二维码即可监控任务;另外企业可以把各种永久二维码放到自己广告的各个推广媒介上,通过扫码率去评定每个平台的广告转化效果等。
 
  5.2 长链接转短链接接口。将一条较长的URL使用特殊算法转化为短链接,主要使用场景: 开发者用于生成二维码的原链接(商品、支付二维码等)太长导致扫码速度和成功率下降,将原长链接通过此接口转成短链接再生成二维码将大大提升扫码速度和成功率。此接口主要用于开发者,对运营用不大。
 
  6. 界面丰富
 
  6.1 自定义菜单。通过此接口,开发者可以把公众号内网页的入口、自动回复、小程序界面入口有机的设置在公众号的菜单上,目前公众号菜单最多支持包括3个一级菜单,每个一级菜单最多支持5个二级菜单。一级菜单最多4个汉字,二级菜单最多7个汉字。目前公众号菜单支持多种功能:
 
  6.1.1 点击事件(click): 点击事件可以模拟用户发送消息跟第三方服务器通信并且返回对应消息内容。
 
  6.1.2 浏览事件(view):填写需要浏览的网页url地址,用户点击此类自定义菜单后会跳转到对应的网页,如果结合网页授权接口,更可以获取用户的基本信息。
 
  6.1.3 扫码推事件(scancodepush): 用户点击按钮后,微信会吊起扫一扫的工具,完成扫码后显示扫描结果(如果是URL,直接浏览该URL网页),且会将扫码结果传给开发者,开发者可以依据此事件下发消息。
 
  6.1.4 扫码推等待事件(scancodewaitmsg): 用户点击按钮后,微信公众号会返回个消息,用户点击该消息吊起扫一扫工具,完成扫码后显示扫描结果(如果是URL,直接浏览该URL网页),且会将扫码结果传给开发者,开发者可以依据此事件下发消息。
 
  6.1.5 系统拍照事件(picsysphoto):弹出系统拍照发图用户点击按钮后,微信客户端将调起系统相机,完成拍照操作后,会将拍摄的相片发送给开发者,并推送事件给开发者,同时收起系统相机,随后可能会收到开发者下发的消息。
 
  6.1.6 系统拍照或者相册发图事件(picphotooralbum):弹出拍照或者相册发图用户点击按钮后,微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程。
 
  6.1.7 弹出微信相册事件(picweixin):弹出微信相册发图器用户点击按钮后,微信客户端将调起微信相册,完成选择操作后,将选择的相片发送给开发者的服务器,并推送事件给开发者,同时收起相册,随后可能会收到开发者下发的消息。
 
  6.1.8 地理位置选择事件(locationselect):弹出地理位置选择器用户点击按钮后,微信客户端将调起地理位置选择工具,完成选择操作后,将选择的地理位置发送给开发者的服务器,同时收起位置选择工具,随后可能会收到开发者下发的消息。
 
  6.1.9 媒体类型事件(mediaid):下发消息(除文本消息)用户点击mediaid类型按钮后,微信服务器会将开发者填写的永久素材id对应的素材下发给用户,永久素材类型可以是图片、音频、视频、图文消息。请注意:永久素材id必须是在“素材管理/新增永久素材”接口上传后获得的合法id。
 
  6.1.10 跳转图文消息url事件(viewlimited):跳转图文消息URL用户点击viewlimited类型按钮后,微信客户端将打开开发者在按钮中填写的永久素材id对应的图文消息URL,永久素材类型只支持图文消息。请注意:永久素材id必须是在“素材管理/新增永久素材”接口上传后获得的合法id。
 
  6.2 个性化菜单。为了帮助公众号实现灵活的业务运营,目前认证过的公众号可实现个性化菜单接口,开发者可以通过该接口,让公众号的不同用户群体看到不一样的自定义菜单。开发者可以采用以下条件来设置用户看到的菜单:用户标签和分组、性别、手机操作系统、地区、语言。
 
  7. 素材管理
 
  7.1 新增永久素材。经常使用的一些图片、语音、视频、缩略图等素材,开发者可通过该接口上传到微信服务器永久使用。在公众号创建图文消息的时候,可以插入这些资源的链接。
 
  7.2 新增临时素材。公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件、多媒体消息的获取和调用等操作,是通过mediaid来进行的。素材管理接口对所有认证的订阅号和服务号开放。通过本接口,公众号可以新增临时素材(即上传临时多媒体文件)。
 
  二、功能服务类
 
  1. 智能接口
 
  1.1 语义理解接口。微信开放平台语义理解接口为自动帮助开发者将用户表达的句子进行分词,并且根据公众号的产品特点去进行内容反馈的一套语义接口。举例来说:语义接口可以把“查一下明天从北京到上海的南航机票”这样的一句话抽取出来区域信息和机票信息及航空公司信息作为关键词,然后便于开发者依据这些关键词进行检索并且返回用户期望的内容。
 
  2. 多客服接口
 
  2.1 获取客服聊天记录。此接口可以将用户和客服进行的聊天,在进行查询时候予以返回,便于第三方集中管理客服消息。
 
  2.2 客服管理。可以使用此接口进行微信客服的基本信息管理、获取,添加客服的账号、邀请绑定新客服、设置客服信息、上传客服头像、删除客服账号等动作。
 
  2.3 会话控制接口。此接口在客服和用户之间创建一个会话,便于用户和客户保持沟通通道。
 
  3. 微信支付接口
 
  3.1 用户刷卡支付。用户打开微信钱包的刷卡的界面,商户扫码后提交完成支付,此场景一般用于商家店内有扫码枪等扫码设备的情况,好处是用户极其简便,用户除了展示刷卡界面,什么都不需要做。
 
  3.2 公众号支付。用户在微信内进入商家的H5页面,页面内调用JSSDK完成支付,此支付方式还可以共享用户在微信内设置好的收货地址。
 
  3.3 扫码支付。用户打开微信扫一扫,扫描商户的二维码后完成的支付。
 
  3.4 H5支付。用户在微信以外的手机浏览器里请求微信支付的场景唤起微信支付。
 
  3.5 小程序支付。用户在微信小程序里使用微信支付的场景。
 
  3.6 代金券或立减金。微信支付代金券业务是基于微信支付,为了协助商户方便地实现营销优惠措施。针对部分有开发能力的商户,微信支付提供通过API接口实现运营代金券的功能。
 
  3.7 现金红包。此接口主要用于商户营销,商户可以使用此接口给用户直接发放不超过200元的现金红包,现金红包在用户拆开后会直接进入用户的微信零钱,使用此接口非常适合做各种营销活动。
 
  3.8 企业付款。微信公众号运营方可使用此接口吊起付款,直接给微信用户付款(可付超过200元的大额款),适用场景有:给用户发放大额奖励、服务商&代理商提现等类似场景,付款金额较大,建议使用时候进行审核或校验。
 
  4. 微信卡包接口
 
  4.1 创建卡券接口。调用此接口可创建微信内通用的卡券,该卡券可进入微信的卡包里,针对卡券创建接口,可创建的类型有卡券展示图片、卡券适用门店、卡券背景颜色、卡券类型、是否允许该卡券设置快速买单入口、买单推送事件等。
 
  4.2 投放卡券接口
 
  4.2.1 创建二维码接口。开发者可调用该接口生成一张卡券二维码,用户扫码后可以添加该卡券到卡包里。
 
  4.2.2 H5发放卡券接口。在微信内浏览器里,用户可在H5网页上行卡券领取,领取的卡券可以添加到卡包里。
 
  4.2.3 卡券货架投放卡券。卡券货架支持开发者通过调用接口生成一个卡券H5页面,进行卡券投放。
 
  4.2.4 群发卡券。公众号平台支持开发者调用该接口获取卡券并且嵌入图文消息里进行推送,用户在公众号里可直接查看到公众号运营者群发的卡券并且直接领取,如果卡券设置了核销和消费规则,还可以直接点击跳转到商城、小程序等应用里直接使用。
 
  4.2.5 投放渠道数据统计。卡券投放后,开发者可根据此接口统计每一批次卡券。
 
  4.3 核销卡券接口
 
  4.3.1 线上核销。线上核销指用户从券面进入一个HTML5网页后主动销券的过程,如微信商城用券、自助核销等。
 
  4.3.2 线下核销。指用户到店后,出示二维码或者出示串码,由收银员完成核销动作,如扫码核销、机具核销等。
 
  4.4 小程序打通
 
  4.4.1 小程序内领取卡券。商家在小程序内进行营销活动时,可以将卡券作为奖品、优惠兑换凭证发放给用户,用户领取到卡包后可以快捷地出示使用并进行核销。同时,某些票务类的小程序也可以将用户购买后的票券供用户添加至卡包,方便用户出示使用。
 
  4.4.2 小程序内查看卡券。开发者可以通过调用该接口允许用户在小程序内查看、出示自己的微信卡券。
 
  4.4.3小程序开卡功能。开发者可以在小程序里面开发自己的会员模块,并将开卡环节嵌入其中,微信卡券为小程序内会员开卡提供了“开卡组件功能”。用户可以快速拉取到用户之前在微信开卡填写的资料并预填,用户可以做到“一键开卡”。对商户而言,开卡组件集“开卡注册”和“添加至卡包”于一体,快捷开卡的同时可以省掉手机验证等环节,提高开卡率。
 
  4.4.4 卡券跳转小程序。商户创建卡券时可以将卡、券内的服务入口设置进入小程序服务。此接口对于引导获得卡券的用户直接去小程序消费极其有用。
 
  4.5 微信会员卡
 
  4.5.1 创建会员卡。开发者可使用此接口直接创建会员卡。
 
  4.5.2 投放会员卡。目前微信会员卡支持通过扫描二维码、在网页直接点击、卡券货架、公众号群发以及公众号被动回复消息领取,开发者可以选择一种或者多种。
 
  4.5.3 激活会员卡。 当用户领取会员卡“卡套”后,支持调用该口对会员卡进行激活,并设置会员信息的初始值,如积分、余额、等级、会员卡编号等会员信息。目前,微信会员卡支持三种激活方式,分别是接口激活、一键激活和自动激活。
 
  4.6 特殊票券
 
  4.6.1 会议/演出门票。当用户领取门票,调用更新门票接口将座位、入口等信息更新至门票。
 
  4.6.2 电影票电影票券主要分为以下两种:1、电影票兑换券,归属于团购券。2、选座电影票,在购买时需要选定电影、场次、座位,具备较强的时效性和特殊性,此类电影票券即文档中的电影票。
 
  三、网页服务类
 
  1. 网页授权接口:
 
  1.1 网页授权获取用户基本信息 如果用户在微信客户端中访问第三方网页,公众号可以通过微信网页授权机制,来获取用户基本信息,进而实现业务逻辑或者便于应用存储数据,通过网页授权可以获得的用户数据包含:openid(对于某个公众号,微信用户的唯一标识)、nickname(用户微信昵称)。sex(用户性别)、province(用户个人资料填写的省份)、city(普通用户个人资料填写的城市)、country(国家)、headimgurl(头像)、privilege(用户特权信息,json 数组,如微信沃卡用户为(chinaunicom))、unionid(只有在用户将公众号绑定到微信开放平台帐号后,才会出现该字段。)
 
  2. 基础接口
 
  2.1 判断当前客户端版本是否支持指定JS接口。此接口为微信服务器判断微信客户端是否支持某JS接口使用。
 
  2.2 获取jsapiticket jsapiticket是公众号用于调用微信JS接口的临时票据。正常情况下,jsapiticket的有效期为7200秒,在有效期之内,公众号可以使用该ticket调用微信JS接口。
 
  3. 分享接口
 
  3.1 获取“分享到朋友圈”按钮点击状态及自定义分享内容接口。控制微信网页是否可以分享到朋友圈,如果关了此接口的网页则不能向朋友圈分享。
 
  3.2 获取“分享给朋友”按钮点击状态及自定义分享内容接口。控制微信网页是否可以分享给好友,如果关了此接口的网页则不能向好友分享。
 
  3.3 获取“分享到QQ”按钮点击状态及自定义分享内容接口。控制微信网页是否可以分享给QQ好友,如果关了此口的网页则不能向QQ好友分享。
 
  3.4 获取“分享到腾讯微博”按钮点击状态及自定义分享内容接口。控制微信网页是否可以分享给腾讯微博,如果关了此接口的网页则不能向腾讯微博分享。
 
  4. 图像接口
 
  4.1 拍照或从手机相册中选图接口。使用微信JS网页接口调起微信打开拍照或者手机相册选图功能。
 
  4.2 预览图片接口。使用微信JS网页接口调起微信预览图片功能。
 
  4.3 上传图片接口。使用微信JS网页接口调起微信上传图片功能。
 
  4.4 下载图片接口。使用微信JS网页接口调起微信下载图片功能。
 
  5. 音频接口
 
  5.1 开始录音接口。使用微信JS网页接口调起微信录音功能。
 
  5.2 停止录音接口。使用微信JS网页接口调起微信停止录音功能。
 
  5.3 播放语音接口。使用微信JS网页接口调起微信播放语音功能。
 
  5.4 暂停播放接口。使用微信JS网页接口调起微信暂停播放语音功能。
 
  5.5 停止播放接口。使用微信JS网页接口调起微信停止播放语音功能。
 
  5.6 上传语音接口。使用微信JS网页接口调起微信上传语音功能。
 
  5.7 下载语音接口。使用微信JS网页接口调起微信下载语音功能。
 
  6. 智能接口
 
  6.1 识别音频并返回识别结果接口。根据用户用话筒输入的音频信息,识别并且返回识别后的字符串信息的接口。
 
  7. 设备信息接口
 
  7.1 获取网络状态接口。获取当前的网络状态是wifi还是3g还是4g的信息。
 
  8. 地理位置接口
 
  8.1 使用微信内置地图查看位置接口。通过经纬度的坐标调用微信内置地图打开指定位置。
 
  8.2 获取地理位置接口。通过用户点击的地图上位置返回对应位置的经纬度坐标。
 
  9. 界面操作接口
 
  9.1 隐藏右上角的菜单接口。打开此接口后微信会自动隐藏右上角的三个点的按钮,此按钮包含分享朋友圈、好友等功能。
 
  9.2 打开右上角的菜单接口。打开此接口后微信会自动打开右上角的三个点的按钮,此按钮包含分享朋友圈、好友等功能。
 
  9.3 关闭当前网页窗口接口。打开此接口后,在微信内点击某按钮即可调起功能关闭当前网页。
 
  9.4 批量隐藏功能按钮接口。此js接口内可设置是否打开分享朋友圈、是否可以分享微信好友或群等功能、
 
  9.5 批量显示功能按钮接口。此js接口内可设置是否打开分享朋友圈、是否可以分享微信好友或群等功能、
 
  9.6 显示所有功能按钮接口。打开此接口会显示微信右上角所有功能。
 
  10. 微信卡券
 
  10.1 调起适用于门店的卡券列表并获取用户选择列表。在网页内点击某个微信门店,会筛选适用于该门店的所有卡券,供客户选择。
 
  10.2 批量添加卡券接口。该接口调起后可批量添加卡券到用户微信卡包里。
 
  10.3 查看微信卡包中的卡券。点击此功能可以弹出微信卡包。
 
  11. 微信支付
 
  11.1 发起一次微信支付。使用网页的方式调起一次微信支付请求。

欢迎转载,转载请注明原文网址: http://www.seo-820.com/weixin/gongzhonghao/257.html

1.本站遵循行业规范,任何转载的稿件都会明确标注作者和来源;2.本站的原创文章,请转载时务必注明文章作者和来源,不尊重原创的行为我们将追究责任;3.作者投稿可能会经我们编辑修改或补充。

相关文章
网友点评