Antara muka mesej templat

Mesej templat hanya digunakan oleh akaun rasmi untuk menghantar pemberitahuan perkhidmatan penting kepada pengguna, dan hanya boleh digunakan dalam senario perkhidmatan yang memenuhi keperluan mereka, seperti pemberitahuan leret kad kredit, pemberitahuan kejayaan pembelian produk, dsb. . Mesej pemasaran seperti iklan dan semua mesej lain yang boleh menyebabkan gangguan kepada pengguna tidak disokong.

Mengenai peraturan penggunaan, sila ambil perhatian:

1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口，但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限；
2、需要选择公众账号服务所处的2个行业，每月可更改1次所选行业；
3、在所选择行业的模板库中选用已有的模板进行调用；
4、每个账号可以同时使用25个模板。
5、当前每个账号的模板消息的日调用上限为10万次，单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次，可在MP登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时，模板消息的日调用上限会相应提升，以公众号MP后台开发者中心页面中标明的数字为准。

Mengenai dokumen antara muka, sila ambil perhatian:

1、模板消息调用时主要需要模板ID和模板中各参数的赋值内容；
2、模板中参数内容必须以".DATA"结尾，否则视为保留字；
3、模板保留符号"{{ }}"。

🎜 🎜🎜Industri Tetapan boleh diselesaikan dalam MP , industri itu boleh diubah suai sebulan sekali, dan akaun hanya boleh menggunakan templat yang berkaitan dengan industri miliknya Untuk memudahkan pembangun pihak ketiga, kaedah mengubah suai industri yang dimiliki oleh akaun itu disediakan melalui panggilan antara muka. seperti berikut: 🎜🎜

Perihalan permintaan panggilan antara muka

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

POST keterangan data

POST contoh data adalah seperti berikut:

      {
          "industry_id1":"1",
          "industry_id2":"4"
       }

Parameter description

yang diperlukan access_token ialah kelayakan panggilan antara muka

Pertanyaan kod industri



industri_id1	ialah nombor industri yang	kepunyaan mesej templat akaun rasmi
industry_id2	ialah nombor industri di mana mesej templat akaun rasmi milik

Perkhidmatan IT2 IT TeknologiPerkakasan dan Peralatan IT3Teknologi ITTeknologi Elektronik4 Teknologi IT Komunikasi dan Operator Permainan Dalam Talian Bank🎜🎜7🎜🎜 Hotel TravelHotel11 Perjalanan HotelPerjalanan12Pengangkutan dan PergudanganEkspres 1314 15 1617Penyelidikan Kerajaan1819🎜🎜Farmaseutikal dan Penjagaan Kesihatan Penjagaan Perubatan Pengangkutan . Hartanah Hartanah30Barangan Pengguna Perkhidmatan perniagaanPerkhidmatan perantara34 Perkhidmatan PerniagaanPensijilan35Perkhidmatan PerniagaanAudit36Skanan dan HiburanSukan dan HiburanSukan38Sukan dan Hiburan Hiburan dan riadah39PercetakanPercetakan40

Dapatkan maklumat industri yang ditetapkan oleh akaun

Dapatkan maklumat industri yang ditetapkan oleh akaun. Maklumat industri boleh dilihat di laman web rasmi MP Untuk kemudahan pembangun pihak ketiga, maklumat industri yang ditetapkan oleh akaun diperolehi melalui panggilan antara muka adalah seperti berikut:

Arahan permintaan panggilan antara muka

http请求方式：GET
https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN

. Arahan parameter

Industri Utama	Sub-Industri	Kod
Teknologi IT	Internet/E-Dagang	1




		Teknologi IT
6		Industri Kewangan
Industri Kewangan	Dana\|Pengurusan Kewangan\|Amanah	8
Industri Kewangan	Insurans	9




		Pengangkutan Perang
	Pengangkutan dan Pergudangan	Gudang
	Pendidikan	Latihan
	Pendidikan	Sekolah

	Kerajaan dan Kemudahan Awam	Polis Trafik
Kerajaan dan Kemudahan Awam	Muzium	20
Kerajaan dan Kemudahan Awam	Utiliti Awam\|Institusi Bukan Untung dan Kejururawatan

22
Berkaitan motosikal	26

Kembalikan penerangan

Kembalikan contoh selepas panggilan yang betul:

{
"primary_industry":{"first_class":"运输与仓储","second_class":"快递"},
"secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}
}

Kembalikan perihalan parameter

Adakah parameter	diperlukan	Penerangan
access_token	ialah kelayakan panggilan antara muka

Penerangan

Adakah parameter	diperlukan?	Penerangan
Penerangan		Butiliti panggilan antara muka
primary_industry	ialah industri utama yang ditetapkan oleh	akaun
secondary_industry	ialah industri sekunder yang ditetapkan oleh	akaun

🎜🎜

Dapatkan ID templat

Pilih templat daripada perpustakaan templat industri ke bahagian belakang akaun Proses mendapatkan ID templat boleh diselesaikan dalam MP. Untuk kemudahan pembangun pihak ketiga, kaedah mendapatkan ID templat melalui panggilan antara muka disediakan, seperti berikut:

Keterangan permintaan panggilan antara muka

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

POST keterangan data

POST contoh data adalah seperti berikut:

      {
           "template_id_short":"TM00015"
       }

Penerangan parameter

. dalam perpustakaan templat Nombor templat, termasuk "TM **" dan " OPENTMTM**" dan bentuk lain

