고급 그룹 전송 인터페이스
고급 그룹 메시징 인터페이스
#🎜 🎜 #공개 플랫폼 웹사이트에서는 구독 계정에는 하루 1개의 그룹 메시지 권한이 제공되고, 서비스 계정에는 월(자연월) 4개의 그룹 메시지 권한이 제공됩니다. 개발 능력을 갖춘 일부 공개 계정 운영자의 경우 고급 그룹 전송 인터페이스를 통해 보다 유연한 그룹 전송 기능을 얻을 수 있습니다.
참고 사항:
1、对于认证订阅号，群发接口每天可成功调用1次，此次群发可选择发送给全部用户或某个标签； 2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次，但是用户每月只能接收4条，无论在公众平台网站上，还是使用接口群发，用户每月只能接收4条群发消息，多于4条的群发将对该用户发送失败； 3、具备微信支付权限的公众号，在使用群发接口上传、群发图文消息类型时，可使用<a>标签加入外链； 4、开发者可以使用预览接口校对消息样式和排版，通过预览接口可发送编辑好的消息给指定用户校验效果。
그래픽 메시지 대량 전송 과정은 다음과 같습니다.
1、首先，预先将图文消息中需要用到的图片，使用上传图文消息内图片接口，上传成功并获得图片URL 2、上传图文消息素材，需要用到图片时，请使用上一步获取的图片URL 3、使用对用户标签的群发，或对OpenID列表的群发，将图文消息群发出去 4、在上述过程中，如果需要，还可以预览图文消息、查询群发状态，或删除已群发的消息等
사진, 문자 및 기타 메시지 유형의 대량 전송 과정은 다음과 같습니다.
1、如果是群发文本消息，则直接根据下面的接口说明进行群发即可 2、如果是群发图片、视频等消息，则需要预先通过素材管理接口准备好mediaID
대량 전송 시 is_to_all을 true로 사용하는 방법에 대해, WeChat 클라이언트 기록 메시지 목록에 공식 계정이 입력됩니다:
1、使用is_to_all为true且成功群发，会使得此次群发进入历史消息列表。 2、为防止异常，认证订阅号在一天内，只能使用is_to_all为true进行群发一次，或者在公众平台官网群发（不管本次群发是对全体还是对某个分组）一次。以避免一天内有2条群发进入历史消息列表。 3、类似地，服务号在一个月内，使用is_to_all为true群发的次数，加上公众平台官网群发（不管本次群发是对全体还是对某个分组）的次数，最多只能是4次。 4、设置is_to_all为false时是可以多次群发的，但每个用户只会收到最多4条，且这些群发不会进入历史消息列表。
또한 개발자는 이 인터페이스에서 media_id가 사용되는 모든 장소에서 이제 자료 관리에서 영구 자료 media_id를 사용할 수 있다는 점에 유의하시기 바랍니다. 동일한 자료를 사용하여 발송된 링크는 동일하므로 특정 그룹을 삭제하면 전체 링크가 무효화된다는 점을 유의하시기 바랍니다.
URL을 얻으려면 그래픽 메시지에 있는 사진을 업로드하세요. [구독 계정 및 서비스 계정이 인증된 후 사용 가능]
이 인터페이스에서 업로드한 사진은 공식 계정의 자료 라이브러리 사진 수는 5000장으로 제한되어 있습니다. 이미지는 jpg/png 형식만 지원하며 크기는 1MB 미만이어야 합니다.
인터페이스 호출 요청 설명
http请求方式: POST https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN 调用示例（使用curl命令，用FORM表单方式上传一个图片）： curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
매개변수 설명
| 매개변수 | 가 필수인가요? | 설명 |
|---|---|---|
| access_token | 은 | 호출 인터페이스 자격 증명 |
| media | 은 | 의 미디어 파일 식별자입니다.form-data, 파일 이름이 있습니다 , 파일 길이, 콘텐츠 유형 및 기타 정보 |
반품 지침 일반적인 상황에서 반환 결과는 다음과 같습니다:
{
"url": "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}여기서 url은 업로드된 이미지의 URL이며, 후속 그룹 전송에 사용되고 그래픽 메시지에 배치될 수 있습니다.
WeChat에서는 오류가 발생한 경우 오류 코드 및 기타 정보를 반환합니다. 오류 코드에 따른 오류 정보를 확인하세요
그래픽 메시지 자료 업로드 [구독 인증 후 이용 가능] 계정 및 서비스 계정]
인터페이스 호출 요청 설명
http请求方式: POST https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN
POST 데이터 설명
POST 데이터 예시는 다음과 같습니다.
{
"articles": [
{
"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
"author":"xxx",
"title":"Happy Day",
"content_source_url":"www.qq.com",
"content":"content",
"digest":"digest",
"show_cover_pic":1
},
{
"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
"author":"xxx",
"title":"Happy Day",
"content_source_url":"www.qq.com",
"content":"content",
"digest":"digest",
"show_cover_pic":0
}
]
}| 매개변수 | 가 필요합니까? 설명 | |
|---|---|---|
| 는 | 그래픽 메시지 1~8개를 지원합니다. | |
| 예 | 사진 및 텍스트 메시지 썸네일의 media_id는 기본 지원-업로드 멀티미디어 파일 인터페이스에서 얻을 수 있습니다. | |
| No | 그래픽 메시지의 작성자 | |
| 예 | 그래픽 메시지의 제목 | |
| No | 이미지 및 문자 메시지 페이지에서 "원문 읽기"를 클릭하신 후 해당 페이지는 보안 제한이 있습니다. 앱스토어로 이동해야 할 경우, itun의 단축 링크 서비스를 이용하시면 됩니다. .es 또는 appsto.re, 짧은 링크 뒤에 #wechat_redirect 접미사를 추가하세요. | |
| 은 | 그래픽 메시지 페이지의 콘텐츠이며 HTML 태그를 지원합니다.위챗 결제 권한이 있는 공식 계정은 a 태그를 사용할 수 있으며, 다른 공식 계정은 사용할 수 없습니다 | |
| digest | No | 그래픽 메시지 설명 |
| show_cover_pic | No | 표지를 표시할지 여부는 1을 의미합니다. 0은 표시하지 않음을 의미합니다 |
반환 데이터 예(정확한 경우 JSON 반환 결과):
{
"type":"news",
"media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
"created_at":1391857799
}| type | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| media_id | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| created_at | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Parameter | 필수인가요 | 설명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 은 | 이며 그래픽 메시지의 수신자를 설정하는 데 사용됩니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| No | 은 모든 사용자에게 보낼지 여부를 설정하는 데 사용됩니다. 값은 true 또는 false를 선택하여 그룹의 모든 사용자에게 메시지를 보냅니다. tag_id를 기준으로 사용자가 보낸 태그의 tag_id입니다. is_to_all 값이 true이면 user 관리에서 user grouping 인터페이스에 참여합니다. # 보낼 정보를 설정하는 데 사용됩니다. 그래픽 메시지 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 는 그룹 메시지에 사용되는 media_id | #🎜입니다. #||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| msgtype | 은 | 의 메시지 유형이고, 문자 메시지는 텍스트이고, 음성은 음성입니다. 음악은 이미지, 영상은 영상, 쿠폰은 wxcard | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| title | No | # 🎜🎜#메시지 제목# 🎜🎜#|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| no | 메시지 설명 | #🎜🎜 ##🎜 🎜#thumb_media_id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 의 미디어 ID입니다. 반환 설명 반환 데이터 예(올바른 JSON 반환 결과): {
"filter":{
"is_to_all":false,
"tag_id":"2"
},
"wxcard":{
"card_id":"123dsdajkasd231jhksad"
},
"msgtype":"wxcard"
}
주의사항: 성공이 반환되면 대량발송 작업이 성공적으로 제출되었음을 의미하지만, 현재 대량발송이 종료된 것은 아닙니다. 후속 전송 프로세스에서는 여전히 예외가 될 수 있습니다. 상황에 따라 사용자가 메시지를 받지 못하는 경우가 있습니다. 예를 들어 메시지가 때때로 검토되고 있거나 서버가 불안정한 경우 등이 있습니다. 또한, 대량발송 작업은 일반적으로 발송에 오랜 시간이 걸리므로, 인내심을 갖고 기다려 주시기 바랍니다 . 오류가 발생하면 WeChat은 오류 코드 및 기타 정보를 반환합니다. # 🎜🎜#OpenID 목록에 따른 그룹 [구독 계정은 서비스 계정은 인증 후 이용 가능] #🎜🎜 #
|
| 参数 | 是否必须 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| touser | 是 | 填写图文消息的接收者，一串OpenID列表，OpenID最少2个，最多10000个 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| mpnews | 是 | 用于设定即将发送的图文消息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| media_id | 是 | 用于群发的图文消息的media_id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| msgtype | 은 | 의 메시지 유형이고, 문자 메시지는 텍스트이고, 음성은 음성입니다. 음악은 이미지, 영상은 영상, 쿠폰은 wxcard | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| title | No | # 🎜🎜#메시지 제목# 🎜🎜#|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| no | 메시지 설명 | #🎜🎜 ##🎜 🎜#thumb_media_id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 의 미디어 ID입니다. 返回说明 返回数据示例（正确时的JSON返回结果）： {
"touser":[
"OPENID1",
"OPENID2"
],
"mpvideo":{
"media_id":"123dsdajkasd231jhksad",
"title":"TITLE",
"description":"DESCRIPTION"
},
"msgtype":"mpvideo"
}
주의 사항: 성공이 반환되면 대량 발송 작업이 성공적으로 제출되었음을 의미하지만, 이때 대량 발송이 종료되었음을 의미하지는 않습니다 따라서 여전히 비정상적인 상황이 발생할 가능성이 있습니다. 후속 전송 과정에서 발생하고 사용자가 메시지를 수신하지 못하는 경우가 있습니다. 예를 들어 메시지가 때때로 조정 대상이 되거나 서버가 불안정해지는 등의 현상이 발생합니다. 또한, 그룹 발송 작업은 일반적으로 발송에 오랜 시간이 걸리므로 인내심을 갖고 기다려 주시기 바랍니다. WeChat에서는 오류가 발생한 경우 오류 코드 및 기타 정보를 반환합니다. 오류 코드에 따른 오류 정보를 확인하세요 그룹 메시지 삭제 [구독 계정 이후 사용 가능] 및 서비스 계정이 인증되었습니다]그룹 전송 후 이 인터페이스를 통해 언제든지 그룹 전송을 삭제할 수 있습니다. 接口调用请求说明 {
"touser":[
"OPENID1",
"OPENID2"
],
"wxcard": {"card_id":"123dsdajkasd231jhksad"}
"msgtype":"wxcard"
}POST 데이터 설명 POST 데이터 예시는 다음과 같습니다. {
"errcode":0,
"errmsg":"send job submission success",
"msg_id":34182,
"msg_data_id": 206227730
}
참고: http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN 반환 설명 반환 데이터 예(정확한 경우 JSON 반환 결과): {
"msg_id":30124
}
错误时微信会返回错误码等信息，请根据错误码查询错误信息 预览接口【订阅号与服务号认证后均可用】开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求，在保留对openID预览能力的同时，增加了对指定微信号发送预览的能力，但该能力每日调用次数有限制（100次），请勿滥用。 接口调用请求说明 1、只有已经发送成功的消息才能删除 2、删除消息是将消息的图文详情页失效，已经收到的用户，还是能在其本地看到消息卡片。 3、删除群发消息只能删除图文消息和视频消息，其他类型的消息一经发送，无法删除。 4、如果多次群发发送的是一个图文消息，那么删除其中一次群发，就会删除掉这个图文消息也，导致所有群发都失效 POST 데이터 설명 POST 데이터 예시는 다음과 같습니다. 图文消息（其中media_id与根据分组群发中的media_id相同）： {
"errcode":0,
"errmsg":"ok"
}文本： http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN 语音（其中media_id与根据分组群发中的media_id相同）： {
"touser":"OPENID",
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
}图片（其中media_id与根据分组群发中的media_id相同）： {
"touser":"OPENID",
"text":{
"content":"CONTENT"
},
"msgtype":"text"
}视频（其中media_id与根据分组群发中的media_id相同）： {
"touser":"OPENID",
"voice":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"voice"
}卡券： {
"touser":"OPENID",
"image":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"image"
}请注意，上述JSON数据中的touser字段都可以改为towxname，这样就可以针对微信号进行预览（而非openID），towxname和touser同时赋值时，以towxname优先。修改后JSON数据如下（以图文消息为例）： 图文消息： {
"touser":"OPENID",
"mpvideo":{ "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
},
"msgtype":"mpvideo"
}### ## ## ## #####매개 변수######설명### ## #####touser#🎜🎜 ## 🎜 🎜#메시지를 받는 사용자는 공식 계정의 openid에 해당합니다. 이 필드를 towxname으로 변경하여 WeChat ID를 미리 볼 수도 있습니다.
查询群发消息发送状态【订阅号与服务号认证后均可用】接口调用请求说明 {
"towxname":"示例的微信号",
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
}POST 데이터 설명 POST 데이터 예시는 다음과 같습니다. {
"errcode":0,
"errmsg":"preview success",
"msg_id":34182
}
반환 설명 반환 데이터 예(정확한 경우 JSON 반환 결과): 르 리에
이벤트 푸시 그룹 발송 결과그룹 발송 작업은 제출 후 일정 시간이 지나면 완료될 수 있으므로, 그룹 발송 인터페이스를 호출하면 단체발송 작업이 주어집니다. 대량발송 작업 제출 성공 여부를 나타내며, 대량발송 작업 종료 시 개발자가 입력한 개발자 URL(콜백 URL)로 이벤트가 푸시됩니다. 공개 플랫폼에서. 대량발송 작업이 완전히 완료되기까지 오랜 시간이 걸리기 때문에 대량발송 작업이 완료되려고 할 때 대량발송 결과가 푸시됩니다. 이때 푸시된 인원은 실제 상황에서 발생한 특정 오류 푸시됨 XML 구조는 다음과 같습니다(성공적으로 전송된 경우): http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN
|
