Package com.foxinmy.weixin4j.wxa.api

Class CustomMessageApi

java.lang.Object

com.foxinmy.weixin4j.api.BaseApi

com.foxinmy.weixin4j.wxa.api.CustomMessageApi

public class CustomMessageApi
extends com.foxinmy.weixin4j.api.BaseApi

客服消息。

Since:

1.8

Field Summary

Fields inherited from class com.foxinmy.weixin4j.api.BaseApi

weixinExecutor

Constructor Summary

Constructors

Constructor	Description
CustomMessageApi(com.foxinmy.weixin4j.token.TokenManager tokenManager)
CustomMessageApi(com.foxinmy.weixin4j.token.TokenManager tokenManager, Properties properties)

Method Summary

Modifier and Type	Method	Description
protected String	getRequestUri(String key)
void	sendCustomMessage(CustomMessage customMessage)	发送客服消息。
void	typingCustomMessage(String toUser, Command command)	客服输入状态。
protected ResourceBundle	weixinBundle()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CustomMessageApi

public CustomMessageApi(com.foxinmy.weixin4j.token.TokenManager tokenManager)

CustomMessageApi

public CustomMessageApi(com.foxinmy.weixin4j.token.TokenManager tokenManager,
                        Properties properties)

Method Detail

sendCustomMessage

public void sendCustomMessage(CustomMessage customMessage)
                       throws com.foxinmy.weixin4j.exception.WeixinException

发送客服消息。

当用户和小程序客服产生特定动作的交互时（具体动作列表请见下方说明）， 微信将会把消息数据推送给开发者，开发者可以在一段时间内（目前修改为48小时）调用客服接口， 通过POST一个JSON数据包来发送消息给普通用户。 此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。

Parameters:

customMessage - the CustomMessage.

Throws:

com.foxinmy.weixin4j.exception.WeixinException - indicates getting access token failed, or sending custom message failed.

See Also:

发送客服消息

typingCustomMessage

public void typingCustomMessage(String toUser,
                                Command command)
                         throws com.foxinmy.weixin4j.exception.WeixinException

客服输入状态。

开发者可通过调用“客服输入状态接口”，返回客服当前输入状态给用户。

1. 此接口需要客服消息接口权限。
2. 如果不满足发送客服消息的触发条件，则无法下发输入状态。
3. 下发输入状态，需要客服之前30秒内跟用户有过消息交互。
4. 在输入状态中（持续15s），不可重复下发输入态。
5. 在输入状态中，如果向用户下发消息，会同时取消输入状态。

Parameters:

toUser - 普通用户(openid)

command - "Typing"：对用户下发“正在输入"状态；"CancelTyping"：取消对用户的”正在输入"状态

Throws:

com.foxinmy.weixin4j.exception.WeixinException - indicates getting access token failed, or sending typing status failed.

See Also:

客服输入状态

weixinBundle

protected ResourceBundle weixinBundle()

Specified by:

weixinBundle in class com.foxinmy.weixin4j.api.BaseApi

getRequestUri

protected String getRequestUri(String key)

Overrides:

getRequestUri in class com.foxinmy.weixin4j.api.BaseApi