Kembalikan penerangan kod

Selepas memanggil antara muka mesej templat, paket data JSON akan dikembalikan. Contoh mengembalikan paket data JSON dalam keadaan biasa:

    {
           "errcode":0,
           "errmsg":"ok",
           "template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"
       }

Dapatkan senarai templat

Dapatkan senarai semua templat yang telah ditambahkan pada akaun maklumat dalam MP untuk kemudahan. Pembangun pihak ketiga menyediakan cara untuk mendapatkan semua maklumat templat di bawah akaun melalui panggilan antara muka, seperti berikut:

Arahan permintaan panggilan antara muka

http请求方式：GET
https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN

Arahan parameter

Kembalikan penerangan

Kembalikan contoh selepas panggilan yang betul:

{	
 "template_list": [{
      "template_id": "iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s",
      "title": "领取奖金提醒",
      "primary_industry": "IT科技",
      "deputy_industry": "互联网|电子商务",
      "content": "{ {result.DATA} }\n\n领奖金额:{ {withdrawMoney.DATA} }\n领奖  时间:{ {withdrawTime.DATA} }\n银行信息:{ {cardInfo.DATA} }\n到账时间:  { {arrivedTime.DATA} }\n{ {remark.DATA} }",
      "example": "您已提交领奖申请\n\n领奖金额：xxxx元\n领奖时间：2013-10-10 12:22:22\n银行信息：xx银行(尾号xxxx)\n到账时间：预计xxxxxxx\n\n预计将于xxxx到达您的银行卡"
   }]
}

Kembalikan huraian parameter

Adakah parameter	diperlukan	Penerangan
access_token	ialah kelayakan panggilan antara muka

ialah ID Templattajuk Tajuk templat primary_industry ialah industri utama industri di mana templat milik timbalan_industri merupakan kepunyaan industri kedua yang merupakan templat industri menengahkandungan ialah Kandungan templatcontoh ialah contoh templat

Memadamkan templat

Memadam templat boleh dilakukan dalam MP Untuk memudahkan pembangun pihak ketiga, kami menyediakan cara untuk memadamkan templat di bawah akaun :

Penerangan permintaan panggilan antara muka

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

Penerangan data POST adalah seperti berikut:

 {
     "template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
 }

Penerangan parameter

		ialah

ID mesej templat di bawah akaun awam

Arahan pengembalian

Selepas memanggil antara muka, paket data JSON akan dikembalikan. Contoh paket data JSON yang dikembalikan apabila biasa:

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

Menghantar mesej templat

Penerangan permintaan panggilan antara muka

POST Data contoh adalah seperti berikut :

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

Penerangan parameter

. ID lewat

Adakah parameter	diperlukan	Penerangan
access_token	ialah kelayakan panggilan antara muka	lewat

url

lompat templat Pautan ubah hala

data

ialah

data templat

Kembalikan perihalan kod

Selepas memanggil antara muka mesej templat, paket data JSON akan dikembalikan. Contoh paket data JSON pulangan biasa:

      {
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",            
           "data":{
                   "first": {
                       "value":"恭喜你购买成功！",
                       "color":"#173177"
                   },
                   "keynote1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keynote2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keynote3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"欢迎再次购买！",
                       "color":"#173177"
                   }
           }
       }

Tekan acara

Selepas tugasan penghantaran mesej templat selesai, pelayan WeChat tidak akan menghantar sama ada pelayan itu berjaya pemaju Dalam alamat konfigurasi pelayan diisi di tengah.

1 Apabila penghantaran berjaya, XML yang ditolak adalah seperti berikut:

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

Penerangan parameter

description akaunficial akaun weChat id Openid pengguna yang menerima template message creation time Mesej Jenisnya ialah acaraAcara itu adalah templat penghantaran mesej tamatid mesejus Status penghantaran berjaya

parameter
	tousername
	fromusername
	createTime
	msgtype
	Acara
	MsgID

🎜

2. Apabila penghantaran gagal disebabkan penolakan pengguna (tetapan pengguna enggan menerima mesej akaun rasmi), XML yang ditolak adalah seperti berikut:

           <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658920</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163836</MsgID>
           <Status><![CDATA[success]]></Status>
           </xml>

Parameter Penerangan

NamaAcara Acara adalah akhir penghantaran mesej templatMsgIDId mesejStatusStatus penghantaran ialah pengguna enggan menerima

3. Apabila penghantaran gagal kerana sebab lain, XML yang ditolak adalah seperti berikut:

           <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658984</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163840</MsgID>
           <Status><![CDATA[failed:user block]]></Status>
           </xml>

Parameter Keterangan

Parameter	Description
	User ID Wechat Akaun
FromUserName	Openid pengguna yang menerima mesej templat
CreateTime	Masa penciptaan
Mesej taip Msg

Nama PenggunaAkaun Rasmi acara tamatMsgID message idStatus

Parameter	Penerangan
ToUserName	Nama Pengguna
DariNama Pengguna	Terima templat Pembukaan pengguna mesej
CreateTime	Masa penciptaan
MsgType	Jenis mesej ialah acara

Status penghantaran gagal dihantar (bukan pengguna ditolak)

🎜🎜🎜🎜🎜🎜🎜🎜🎜

← Antara muka penghantaran kumpulan lanjutan

Spesifikasi operasi mesej templat →

serahkan

Antara muka mesej templat