高度なグループ送信インターフェイス
高度なグループ送信インターフェース
パブリック プラットフォーム Web サイトでは、サブスクリプション アカウントには 1 日あたり 1 つのグループ メッセージ権限が提供され、サービス アカウントには 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 | は、メディアファイル識別子です | フォームデータ、ファイル名があります、ファイル長、コンテンツタイプ、その他の情報 |
返送手順 通常の状況では、返送結果は次のようになります:
{
"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 個のグラフィック メッセージ | thumb_media_id | をサポートします。|
| 写真とテキストメッセージのサムネイルの media_id は、基本的なサポート - マルチメディア ファイルのアップロード インターフェイスで取得できます | author | |
| グラフィック メッセージの作成者 | title | |
| グラフィック メッセージのタイトル | content_source_url | |
| 画像とテキストメッセージのページで「原文を読む」をクリックした後のページはセキュリティ制限の対象となっており、Appstoreにジャンプする必要がある場合は、itunのショートリンクサービスをご利用ください。 .es または appsto.re、短いリンクの後に #wechat_redirect サフィックスを追加します。 | コンテンツ | |
| グラフィックメッセージページのコンテンツであり、HTMLタグをサポートしています。WeChat決済権限を持つ公式アカウントはaタグを使用できますが、他の公式アカウントは使用できません | ||
| ダイジェスト | いいえ | グラフィックメッセージの説明 |
| show_cover_pic | いいえ | カバーを表示するかどうか、1はを表示する、0 は表示しないことを意味します |
戻り値の説明
戻りデータの例 (正しい場合は JSON 戻り結果):
{
"type":"news",
"media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
"created_at":1391857799
}| パラメータ | 説明 |
|---|---|
| タイプ | メディアファイルタイプ、それぞれ写真(image)、音声(voice)、ビデオ(video)とサムネイル(thumb)、グラフィックメッセージ(ニュース)があります |
| media_id | メディアファイル/グラフィックメッセージをアップロードした後に取得される一意の識別子 |
| created_at | メディア ファイルのアップロード時間 |
错误时微信会返回错误码等信息，请根据错误码查询错误信息
根据标签进行群发【订阅号与服务号认证后均可用】
接口调用请求说明
http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN
POSTデータの説明
POSTデータの例は以下の通りです
グラフィック メッセージ (グラフィック メッセージの media_id は上記の方法で取得する必要があることに注意してください):
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
}テキスト:
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"text":{
"content":"CONTENT"
},
"msgtype":"text"
}音声 (ここでの media_id は、基本サポートでマルチメディア ファイルをアップロードおよびダウンロードすることによって取得する必要があることに注意してください) ):
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"voice":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"voice"
}画像 (ここでの media_id は、基本サポートでマルチメディア ファイルをアップロードおよびダウンロードすることによって取得する必要があることに注意してください):
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"image":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"image"
}Video
ここでのビデオの media_id は、POST リクエストを通じて取得する必要があることに注意してください次のインターフェイスに移動します: https:/ /file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST データは次のとおりです (ここでの media_id は、マルチメディアのアップロードとダウンロードによって取得する必要があります)基本サポートのファイル):
{
"media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
"title": "TITLE",
"description": "Description"
}戻り値は
{
"type":"video",
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
"created_at":1398848981
}次に、次のデータを POST (media_id を前のステップで取得した media_id に変更) して、
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"mpvideo":{
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc"
},
"msgtype":"mpvideo"
}card とクーポン メッセージを送信します (media_id に注意してください)グラフィック メッセージの情報は上記の方法で取得する必要があります):
りー| パラメータ | は必須ですか? | 説明 |
|---|---|---|
| filter | は、グラフィックメッセージの受信者を設定するために使用されます | |
| no | は、すべてを行うかどうかを設定するために使用されますユーザー送信、値は true または false です。グループ内のすべてのユーザーにメッセージを送信するには true を選択し、tag_id に基づいて指定されたグループ内のユーザーにメッセージを送信するには false を選択します | |
| いいえ | tag_idグループが送信されるタグ、ユーザー管理に参加するユーザーグループ化インターフェイス、is_to_all 値が true の場合、tag_id を入力する必要はありません | |
| は、画像と設定に使用される | 送信するテキストメッセージ | |
| は | グループメッセージに使用されるmedia_idです | |
| msgtype | は | によって送信されるメッセージのタイプです、グラフィックメッセージはmpnews、テキストメッセージはテキスト、音声は音声、音楽は音楽、写真はイメージ、ビデオはビデオ、カードクーポンwxcardです |
| タイトル | いいえ | メッセージのタイトル |
| 説明 | いいえ | メッセージの説明 |
| thumb_media_id | は | ビデオサムネイルのメディアID |
戻りの説明
戻りデータの例 (正しい JSON 戻り結果):
{
"filter":{
"is_to_all":false,
"tag_id":"2"
},
"wxcard":{
"card_id":"123dsdajkasd231jhksad"
},
"msgtype":"wxcard"
}| パラメータ | 説明 |
|---|---|
| type | メディア ファイル タイプ (画像と音声を含む)、ビデオ (ビデオ)、およびサムネイル(親指)、グラフィックメッセージはニュース |
| errcode | error code |
| errmsg | error message |
| msg_id | メッセージ送信タスクのID |
| ms g_data_id | データIDこのフィールドは、グラフィック メッセージをグループに送信する場合にのみ表示されます。これは、グラフィックおよびテキスト分析データ インターフェイスの対応するグラフィック メッセージのデータを取得するために使用できます。詳細については、msgid フィールドの概要を参照してください。グラフィックおよびテキスト分析データ インターフェイスで。 |
ご注意ください: 成功が返された場合は、一括送信タスクが正常に送信されたことを意味しますが、この時点で一括送信が終了したわけではありません。そのため、異常事態が発生する可能性がまだあります。後続の送信プロセス中に問題が発生し、ユーザーがメッセージを受信しません。たとえば、メッセージが時々管理されている、サーバーが不安定であるなどです。また、グループ送信タスクは一般に送信に時間がかかりますので、気長にお待ちください。
WeChatはエラーが発生した場合にエラーコード等を返しますので、エラーコードを基にエラー情報をご確認くださいOpenIDリストに基づいて一括送信【サブスクリプション】アカウントは利用できません、認証後にサービス アカウントが利用可能です]
インターフェース通話リクエストの説明
{
"errcode":0,
"errmsg":"send job submission success",
"msg_id":34182,
"msg_data_id": 206227730
}POSTデータの説明
POSTデータの例は以下の通りです
图文消息（注意图文消息的media_id需要通过上述方法来得到）：
http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN
文本：
{
"touser":[
"OPENID1",
"OPENID2"
],
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
}语音：
{
"touser":[
"OPENID1",
"OPENID2"
],
"msgtype": "text",
"text": { "content": "hello from boxer."}
}图片：
{
"touser":[
"OPENID1",
"OPENID2"
],
"voice":{
"media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT"
},
"msgtype":"voice"
}视频：
请注意，此处视频的media_id需通过POST请求到下述接口特别地得到： https://api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST数据如下（此处media_id需通过基础支持中的上传下载多媒体文件来得到）：
{
"touser":[
"OPENID1",
"OPENID2"
],
"image":{
"media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat"
},
"msgtype":"image"
}返回将为
{
"media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
"title": "TITLE",
"description": "Description"
}然后，POST下述数据（将media_id改为上一步中得到的media_id），即可进行发送
{
"type":"video",
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
"created_at":1398848981
}卡券：
りー| 参数 | 是否必须 | 说明 |
|---|---|---|
| touser | 是 | 填写图文消息的接收者，一串OpenID列表，OpenID最少2个，最多10000个 |
| mpnews | 是 | 用于设定即将发送的图文消息 |
| media_id | 是 | 用于群发的图文消息的media_id |
| msgtype | は | によって送信されるメッセージのタイプです、グラフィックメッセージはmpnews、テキストメッセージはテキスト、音声は音声、音楽は音楽、写真はイメージ、ビデオはビデオ、カードクーポンwxcardです |
| タイトル | いいえ | メッセージのタイトル |
| 説明 | いいえ | メッセージの説明 |
| thumb_media_id | は | ビデオサムネイルのメディアID |
返回说明
返回数据示例（正确时的JSON返回结果）：
{
"touser":[
"OPENID1",
"OPENID2"
],
"mpvideo":{
"media_id":"123dsdajkasd231jhksad",
"title":"TITLE",
"description":"DESCRIPTION"
},
"msgtype":"mpvideo"
}| 参数 | 说明 |
|---|---|
| type | 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb），次数为news，即图文消息 |
| errcode | 错误码 |
| errmsg | 错误信息 |
| msg_id | 消息发送任务的ID |
| msg_data_id | 消息的数据ID，，该字段只有在群发图文消息时，才会出现。可以用于在图文分析数据接口中，获取到对应的图文消息的数据，是图文分析数据接口中的msgid字段中的前半部分，详见图文分析数据接口中的msgid字段的介绍。 |
ご注意ください: 成功が返された場合は、一括送信タスクが正常に送信されたことを意味しますが、この時点で一括送信が終了したわけではありません。そのため、異常事態が発生する可能性がまだあります。後続の送信プロセス中に問題が発生し、ユーザーがメッセージを受信しません。たとえば、メッセージが時々管理されている、サーバーが不安定であるなどです。また、グループ送信タスクは一般に送信に時間がかかりますので、気長にお待ちください。
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
}| 参数 | 是否必须 | 说明 |
|---|---|---|
| msg_id | 是 | 发送出去的消息ID |
注意してください:
http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN
戻り値の説明
戻り値データの例 (正しい場合のJSON戻り結果):
{
"msg_id":30124
}| パラメータ | 説明 |
|---|---|
| errcode | エラーコード |
| エラーメッセージ | エラーメッセージ |
错误时微信会返回错误码等信息，请根据错误码查询错误信息
预览接口【订阅号与服务号认证后均可用】
开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求，在保留对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このフィールドは、WeChat IDのプレビューを実現するためにtowxnameに変更することもできます |
| 。 msgtype | 大量送信メッセージタイプ、グラフィックメッセージはmpnews、テキストメッセージはテキスト、音声は音声、音楽は音楽、写真は画像、ビデオはビデオ、カードクーポンはwxcard |
| media_id | グループメッセージのmedia_id |
| content | テキストメッセージを送信する際のテキストの内容 |
戻り値の説明
戻り値データの例 (正しい場合の JSON 戻り値):
{ "touser":"OPENID",
"wxcard":{
"card_id":"123dsdajkasd231jhksad",
"card_ext": "{\"code\":\"\",\"openid\":\"\",\"timestamp\":\"1402057159\",\"signature\":\"017bb17407c8e0058a66d72dcc61632b70f511ad\"}"
},
"msgtype":"wxcard"
}| パラメータ | 説明 |
|---|---|
| errcode | エラーコード |
| errmsg | エラーメッセージ |
| msg_id | メッセージID |
查询群发消息发送状态【订阅号与服务号认证后均可用】
接口调用请求说明
{
"towxname":"示例的微信号",
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
}POSTデータの説明
POSTデータの例は以下の通りです
{
"errcode":0,
"errmsg":"preview success",
"msg_id":34182
}| パラメータ | 説明 |
|---|---|
| msg_id | グループメッセージの送信後に返されるメッセージID |
戻りデータの例(正しい場合はJSONが返される結果):リー
パラメータ| msg_id | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| msg_status | |||||||||||||||||||||||||
イベントプッシュグループ送信結果グループ送信タスクは送信後一定時間後に完了する場合があるため、グループ送信インターフェースが呼び出された場合のみグループ送信タスクが与えられる 送信が成功したかどうかを示します。一括送信タスクが正常に送信された場合、一括送信タスクの終了時に、開発者が入力した開発者 URL (コールバック URL) にイベントがプッシュされます。公共のプラットフォーム上で。 なお、一括送信タスクは完全に完了するまでに時間がかかるため、一括送信タスクが完了しそうになった時点で、一括送信結果がプッシュされます。実際の状況からの特定のエラー Pused XML 構造は次のとおりです (正常に送信された場合): http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN
|
