Mesej perkhidmatan pelanggan

Mesej Perkhidmatan Pelanggan

Apabila pengguna berinteraksi dengan akaun awam dengan tindakan tertentu (sila lihat penerangan di bawah untuk senarai tindakan tertentu), WeChat akan menolak data mesej kepada pembangun, dan pembangun boleh menggunakannya dalam tempoh masa (kini diubah suai kepada 48 jam ) Panggil antara muka perkhidmatan pelanggan dan hantar mesej kepada pengguna biasa dengan MENYATAKAN paket data JSON. Antara muka ini digunakan terutamanya untuk fungsi seperti perkhidmatan pelanggan yang memerlukan pemprosesan mesej manual, supaya pembangun boleh menyediakan pengguna dengan perkhidmatan yang lebih baik.

Senarai semasa tindakan yang dibenarkan adalah seperti berikut (platform awam akan mengemas kini senarai mengikut situasi operasi. Selepas tindakan berbeza dicetuskan, bilangan mesej yang dibenarkan untuk dihantar oleh antara muka perkhidmatan pelanggan adalah berbeza. Apabila nombor daripada mesej yang dihantar mencapai had atas, kod pemulangan ralat akan ditemui Sila lihat halaman penerangan kod pemulangan untuk butiran):

1、用户发送信息
2、点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的）
3、关注公众号
4、扫描二维码
5、支付成功
6、用户维权

Untuk membantu akaun awam menggunakan identiti perkhidmatan pelanggan yang berbeza untuk melayani kumpulan pengguna yang berbeza, perkhidmatan pelanggan. antara muka telah dinaik taraf Pembangun boleh mengurus akaun perkhidmatan pelanggan dan menetapkan avatar dan nama panggilan akaun perkhidmatan pelanggan. Keupayaan ini terbuka kepada semua akaun awam dengan kebenaran antara muka perkhidmatan pelanggan.

Selain itu, pembangun sila ambil perhatian bahawa semua tempat di mana media_id digunakan dalam antara muka ini kini boleh menggunakan media_id bahan kekal dalam pengurusan bahan.

. perkhidmatan pelanggan Selepas akaun rasmi menggunakan akaun perkhidmatan pelanggan yang berbeza untuk membalas, pengguna boleh melihat avatar perkhidmatan pelanggan dan nama panggilan.

Sila ambil perhatian bahawa anda mesti menyediakan ID WeChat terlebih dahulu untuk akaun awam di laman web rasmi platform awam sebelum anda boleh menggunakan keupayaan ini.

Tambah akaun perkhidmatan pelanggan

Pembangun boleh menambah akaun perkhidmatan pelanggan ke akaun rasmi melalui antara muka ini Setiap akaun rasmi boleh menambah sehingga 10 akaun perkhidmatan pelanggan. Permintaan panggilan antara muka adalah seperti berikut:

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN

POST contoh data adalah seperti berikut:

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

Arahan pengembalian (hasil pemulangan JSON apabila betul):

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

Sekiranya berlaku ralat, WeChat akan mengembalikan kod ralat dan maklumat lain, sila tanya maklumat ralat mengikut kod ralat

Ubah suai akaun perkhidmatan pelanggan

Pembangun boleh mengubah suai akaun perkhidmatan pelanggan untuk akaun rasmi melalui antara muka ini. Permintaan panggilan antara muka adalah seperti berikut:

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN

POST contoh data adalah seperti berikut:

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

Arahan pengembalian (hasil pemulangan JSON apabila betul):

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

Sekiranya berlaku ralat, WeChat akan mengembalikan kod ralat dan maklumat lain, sila tanya maklumat ralat mengikut kod ralat

Padam akaun perkhidmatan pelanggan

Pembangun boleh memadamkan akaun perkhidmatan pelanggan untuk akaun awam melalui antara muka ini. Permintaan panggilan antara muka adalah seperti berikut:

http请求方式: GET
https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN

POST contoh data adalah seperti berikut:

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

Arahan pengembalian (hasil pemulangan JSON apabila betul):

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

Sekiranya berlaku ralat, WeChat akan mengembalikan kod ralat dan maklumat lain, sila tanya maklumat ralat mengikut kod ralat

Tetapkan avatar akaun perkhidmatan pelanggan

Pembangun boleh menghubungi antara muka ini untuk memuat naik gambar sebagai avatar kakitangan perkhidmatan pelanggan Fail imej avatar mestilah dalam format jpg Imej bersaiz 640*640 untuk mencapai kesan terbaik. Permintaan panggilan antara muka adalah seperti berikut:

http请求方式: POST/FORM
http://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
调用示例：使用curl命令，用FORM表单方式上传一个多媒体文件，curl命令的具体用法请自行了解

Arahan pengembalian (hasil pemulangan JSON apabila betul):

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

Sekiranya berlaku ralat, WeChat akan mengembalikan kod ralat dan maklumat lain Sila tanya maklumat ralat berdasarkan kod ralat

Dapatkan semua akaun perkhidmatan pelanggan

Melalui antara muka ini, pembangun boleh mendapatkan maklumat asas perkhidmatan pelanggan yang ditetapkan dalam akaun rasmi, termasuk ID perkhidmatan pelanggan, nama panggilan perkhidmatan pelanggan dan akaun log masuk perkhidmatan pelanggan.

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

Arahan pulangkan (hasil pulangan JSON apabila betul):

