Interface d'envoi de groupe avancée


1474854569223323.png

Interface avancée d'envoi de groupe

Sur le site Web de la plateforme publique, les comptes d'abonnement disposent d'une autorisation de message de groupe par jour, et les comptes de service disposent de 4 autorisations de message de groupe par mois (mois naturel). Pour certains opérateurs de comptes publics disposant de capacités de développement, ils peuvent obtenir des capacités d'envoi de groupe plus flexibles grâce à l'interface d'envoi de groupe avancée.

Veuillez noter :

1、对于认证订阅号,群发接口每天可成功调用1次,此次群发可选择发送给全部用户或某个标签;
2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次,但是用户每月只能接收4条,无论在公众平台网站上,还是使用接口群发,用户每月只能接收4条群发消息,多于4条的群发将对该用户发送失败;
3、具备微信支付权限的公众号,在使用群发接口上传、群发图文消息类型时,可使用<a>标签加入外链;
4、开发者可以使用预览接口校对消息样式和排版,通过预览接口可发送编辑好的消息给指定用户校验效果。

Le processus d'envoi massif de messages graphiques est le suivant :

1、首先,预先将图文消息中需要用到的图片,使用上传图文消息内图片接口,上传成功并获得图片URL
2、上传图文消息素材,需要用到图片时,请使用上一步获取的图片URL
3、使用对用户标签的群发,或对OpenID列表的群发,将图文消息群发出去
4、在上述过程中,如果需要,还可以预览图文消息、查询群发状态,或删除已群发的消息等

Le processus d'envoi massif d'images, de textes et d'autres types de messages est le suivant :

1、如果是群发文本消息,则直接根据下面的接口说明进行群发即可
2、如果是群发图片、视频等消息,则需要预先通过素材管理接口准备好mediaID

À propos de l'utilisation de is_to_all comme vrai lors de l'envoi massif, il entrera dans le compte officiel dans la liste des messages historiques du client WeChat :

1、使用is_to_all为true且成功群发,会使得此次群发进入历史消息列表。
2、为防止异常,认证订阅号在一天内,只能使用is_to_all为true进行群发一次,或者在公众平台官网群发(不管本次群发是对全体还是对某个分组)一次。以避免一天内有2条群发进入历史消息列表。
3、类似地,服务号在一个月内,使用is_to_all为true群发的次数,加上公众平台官网群发(不管本次群发是对全体还是对某个分组)的次数,最多只能是4次。
4、设置is_to_all为false时是可以多次群发的,但每个用户只会收到最多4条,且这些群发不会进入历史消息列表。

De plus, les développeurs doivent noter que tous les endroits où media_id est utilisé dans cette interface peuvent désormais utiliser le matériel permanent media_id dans la gestion du matériel. Veuillez noter que les liens envoyés en utilisant le même matériel sont les mêmes, ce qui signifie que la suppression d'un certain groupe entraînera l'invalidité de l'intégralité du lien.

Téléchargez l'image dans le message graphique pour obtenir l'URL [disponible après l'authentification du compte d'abonnement et du compte de service]

Veuillez noter que les images téléchargées par cette interface n'occupent pas la Bibliothèque matérielle du compte officiel Le nombre d'images est limité à 5000. Les images ne prennent en charge que le format jpg/png et leur taille doit être inférieure à 1 Mo.

Description de la demande d'appel de l'interface

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"

Description des paramètres

.
Le paramètre est-il obligatoire ? Description
access_token est l'identifiant du fichier multimédia dans form-data, il y a un nom de fichier , longueur du fichier, type de contenu et autres informations

Instructions de retour Dans des circonstances normales, le résultat du retour est :

{
    "url":  "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}

où url est l'URL de l'image téléchargée, qui peut être utilisée lors d'un envoi de groupe ultérieur et placée dans des messages graphiques.

WeChat renverra le code d'erreur et d'autres informations en cas d'erreur. Veuillez vérifier les informations d'erreur en fonction du code d'erreur


Télécharger des messages graphiques [disponibles après certification de l'abonnement. compte et compte de service]

Description de la demande d'appel d'interface

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN

Description des données POST

Les exemples de données POST sont les suivants :

{
   "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
		 }
   ]
}
Articlesthumb_media_idauteurtitrecontent_source_urlcontent
Le paramètre est-il obligatoire ? Description
est un message graphique prend en charge 1 à 8 messages graphiques
Oui. Images et texte Le media_id de la vignette du message peut être obtenu dans l'interface de base de support-téléchargement de fichiers multimédias
NonL'auteur du message graphique
OuiLe titre du message graphique
NonLa page après avoir cliqué sur "Lire le texte original" sur la page d'image et de message texte est soumise à des restrictions de sécurité. Si vous devez accéder à l'Appstore, vous pouvez utiliser le service de liens courts d'itun. .es ou appsto.re, et après le lien court, ajoutez le suffixe #wechat_redirect.
est le contenu de la page de message graphique et prend en charge les balises HTML.Les comptes officiels avec les autorisations de paiement WeChat peuvent utiliser la balise a, les autres comptes officiels ne peuvent pas l'utiliser
digestNonDescription des messages graphiques
show_cover_picNonS'il faut afficher la couverture, 1 moyen display , 0 signifie ne pas afficher

