Mesej Templat API Program Mini WeChat
Berdasarkan saluran pemberitahuan WeChat, kami menyediakan pembangun dengan keupayaan pemesejan templat yang boleh menjangkau pengguna dengan cekap, untuk mencapai perkhidmatan gelung tertutup dan memberikan pengalaman yang lebih baik.
Lokasi tolak templat: Pemberitahuan perkhidmatan
Syarat penghantaran templat: Dicetuskan selepas pengguna berinteraksi dengan halaman dalam sistem WeChat Untuk butiran, sila lihat huraian syarat penghantaran
Keupayaan lompat templat: Klik untuk melihat butiran dan boleh sahaja lompat ke halaman seterusnya. Setiap halaman akaun tempat templat dihantar
Arahan penggunaan
- Dapatkan ID templat
Log masuk ke https://mp.weixin.qq.com untuk mendapatkan templat . Jika tiada templat yang sesuai, anda boleh memohon untuk menambah templat baru dan menyemaknya Ia boleh digunakan selepas lulus. mesej templat.
Panggil antara muka untuk menghantar mesej templat (lihat penerangan antara muka untuk butiran)<form/>
组件,属性report-submit
为true
时,可以声明为需发模板消息,此时点击按钮提交表单可以获取formId
,用于发送模板消息。或者当用户完成支付行为,可以获取prepay_id
Penerangan antara muka- 1 antara muka. Sila simpan dengan betul. Sekurang-kurangnya 512 aksara ruang mesti dikhaskan untuk storan access_token. Tempoh sah access_token pada masa ini adalah 2 jam dan perlu dimuat semula dengan kerap. Pemerolehan berulang akan menyebabkan access_token terakhir menjadi tidak sah. Arahan tentang penggunaan dan penjanaan access_token yang diperlukan untuk panggilan API di platform awam:
- Untuk memastikan kerahsiaan apl, pihak ketiga memerlukan pelayan kawalan pusat untuk mendapatkan dan menyegarkan access_token. Token_akses yang digunakan oleh pelayan logik perniagaan lain datang dari pelayan kawalan pusat dan tidak boleh dimuat semula secara individu, jika tidak, token_akses akan ditimpa dan menjejaskan perniagaan
- Tempoh sah semasa akses_token disampaikan melalui expire_in yang dikembalikan; nilai pada masa ini 7200 saat. Pelayan kawalan pusat perlu memuat semula access_token baharu terlebih dahulu mengikut masa yang sah ini. Semasa proses muat semula, pelayan kawalan pusat masih mengeluarkan access_token lama Pada masa ini, bahagian belakang platform awam akan memastikan kedua-dua access_token lama dan baharu tersedia dalam masa yang singkat untuk penyegaran, yang memastikan peralihan pihak ketiga yang lancar. perniagaan;
- access_token adalah sah Masa boleh diselaraskan pada masa hadapan, jadi pelayan kawalan pusat bukan sahaja perlu menyegarkan secara aktif secara dalaman pada selang masa yang tetap, tetapi juga perlu menyediakan antara muka untuk menyegarkan akses_token secara pasif, supaya pelayan perniagaan boleh mencetuskan proses muat semula access_token apabila panggilan API mengetahui bahawa access_token telah tamat masa.
Pembayaran
Apabila pengguna melengkapkan tingkah laku pembayaran dalam program mini, pembangun dibenarkan untuk menolak bilangan mesej templat yang terhad kepada pengguna dalam masa 7 hari (satu bayaran boleh dikeluarkan setiap masa , bilangan urus niaga di bawah berbilang pembayaran adalah bebas dan tidak menjejaskan satu sama lain)
Serahkan borang
Apabila pengguna menyerahkan borang dalam program mini dan borang diisytiharkan untuk menghantar mesej templat, pembangun perlu sediakan pengguna dengan Apabila berkhidmat, pembangun boleh dibenarkan untuk menolak bilangan mesej templat yang terhad kepada pengguna dalam masa 7 hari (satu mesej boleh dihantar sebaik sahaja borang diserahkan dan bilangan mesej yang dihantar selepas berbilang penyerahan adalah bebas dan tidak mempengaruhi antara satu sama lain)
- Tidak dibenarkan mengeluarkan templat melalui akaun perkhidmatan untuk memaklumkan pengguna dalam program mini Kandungan berkaitan perkhidmatan yang dicetuskan Penalti keterangan
Pembangun boleh menggunakan AppID dan AppSecret untuk memanggil antara muka ini untuk mendapatkan access_token. AppID dan AppSecret boleh diperolehi dengan log masuk ke laman web rasmi platform awam WeChat - Tetapan - Tetapan Pembangunan (anda perlu terikat untuk menjadi pembangun, dan akaun itu tidak mempunyai status yang tidak normal). Sila simpan sendiri AppSecret selepas ia dijana, kerana setiap kali ia dijana dan dilihat pada platform awam, AppSecret akan ditetapkan semula. Ambil perhatian bahawa protokol https mesti digunakan semasa memanggil semua antara muka WeChat. Jika pihak ketiga tidak menggunakan pelayan kawalan pusat, tetapi memilih setiap titik logik perniagaan untuk menyegarkan access_token secara berasingan, konflik mungkin berlaku, yang membawa kepada ketidakstabilan perkhidmatan.
Alamat antara muka:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
Kaedah permintaan HTTP:
GET
Huraian parameter:
parameter
WeChat akan Mengembalikan Pakej data JSON berikut kepada pembangun:
{"access_token":"ACCESS_TOKEN","expires_in":7200}
Apabila ralat berlaku, WeChat akan mengembalikan kod ralat dan maklumat lain Contoh pakej data JSON adalah seperti berikut (contoh ini ialah ralat tidak sah AppID):
{"errcode":40013,"errmsg":"invalid appid"}2 Alamat antara muka: ( ACCESS_TOKEN perlu digantikan dengan access_token yang diperoleh di atas)
https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKENKaedah permintaan HTTP:
POSTPOST perihalan parameter:
{ "touser": "OPENID", "template_id": "TEMPLATE_ID", "page": "index", "form_id": "FORMID", "data": { "keyword1": { "value": "339208499", "color": "#173177" }, "keyword2": { "value": "2015年01月05日 12:30", "color": "#173177" }, "keyword3": { "value": "粤海喜来登酒店", "color": "#173177" } , "keyword4": { "value": "广州市天河区天河路208号", "color": "#173177" } }, "emphasis_keyword": "keyword1.DATA" }
Penerangan kod pulangkan:
Selepas memanggil antara muka mesej templat, paket data JSON akan dikembalikan. 🎜🎜Contoh paket data JSON yang dikembalikan apabila biasa: 🎜{ "errcode":0, "errmsg":"ok", }🎜Maklumat kod ralat akan dikembalikan apabila ralat berlaku, penerangan adalah seperti berikut:🎜
Pulangan kod | Penjelasan |
---|---|
40037 | template_id salah |
41037 | template_id salah |
410 | 28 id tidak betul|
form_id telah digunakan |
Kesan penggunaan:
Nota: Semasa fasa ujian dalaman, selepas mesej templat dikeluarkan, hanya pemberitahuan ringkas yang dikeluarkan oleh "Pembantu Keselamatan Akaun Rasmi" boleh dilihat pada pelanggan. Jika anda menerima gesaan ini, ini bermakna fungsi mesej templat telah berjaya dinyahpepijat. Selepas fungsi ini dilancarkan secara rasmi, ia akan dipaparkan seperti gambar di atas.
Keterangan syarat isu
Arahan Audit
1. Tajuk
1.1 Tajuk tidak boleh sama
1.2 Maksud tajuk tidak boleh terlalu serupa
mesti diakhiri dengan "tajuk yang tertinggal"1.3 pemberitahuan"
1.4 Tajuk tidak boleh mengandungi simbol khas, perkataan yang diperibadikan, dsb. Tiada Kandungan umum industri
1.5 Tajuk mesti menggambarkan senario perkhidmatan tertentu
1.6 Tajuk tidak boleh melibatkan kandungan berkaitan pemasaran, termasuk tetapi tidak terhad kepada :
Diskaun pengguna, rebat beli-belah, kemas kini produk, kupon dan baucar , sampul merah, kad keahlian, mata, aktiviti dan pemberitahuan arah aliran pemasaran yang lain
2.1 Di bawah tajuk yang sama, kata kunci tidak boleh sama
2.2 Di bawah tajuk yang sama, kata kunci tidak boleh terlalu serupa
2.3 Kata kunci tidak boleh mengandungi simbol khas, perkataan diperibadikan dan kandungan lain yang bukan seluruh industri
2.4 Contoh kandungan kata kunci mesti sepadan dengan kata kunci
2.5 Kata kunci. terlalu luas dan perlu mengehadkan, seperti: " "Kandungan" terlalu luas dan tidak boleh diluluskan
Perihalan Pelanggaran
Selain tidak melanggar spesifikasi pengendalian, peraturan berikut tidak boleh dilanggar, termasuk tetapi tidak terhad kepada:Templat yang menyebabkan gangguan kepada pengguna adalah tidak dibenarkan. Tujuan mengeluarkan templat kepada pengguna tidak dibenarkan. Templat dikeluarkan untuk tujuan pemasaran
Menurut pelanggaran, penalti kecerunan yang sepadan. akan diberikan. Peraturan penalti am adalah seperti berikut:
Untuk pelanggaran pertama, templat pelanggaran akan dipadamkan sebagai amaran,
Untuk pelanggaran kedua, larangan akan dikenakan 7 hari untuk antara muka
Pelanggaran ketiga akan mengakibatkan larangan antara muka selama 30 hari
Pelanggaran keempat akan mengakibatkan larangan antara muka kekal
Hasil penalti dan alasan akan dimaklumkan dalam bentuk mesej dalam tapak.