{
    "kf_list": [
        {
            "kf_account": "test1@test", 
            "kf_nick": "ntest1", 
            "kf_id": "1001"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0"
        }, 
        {
            "kf_account": "test2@test", 
            "kf_nick": "ntest2", 
            "kf_id": "1002"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }, 
        {
            "kf_account": "test3@test", 
            "kf_nick": "ntest3", 
            "kf_id": "1003"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }
    ]
}

Apabila terdapat ralat, WeChat akan mengembalikan kod ralat dan maklumat lain Sila tanya maklumat ralat berdasarkan kod ralat

. 🎜

Perihalan parameter bersatu antara muka
.

akaun Pelayan pelanggan lengkap, formatnya ialah: awalan akaun @ akaun rasmi WeChat ID kf_nick ialah nama panggilan perkhidmatan pelanggan kf_id ialah nama panggilan pelanggan ialah nama panggilan perkhidmatan pelanggan , sehingga 6 Aksara Cina atau 12 aksara Inggeriskata laluanTidakKata laluan log masuk akaun perkhidmatan pelanggan, formatnya ialah nilai MD5 yang disulitkan 32-bit bagi teks biasa kata laluan.Kata laluan ini hanya digunakan dalam fungsi perkhidmatan berbilang pelanggan laman web rasmi platform awam Jika anda tidak menggunakan fungsi perkhidmatan berbilang pelanggan, anda tidak perlu menetapkan kata laluan.





media	Ya	Parameter ini hanya muncul apabila menetapkan avatar perkhidmatan pelanggan, iaitu bentuk- Pengenalan fail media dalam data termasuk nama fail, panjang fail, jenis kandungan dan maklumat lain

Hantar mesej teks

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

Hantar mesej Gambar

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    }
}

Hantar mesej suara

{
    "touser":"OPENID",
    "msgtype":"image",
    "image":
    {
      "media_id":"MEDIA_ID"
    }
}

Hantar mesej video

{
    "touser":"OPENID",
    "msgtype":"voice",
    "voice":
    {
      "media_id":"MEDIA_ID"
    }
}

Hantar mesej muzik

{
    "touser":"OPENID",
    "msgtype":"video",
    "video":
    {
      "media_id":"MEDIA_ID",
      "thumb_media_id":"MEDIA_ID",
      "title":"TITLE",
      "description":"DESCRIPTION"
    }
}

Hantar mesej grafik (klik untuk melompat ke pautan luar) Bilangan mesej grafik adalah terhad kepada 8. Ambil perhatian bahawa jika bilangan mesej grafik melebihi 8, tidak akan ada balasan.

{
    "touser":"OPENID",
    "msgtype":"music",
    "music":
    {
      "title":"MUSIC_TITLE",
      "description":"MUSIC_DESCRIPTION",
      "musicurl":"MUSIC_URL",
      "hqmusicurl":"HQ_MUSIC_URL",
      "thumb_media_id":"THUMB_MEDIA_ID" 
    }
}

Hantar mesej grafik (klik untuk melompat ke halaman mesej grafik. Bilangan mesej grafik adalah terhad kepada 8. Ambil perhatian bahawa jika bilangan mesej grafik melebihi 8, tidak akan ada balasan).

{
    "touser":"OPENID",
    "msgtype":"news",
    "news":{
        "articles": [
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         },
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         }
         ]
    }
}

Hantar kad dan kupon

{
    "touser":"OPENID",
    "msgtype":"mpnews",
    "mpnews":
    {
         "media_id":"MEDIA_ID"
    }
}

Beri perhatian khusus kepada antara muka mesej perkhidmatan pelanggan untuk menghantar kad dan kupon Hanya kad dengan kod bukan tersuai dan mod kod yang diimport disokong.

Sila ambil perhatian bahawa jika anda perlu menggunakan akaun perkhidmatan pelanggan untuk menghantar mesej (untuk memaparkan avatar tersuai dalam WeChat 6.0.2 dan ke atas), anda perlu menambah parameter perkhidmatan tersuai pada separuh kedua paket data JSON , seperti menghantar mesej teks Kemudian tukar kepada:

{
  "touser":"OPENID", 
  "msgtype":"wxcard",
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad"        
            },
}

pengguna biasa dibuka msgtypeisJenis mesej, teks ialah teks, gambar ialah imej, suara ialah suara, mesej video ialah video, mesej muzik ialah muzik, mesej grafik (klik untuk melompat ke pautan luaran) ialah berita, mesej grafik ( klik untuk melompat ke halaman mesej grafik ) ialah mpnews, kupon kad ialah wxcardkandungan ialah kandungan mesej teks media_id ialah gambar/mesej grafik/suara (klik untuk melompat ke halaman mesej grafik) ID media 🎜 mesej grafik / mesej video / Penerangan mesej muzikmusicurl ialahpautan muzikhqmusicurladalahpautan muzik berkualiti tinggi, persekitaran wifi memberi keutamaan untuk menggunakan pautan ini untuk memainkan muzikpicurl

Penerangan pemulangan antara muka

Contoh data pengembalian (hasil pemulangan JSON apabila betul):

← Arahan penyulitan dan penyahsulitan mesej

Antara muka penghantaran kumpulan lanjutan →

serahkan

Laman web PHP Cina

Adakah parameter	diperlukan	Penerangan
access_token	ialah	memanggil kelayakan antara muka




thumb_media_id	ialah ID media	gambar kecil
tajuk	Tiada	Tajuk mesej grafik/mesej video/mesej muzik



	Pautan yang melompat selepas mesej grafik diklik
Tidak	Pautan imej mesej grafik menyokong format JPG dan PNG Kesan terbaik ialah 640320 untuk imej besar dan 8080 untuk imej kecil imej

Mesej perkhidmatan pelanggan