对用户发送消息－相信生活频道帮助中心

对用户发送消息

目录 [隐藏]
发送文本消息发送图片消息发送视频消息发送图文消息

对应的WebAPI SDK类说明：
PDSS.CivetPublic.User.MsgSender (.net)
msgsender.MsgSender (Java)
注：使用WebAPI SDK在之前时，需在操作平台“开发模式”>>“高级接口”中申请对应权限开通及密码设定。

此接口主要用于开发者主动给关注用户（服务用户）发送客服消息，方便开发者为用户提供更加优质的服务。它允许开发者通过OpenId 或者工号给订阅者发送主动响应消息，其中OpenId是根据接收者相信号加密后得到的一个唯一标识。
通过OpenId或者工号给用户发送消息都需要进行特定密码的验证，该验证密码在申请开通开发者时进行设定。

在发送图片、视频消息时需要预先上传对应的图片、视频文件到相信服务器，之后即可根据多媒体文件的MediaID进行调用。用户可以通过调用上传接口上传图片、视频。

接口调用请求说明：

调用接口地址为： https://civetinterface.foxconn.com/open/sendMsg
调用方法为：Post

目前支持消息回复类型有文本、图片、音频、视频、图文、广告，各消息类型的XML数据包结构如下：

发送文本消息

参数说明：

参数	描述
MsgType	text
FromUserName	生活频道账号
Password	密码
ToUserName	接收方账号（一个OpenId），通过OpenId发送消息时使用
ToCivetNo	接收人工号，通过相信号（目前为工号）发送消息时使用
Content	文本消息内容。支持A、BR标签，如：<a href="https://icivet.foxconn.com">相信下载</a>。

发送图片消息

参数说明：

参数	描述
MsgType	image
FromUserName	生活频道账号
Password	密码
ToUserName	接收方账号（一个OpenId），通过OpenId发送消息时使用
ToCivetNo	接收人工号，通过相信号（目前为工号）发送消息时使用
MediaID	图片消息ID，图片上传之後的唯一标识

发送视频消息

参数说明：

参数	描述
MsgType	video
FromUserName	生活频道账号
Password	密码
ToUserName	接收方账号（一个OpenId），通过OpenId发送消息时使用
ToCivetNo	接收人工号，通过相信号（目前为工号）发送消息时使用
MediaID	视频ID，视频上传之後的唯一标识
ThumbMediaID	视频消息缩略图ID，缩略图上传之後的唯一标识
Title	视频标题
Description	视频说明

发送图文消息

<xml>
        <MsgType>news</MsgType>
        <FromUserName>username</FromUserName>
        <Password>password</Password>
        <ToUserName>openid</ToUserName>   //或者 <ToCivetNo>civetno</ToCivetNo>
        <ArticleCount>2</ArticleCount>
        <CreateTime>2014-03-17T15:29:27.505Z</CreateTime>
        <Articles>
            <Article>
                <Title>
                    <![CDATA[title1]]>
                </Title>
                <Description>
                    <![CDATA[description1]]>
                </Description>
                <ImageMediaID><![CDATA[this is a ID]]></ImageMediaID>  //或者 <MediaUrl>url</MediaUrl>
                <Url>
                    <![CDATA[this is a url]]>
                </Url>
                <Author>
                    <![CDATA[author]]>
                </Author>
            </Article>
            <Article>
                <Title>
                    <![CDATA[title]]>
                </Title>
                <Description>
                    <![CDATA[description]]>
                </Description>
                <ImageMediaID><![CDATA[this is a ID]]></ImageMediaID>  //或者 <MediaUrl>url</MediaUrl>
                <Url>
                    <![CDATA[this is a url]]>
                </Url>
                <Author>
                    <![CDATA[author]]>
                </Author>
            </Article>
        </Articles>
    </xml>

参数说明：

参数	描述
MsgType	news
FromUserName	生活频道账号
Password	密码
ToUserName	接收方账号（一个OpenId），通过OpenId发送消息时使用
ToCivetNo	接收人工号，通过相信号（目前为工号）发送消息时使用
ArticleCount	图文消息个数（限制为5条以内)
CreateTime	发布时间
Title	图文消息标题
Description	图文消息描述
ImageMediaID	图片MediaID（JPG、PNG格式/大图360200/小图200200）
MediaUrl	图片MediaUrl地址
Url	点击图文消息跳转链接
Author	作者