API Program Mini WeChat menerima mesej dan acara

Terima mesej dan acara

---

Gunakan <contact-button/> pada halaman untuk memaparkan butang untuk memasuki sesi perkhidmatan pelanggan.

Apabila pengguna menghantar mesej dalam sesi perkhidmatan pelanggan (atau menolak peristiwa yang disebabkan oleh operasi pengguna tertentu tertentu), pelayan WeChat akan MENYIArkan paket mesej (atau acara) (format JSON atau XML) ke URL yang diisi oleh pemaju. Selepas menerima permintaan, pembangun boleh menggunakan antara muka mesej perkhidmatan pelanggan untuk bertindak balas secara tidak segerak.

Selepas pelayan WeChat menghantar mesej pengguna ke alamat pelayan pembangun program mini (dikonfigurasikan dalam tetapan pembangunan), jika pelayan WeChat tidak menerima respons dalam masa lima saat, ia akan memutuskan sambungan dan memulakan semula permintaan, mencuba semula tiga kali dalam jumlah , jika semasa penyahpepijatan, anda mendapati bahawa pengguna tidak dapat menerima mesej respons, anda boleh menyemak sama ada masa pemprosesan mesej tamat. Mengenai penyahduplikasian semula mesej, adalah disyorkan untuk menggunakan msgid untuk menyahduplikasi mesej dengan msgid. Adalah disyorkan untuk menggunakan FromUserName + CreateTime untuk mesej jenis acara untuk menghapuskan pertindihan.

Jika pelayan menerima permintaan dan ia #tidak perlu dimajukan kepada alat perkhidmatan pelanggan#, ia mesti membuat balasan berikut, supaya pelayan WeChat tidak akan melakukan apa-apa dengannya dan tidak akan memulakan percubaan semula , mesej ralat yang serius akan muncul. Sila lihat arahan di bawah untuk butiran:

1、直接回复success（推荐方式）
2、直接回复空串（指字节长度为0的空字符串，而不是结构体中content字段的内容为空）

Apabila situasi berikut berlaku, WeChat akan mengeluarkan gesaan sistem kepada pengguna dalam sesi program mini "Perkhidmatan pelanggan program mini ini tidak dapat menyediakan perkhidmatan buat sementara waktu, sila cuba lagi kemudian":

1、开发者在5秒内未回复任何内容
2、开发者回复了异常数据

Jika dibangunkan Jika anda ingin memajukan mesej atau acara ke alat perkhidmatan pelanggan, sila rujuk Mengirim Mesej ke Alat Khidmat Pelanggan. Sila rujuk kepada arahan alat perkhidmatan pelanggan untuk mengakses alat perkhidmatan pelanggan

Jika pembangun ingin meningkatkan keselamatan, mereka boleh menghidupkan penyulitan mesej dalam pusat pembangun Dengan cara ini, mesej yang dihantar oleh pengguna ke program mini dan balasan pasif mesej pengguna oleh program mini akan terus disulitkan Lihat penyulitan mesej dan arahan penyahsulitan untuk butiran.

Struktur paket data push JSON dan XML bagi setiap jenis mesej adalah seperti berikut.

Mesej teks

Apabila pengguna menghantar mesej teks dalam sesi perkhidmatan pelanggan, paket data berikut akan dijana:

Format XML

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1482048670</CreateTime>
   <MsgType><![CDATA[text]]></MsgType>
   <Content><![CDATA[this is a test]]></Content>
   <MsgId>1234567890123456</MsgId>
</xml>

JSON format

{
    "ToUserName": "toUser",
    "FromUserName": "fromUser",
    "CreateTime": 1482048670,
    "MsgType": "text",
    "Content": "this is a test",
    "MsgId": 1234567890123456
}

Parameter huraian

Pengguna dalam sesi perkhidmatan pelanggan Apabila menghantar mesej bergambar, paket data berikut akan dihasilkan:

Format XML

<xml>
      <ToUserName><![CDATA[toUser]]></ToUserName>
      <FromUserName><![CDATA[fromUser]]></FromUserName>
      <CreateTime>1482048670</CreateTime>
      <MsgType><![CDATA[image]]></MsgType>
      <PicUrl><![CDATA[this is a url]]></PicUrl>
      <MediaId><![CDATA[media_id]]></MediaId>
      <MsgId>1234567890123456</MsgId>
</xml>

Format JSON

{
    "ToUserName": "toUser",
    "FromUserName": "fromUser",
    "CreateTime": 1482048670,
    "MsgType": "image",
    "PicUrl": "this is a url",
    "MediaId": "media_id",
    "MsgId": 1234567890123456
}

Penerangan parameter

Masukkan sesi pengguna memasuki acara sesi perkhidmatan pelanggan melalui program mini "Butang Sesi Perkhidmatan Pelanggan", berikut akan dijana Pakej data:

Format XML

<xml>
    <ToUserName><![CDATA[toUser]]></ToUserName>  
    <FromUserName><![CDATA[fromUser]]></FromUserName>  
    <CreateTime>1482048670</CreateTime>  
    <MsgType><![CDATA[event]]></MsgType>  
    <Event><![CDATA[user_enter_tempsession]]></Event>  
    <SessionFrom><![CDATA[sessionFrom]]></SessionFrom> 
</xml>

Format JSON

{
    "ToUserName": "toUser",
    "FromUserName": "fromUser",
    "CreateTime": 1482048670,
    "MsgType": "event",
    "Event": "user_enter_tempsession",
    "SessionFrom": "sessionFrom"
}

Penerangan parameter

Majukan mesej ke alat khidmat pelanggan

Jika pembangun mahu mesej itu dimajukan ke alat perkhidmatan pelanggan untuk diproses, sila pulangkan pakej respons mengikut struktur berikut. Format data (XML atau JSON) bagi paket respons perlu konsisten dengan format data yang ditetapkan bagi mesej yang diterima.

Format XML

<xml>
    <ToUserName><![CDATA[toUser]]></ToUserName>
    <FromUserName><![CDATA[fromUser]]></FromUserName>
    <CreateTime>1482048670</CreateTime>
    <MsgType><![CDATA[transfer_customer_service]]></MsgType>
</xml>

Format JSON

{
    "ToUserName": "toUser",
    "FromUserName": "fromUser",
    "CreateTime": 1482048670,
    "MsgType": "transfer_customer_service",
}

Penerangan parameter