Description de retour

Exemple de données de retour (résultat renvoyé par JSON lorsqu'il est correct) :

{
   "type":"news",
   "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
   "created_at":1391857799
}
ParamètresDescription
type type de fichier multimédia, respectivement Il y a des images (image), de la voix (voix), de la vidéo (vidéo) et des vignettes (pouce), des messages graphiques (actualités)
media_idL'identifiant unique obtenu après le téléchargement de fichiers multimédias/messages graphiques
create_atHeure de téléchargement du fichier multimédia

错误时微信会返回错误码等信息,请根据错误码查询错误信息


根据标签进行群发【订阅号与服务号认证后均可用】

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN

Description des données POST

Les exemples de données POST sont les suivants :

Message graphique (notez que le media_id du message graphique doit être obtenu via la méthode ci-dessus) :

{
   "filter":{
      "is_to_all":false,
      "tag_id":2
   },
   "mpnews":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"mpnews"
}

Texte :

{
   "filter":{
      "is_to_all":false,
      "tag_id":2
   },
   "text":{
      "content":"CONTENT"
   },
    "msgtype":"text"
}

Voix (notez que le media_id ici doit être obtenu en téléchargeant et en téléchargeant des fichiers multimédia dans le support de base ):

{
   "filter":{
      "is_to_all":false,
      "tag_id":2
   },
   "voice":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"voice"
}

Picture (notez que le media_id ici doit être obtenu en téléchargeant et en téléchargeant des fichiers multimédias dans le support de base) :

{
   "filter":{
      "is_to_all":false,
      "tag_id":2
   },
   "image":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"image"
}

Video

Veuillez noter que le media_id de la vidéo ici doit être obtenu via une requête POST à l'interface suivante : https://file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN Les données POST sont les suivantes (media_id doit ici être obtenu en téléchargeant et en téléchargeant du multimédia fichiers en support de base) :

{
  "media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
  "title": "TITLE",
  "description": "Description"
}

Le retour sera

{
  "type":"video",
  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
  "created_at":1398848981
}

Ensuite, POSTez les données suivantes (remplacez le media_id par le media_id obtenu à l'étape précédente) pour envoyer la

{
   "filter":{
      "is_to_all":false,
      "tag_id":2
   },
   "mpvideo":{
      "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc"
   },
    "msgtype":"mpvideo"
}

carte et le message du coupon (notez que le media_id du message graphique doit être obtenu par la méthode ci-dessus) :

{
   "filter":{
      "is_to_all":false,
      "tag_id":"2"
   },
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad"         
            },
   "msgtype":"wxcard"
}


Le paramètre est-il obligatoire ? Description
filter est utilisé pour définir le destinataire du message graphique
is_to_allnon est utilisé pour définir si Tous utilisateurs Envoyer, la valeur est vraie ou fausse, sélectionnez vrai pour envoyer le message à tous les utilisateurs d'un groupe, sélectionnez faux pour l'envoyer aux utilisateurs du groupe spécifié en fonction du tag_id
tag_idNonLe tag_id de le tag auquel le groupe est envoyé, participer à la gestion des utilisateurs Interface de regroupement des utilisateurs, si la valeur is_to_all est vraie, vous n'avez pas besoin de renseigner le tag_id
mpnews est utilisé pour définir l'image et messages texte à envoyer
media_id est le media_id utilisé pour les messages de groupe
msgtype est le type de message envoyé par , le message graphique est mpnews, le message texte est texte, la voix est voix, la musique est musique, l'image est image, la vidéo est vidéo, le coupon de carte est wxcard
titre NonTitre du message
descriptionNonDescription du message
thumb_media_id est L'identifiant média de la vignette de la vidéo
Description du retour (pouce), le message graphique est news

errcode

error code
errmsgerror message
msg_idID de la tâche d'envoi de message
msg_data_idL'identifiant des données du message. Ce champ n'apparaîtra que lors de l'envoi de messages graphiques à des groupes. Il peut être utilisé pour obtenir les données du message graphique correspondant dans l'interface de données d'analyse graphique et textuelle. Il s'agit de la première moitié du champ msgid dans l'interface de données d'analyse graphique et textuelle. Pour plus de détails, voir l'introduction du champ msgid. dans l'interface de données d'analyse graphique et textuelle.

Veuillez noter : Lorsque le succès est renvoyé, cela signifie que la tâche d'envoi de masse a été soumise avec succès, mais cela ne signifie pas que l'envoi de masse est terminé à ce moment-là Par conséquent, il est toujours possible qu'une situation anormale se produise. se produisent lors du processus d'envoi ultérieur et l'utilisateur ne reçoit pas le message, par exemple. Les messages sont parfois soumis à modération, les serveurs sont instables, etc. De plus, les Les tâches d'envoi de groupe prennent généralement beaucoup de temps à être envoyées, alors veuillez patienter.

WeChat renverra les codes d'erreur et d'autres informations en cas d'erreur. Veuillez vérifier les informations d'erreur en fonction du code d'erreur


Envoyer en masse selon la liste OpenID [Abonnement. le compte n'est pas disponible, le compte de service est disponible après certification]

Description de la demande d'appel d'interface

{
   "errcode":0,
   "errmsg":"send job submission success",
   "msg_id":34182, 
   "msg_data_id": 206227730
}

Description des données POST

Les exemples de données POST sont les suivants :

图文消息(注意图文消息的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
}

Coupon :

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "mpvideo":{
      "media_id":"123dsdajkasd231jhksad",
      "title":"TITLE",
      "description":"DESCRIPTION"
   },
    "msgtype":"mpvideo"
}


参数是否必须说明
touser填写图文消息的接收者,一串OpenID列表,OpenID最少2个,最多10000个
mpnews用于设定即将发送的图文消息
media_id用于群发的图文消息的media_id
msgtype est le type de message envoyé par , le message graphique est mpnews, le message texte est texte, la voix est voix, la musique est musique, l'image est image, la vidéo est vidéo, le coupon de carte est wxcard
titre NonTitre du message
descriptionNonDescription du message
thumb_media_id est L'identifiant média de la vignette de la vidéo

返回说明

返回数据示例(正确时的JSON返回结果):

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
        "wxcard": {"card_id":"123dsdajkasd231jhksad"}
        "msgtype":"wxcard"
}
参数说明
type媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),次数为news,即图文消息
errcode错误码
errmsg错误信息
msg_id消息发送任务的ID
msg_data_id消息的数据ID,,该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍。

