정상적인 메시지를 받다
일반 메시지 수신
일반 WeChat 사용자가 공개 계정에 메시지를 보내면 WeChat 서버는 메시지의 XML 데이터 패킷을 개발자가 입력한 URL에 게시합니다.
참고:
1. 메시지 중복 재시도와 관련하여 msgid를 사용하여 메시지를 중복 제거하는 것이 좋습니다.
2. WeChat 서버가 5초 이내에 응답을 받지 못하면 연결이 끊어지고 요청이 다시 시작되며 총 3번의 재시도가 이루어집니다. 서버가 5초 이내에 처리 및 응답을 보장할 수 없는 경우
는 빈 문자열로 직접 응답할 수 있습니다. WeChat 서버는 이에 대해 아무 작업도 수행하지 않으며 재시도를 시작하지 않습니다. 자세한 내용은 "메시지 보내기 - 메시지에 수동 응답"을 참조하세요.
3. 개발자가 사용자 메시지에 5초 이내에 즉시 응답해야 하는 경우, 즉 "메시지 수동 응답 메시지 보내기" 인터페이스를 사용하여 사용자에게 수동적으로 응답해야 하는 경우
개발자 센터에서 수행할 수 있습니다. 공개 플랫폼의 공식 웹사이트 메시지 암호화를 설정합니다. 암호화가 활성화된 후에는 사용자가 보낸 메시지와 개발자가 회신한 메시지가 암호화됩니다(단, 고객 서비스
인터페이스와 같은 API 호출을 통해 개발자가 보낸 메시지는 영향을 받지 않습니다). 메시지 암호화 및 암호 해독에 대한 자세한 지침은 "메시지 보내기 - 수동 응답 메시지 암호화 및 암호 해독 지침"을 참조하세요.
각 메시지 유형의 푸시 XML 패킷 구조는 다음과 같습니다.
텍스트 메시지
<xml> |
웹 디버깅 도구를 사용하여 이 인터페이스를 디버깅하세요
그림 메시지
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1348831860</CreateTime> <MsgType><![CDATA[image]]></MsgType> <PicUrl><![CDATA[this is a url]]></PicUrl> <MediaId><![CDATA[media_id]]></MediaId> <MsgId>1234567890123456</MsgId> </xml> |
음성 메시지
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[voice]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <Format><![CDATA[Format]]></Format> <MsgId>1234567890123456</MsgId> </xml> |
제발 음성 활성화가 필요합니다. 인식 후 사용자가 공식 계정에 음성 메시지를 보낼 때마다 WeChat은 푸시된 음성 메시지 XML 패킷에 인식 필드를 추가합니다. (참고: 클라이언트 캐싱으로 인해 개발자는 새로운 팔로워에게 영향을 미치는 음성 인식 기능은 팔로우한 사용자에게 24시간이 소요됩니다. 개발자는 테스트를 위해 이 계정을 다시 팔로우할 수 있습니다. 음성 인식을 활성화한 후의 음성 XML 데이터 패킷은 다음과 같습니다.
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[voice]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <Format><![CDATA[Format]]></Format> <Recognition><![CDATA[腾讯微信团队]]></Recognition> <MsgId>1234567890123456</MsgId> </xml> |
매개변수 설명:
비디오 메시지
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[video]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId> <MsgId>1234567890123456</MsgId> </xml> |
작은 비디오 메시지
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[shortvideo]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId> <MsgId>1234567890123456</MsgId> </xml> |
웹 디버깅 도구를 사용하여 이 인터페이스를 디버깅하세요
Geolocation 메시지
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1351776360</CreateTime> <MsgType><![CDATA[location]]></MsgType> <Location_X>23.134521</Location_X> <Location_Y>113.358803</Location_Y> <Scale>20</Scale> <Label><![CDATA[位置信息]]></Label> <MsgId>1234567890123456</MsgId> </xml> |
링크 메시지
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1351776360</CreateTime> <MsgType><![CDATA[link]]></MsgType> <Title><![CDATA[公众平台官网链接]]></Title> <Description><![CDATA[公众平台官网链接]]></Description> <Url><![CDATA[url]]></Url> <MsgId>1234567890123456</MsgId> </xml> |
