Package com.foxinmy.weixin4j.qy.api

Class NotifyApi

  • public class NotifyApi
extends QyApi
    客服消息API
    Since:
    JDK 1.6
    Author:
    jinyu(foxinmy@gmail.com)
    See Also:
    发送接口说明, Text, Image, Voice, Video, File, News, MpNews

    • Constructor Detail

      • NotifyApi

        public NotifyApi​(com.foxinmy.weixin4j.token.TokenManager tokenManager)

    • Method Detail

      • sendNotifyMessage

        public IdParameter sendNotifyMessage​(NotifyMessage message)
                              throws com.foxinmy.weixin4j.exception.WeixinException
        发送消息提醒(需要管理员对应用有使用权限，对收件人touser、toparty、totag有查看权限，否则本次调用失败)

        1） 发送人员列表存在错误的userid：执行发送，开发者需注意返回结果说明
        2）发送人员不在通讯录权限范围内：不执行发送任务，返回首个出错的userid
        3）发送人员不在应用可见范围内：不执行发送任务，返回首个出错的userid

        Parameters:
        message - 消息对象
        Returns:
        如果无权限或收件人不存在，则本次发送失败；如果未关注，发送仍然执行。两种情况下均返回无效的部分（注：由于userid不区分大小写， 返回的列表都统一转为小写
        { "errcode": 0, "errmsg": "ok", "invaliduser": "UserID1", "invalidparty":"PartyID1", "invalidtag":"TagID1" }
        Throws:
        com.foxinmy.weixin4j.exception.WeixinException
        See Also:
        发送接口说明, Text, Image, Voice, Video, File, News, MpNews, NotifyMessage, IdParameter

      • sendCustomeMessage

        public com.foxinmy.weixin4j.http.weixin.ApiResult sendCustomeMessage​(CustomeMessage message)
                                                              throws com.foxinmy.weixin4j.exception.WeixinException
        发送客服消息
        Parameters:
        message - 消息对象
        Returns:
        发送结果
        Throws:
        com.foxinmy.weixin4j.exception.WeixinException
        See Also:
        客服接口说明, Text, Image, Voice, Video, File, CustomeMessage

      • getKfList

        public IdParameter[] getKfList​(KfType kfType)
                        throws com.foxinmy.weixin4j.exception.WeixinException
        获取客服列表
        Parameters:
        kfType - 客服类型 为空时返回全部类型的客服
        Returns:
        第一个元素为内部客服(internal),第二个元素为外部客服(external)
        Throws:
        com.foxinmy.weixin4j.exception.WeixinException
        See Also:
        IdParameter, 客服列表