Veuillez noter : Lorsque le succès est renvoyé, cela signifie que la tâche d'envoi de masse a été soumise avec succès, mais cela ne signifie pas que l'envoi de masse est terminé à ce moment-là Par conséquent, il est toujours possible qu'une situation anormale se produise. se produisent lors du processus d'envoi ultérieur et l'utilisateur ne reçoit pas le message, par exemple. Les messages sont parfois soumis à modération, les serveurs sont instables, etc. De plus, les Les tâches d'envoi de groupe prennent généralement beaucoup de temps à être envoyées, alors veuillez patienter.

WeChat renverra un code d'erreur et d'autres informations en cas d'erreur. Veuillez vérifier les informations d'erreur en fonction du code d'erreur


Supprimer le message de groupe [Disponible après l'abonnement. le compte et le compte de service sont authentifiés]

Après l'envoi groupé, vous pouvez supprimer l'envoi groupé à tout moment via cette interface.

接口调用请求说明

{
   "errcode":0,
   "errmsg":"send job submission success",
   "msg_id":34182, 
   "msg_data_id": 206227730
}

Description des données POST

Les exemples de données POST sont les suivants :

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN
参数是否必须说明
msg_id发送出去的消息ID

Veuillez noter :

{
   "msg_id":30124
}

Description de retour

Exemple de données de retour (résultat renvoyé par JSON lorsqu'il est correct) :

1、只有已经发送成功的消息才能删除
2、删除消息是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片。
3、删除群发消息只能删除图文消息和视频消息,其他类型的消息一经发送,无法删除。
4、如果多次群发发送的是一个图文消息,那么删除其中一次群发,就会删除掉这个图文消息也,导致所有群发都失效
ParamètresDescription
errcodeCode d'erreur
errmsg Message d'erreur

错误时微信会返回错误码等信息,请根据错误码查询错误信息


预览接口【订阅号与服务号认证后均可用】

开发者可通过该接口发送消息给指定用户,在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求,在保留对openID预览能力的同时,增加了对指定微信号发送预览的能力,但该能力每日调用次数有限制(100次),请勿滥用。

接口调用请求说明

{
   "errcode":0,
   "errmsg":"ok"
}

Description des données POST

Les exemples de données POST sont les suivants :

图文消息(其中media_id与根据分组群发中的media_id相同):

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN

文本:

{
   "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" 
}

视频(其中media_id与根据分组群发中的media_id相同):

{
    "touser":"OPENID",
    "image":{      
            "media_id":"123dsdajkasd231jhksad"
            },
    "msgtype":"image" 
}

卡券:

{
    "touser":"OPENID",
    "mpvideo":{  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",   
               },
    "msgtype":"mpvideo" 
}

请注意,上述JSON数据中的touser字段都可以改为towxname,这样就可以针对微信号进行预览(而非openID),towxname和touser同时赋值时,以towxname优先。修改后JSON数据如下(以图文消息为例): 图文消息:

{ "touser":"OPENID", 
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad",
            "card_ext": "{\"code\":\"\",\"openid\":\"\",\"timestamp\":\"1402057159\",\"signature\":\"017bb17407c8e0058a66d72dcc61632b70f511ad\"}"               
            }, 
  "msgtype":"wxcard" 
}
Paramètres Description
touserL'openid du compte officiel correspondant à l'utilisateur qui reçoit le message Ce champ peut également être modifié en towxname pour obtenir l'aperçu de WeChat ID
. msgtype Type de message, le message graphique est mpnews, le message texte est un texte, la voix est une voix, la musique est de la musique, l'image est une image, la vidéo est une vidéo, le coupon de carte est wxcard
media_idmedia_id pour les messages de groupe
contenuLe contenu du texte lors de l'envoi d'un SMS
Description du retour

errmsg

message d'erreur


msg_idID du message


查询群发消息发送状态【订阅号与服务号认证后均可用】

接口调用请求说明

{
   "towxname":"示例的微信号", 
   "mpnews":{              
            "media_id":"123dsdajkasd231jhksad"               
             },
   "msgtype":"mpnews" 
}

Description des données POST

Les exemples de données POST sont les suivants :

{
   "errcode":0,
   "errmsg":"preview success",
   "msg_id":34182
}
ParamètreDescription
msg_idL'identifiant du message renvoyé après l'envoi d'un message de groupe

Description de retour

Exemple de données de retour (résultat JSON renvoyé lorsqu'il est correct) :

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN
ParamètresDescription
msg_idL'identifiant du message renvoyé après l'envoi d'un message de groupe
msg_statusLe statut après l'envoi du message, SEND_SUCCESS signifie que l'envoi est réussi


Résultats de l'envoi de groupe push d'événement

Étant donné que la tâche d'envoi de groupe peut être terminée après un certain laps de temps après sa soumission, lorsque l'interface d'envoi de groupe est appelée, uniquement la tâche d'envoi de groupe sera donnée Indique si la soumission est réussie. Si la tâche d'envoi de masse est soumise avec succès, à la fin de la tâche d'envoi de masse, l'événement sera poussé vers l'URL du développeur (URL de rappel) renseignée par le développeur. sur la plateforme publique.

Il convient de noter que comme la tâche d'envoi de masse prend beaucoup de temps pour être complètement terminée, le résultat de l'envoi de masse sera poussé lorsque la tâche d'envoi de masse est sur le point d'être terminée. Le nombre de personnes poussées à ce moment-là aura. une certaine erreur par rapport à la situation réelle

Pushed La structure XML est la suivante (lorsqu'elle est envoyée avec succès) :

{
   "msg_id": "201053012"
}
ParameterDescription
ToUserNameLe compte WeChat du compte public
FromUserNameLe compte WeChat du groupe de comptes publics envoie le compte WeChat de l'assistant à
Créer TimeHorodatage de la création
MsgTypeType de message, voici l'événement
EventInformations sur l'événement, voici MASSSENDJOBFINISH
MsgIDMas sage ID
StatutLa structure d'envoi de groupe, est "envoi réussi" ou "envoi échoué" ou "erreur (num)". Cependant, lors de l'envoi réussi, un petit nombre d'utilisateurs peuvent ne pas recevoir de messages en raison du refus des utilisateurs de recevoir des messages de comptes officiels, d'erreurs système, etc. err(num) est la raison spécifique de l'échec de l'audit. Les situations possibles sont les suivantes :

err(10001), //erreur publicitaire suspectée(20001), //erreur politique suspectée(20004), //erreur sociale suspectée(20002). ), / /suspecté de pornographie err(20006), //suspecté de crimes illégaux err(20008), //suspecté de fraude err(20013), //suspecté de droit d'auteur err(22000), //suspecté de promotion mutuelle ( promotion mutuelle) err(21000), //Suspecté des autres

TotalCounttag_id nombre de fans ; ou le nombre de fans dans openid_list
FilterCountFiltering (le filtrage fait référence au filtrage de régions, de sexes et de rejets définis par l'utilisateur. L'utilisateur a reçu plus de 4 éléments Après filtrage), le nombre de fans prêts à être envoyés. En principe, FilterCount = SentCount + ErrorCount
SentCountLe nombre de fans envoyés avec succès
ErrorCountLe nombre de fans envoyés avec succès. à envoyer