カスタマーサービスメッセージ

ユーザーが特定のアクションでパブリックアカウントと対話すると（特定のアクションリストについては以下の説明を参照してください）、WeChatはメッセージデータを開発者にプッシュし、開発者はそのメッセージデータを次の期間内に使用できます。 time (現在は 48 時間に変更されています) カスタマー サービス インターフェイスを呼び出し、JSON データ パケットを POST して一般ユーザーにメッセージを送信します。このインターフェイスは主に、開発者がユーザーにより良いサービスを提供できるように、手動のメッセージ処理が必要なカスタマー サービスなどの機能に使用されます。

現在の許可されているアクションのリストは次のとおりです (パブリック プラットフォームは操作状況に応じてリストを更新します。さまざまなアクションがトリガーされた後、カスタマー サービス インターフェイスによって送信できるメッセージの数は異なります。送信されるメッセージの数が上限に達すると、エラー リターン コードが発生します。詳細については、リターン コードの説明ページを参照してください):

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

パブリック アカウントが異なるカスタマー サービス ID を使用して異なるユーザー グループにサービスを提供できるようにするため、カスタマー サービスはインターフェイスがアップグレードされ、開発者は顧客サービス アカウントを管理し、顧客サービス アカウントのアバターとニックネームを設定できるようになりました。この機能は、カスタマー サービス インターフェイス権限を持つすべてのパブリック アカウントに公開されています。

さらに、開発者は、このインターフェイスで media_id が使用されるすべての場所で、マテリアル管理で永続的なマテリアル media_id を使用できることにご注意ください。

カスタマーサービスアカウント管理

開発者が開発ドキュメントの要件に従って開発を完了した後、バージョン6.0.2以降を使用しているWeChatユーザーは、WeChatの公式アカウントと通信します。公式アカウントが別のカスタマー サービス アカウントを使用して返信すると、ユーザーは対応するカスタマー サービスのアバターとニックネームを確認できるようになります。

この機能を使用する前に、まずパブリック プラットフォームの公式 Web サイトでパブリック アカウントの WeChat ID を設定する必要があることに注意してください。

カスタマーサービスアカウントを追加

開発者は、このインターフェースを通じてカスタマーサービスアカウントを公式アカウントに追加できます。各公式アカウントは最大 10 個のカスタマーサービスアカウントを追加できます。インターフェース呼び出しリクエストは次のとおりです:

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

POST データの例は次のとおりです:

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

Return 命令 (正しい場合は JSON が結果を返します):

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

エラーの場合、WeChat はエラー コードとその他の情報を返します。クエリしてください。エラーコードに応じたエラー情報

カスタマー サービス アカウントを変更する

開発者は、このインターフェイスを通じて公開アカウントのカスタマー サービス アカウントを変更できます。インターフェース呼び出しリクエストは次のとおりです:

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

POST データの例は次のとおりです:

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

Return 命令 (正しい場合は JSON が結果を返します):

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

エラーの場合、WeChat はエラー コードとその他の情報を返します。クエリしてください。エラーコードに応じたエラー情報

カスタマーサービスアカウントを削除する

開発者は、このインターフェースを通じて公式アカウントのカスタマーサービスアカウントを削除できます。インターフェース呼び出しリクエストは次のとおりです:

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

POST データの例は次のとおりです:

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

Return 命令 (正しい場合は JSON が結果を返します):

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

エラーの場合、WeChat はエラー コードとその他の情報を返します。クエリしてください。エラーコードに応じたエラー情報

カスタマー サービス アカウントのアバターを設定します

開発者は、このインターフェイスを呼び出して、カスタマー サービス スタッフのアバターとして写真をアップロードできます。アバター画像ファイルは jpg 形式を使用することをお勧めします。最高の効果を得るには、640*640 サイズの画像を使用します。インターフェース呼び出しリクエストは次のとおりです:

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

リターン命令(正しい場合はJSONで結果を返します):

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

エラーの場合、WeChatはエラーコードとその他の情報を返します。エラーコードに基づいてエラー情報を問い合わせてください

。

すべてのカスタマー サービス アカウントを取得する

このインターフェイスを通じて、開発者は、カスタマー サービス ID、カスタマー サービスのニックネーム、カスタマー サービスのログイン アカウントなど、公式アカウントに設定されている基本的なカスタマー サービス情報を取得できます。

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

返信手順 (正しい場合はJSONが結果を返します):

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

エラーの場合、WeChatはエラーコードとその他の情報を返します

。

インターフェイスの統一されたパラメータの説明
パラメーター

は必須ですか? 完全なクライアント サーバー アカウント。形式は次のとおりです: アカウント プレフィックス @公式アカウント WeChat ID kf_nick は カスタマーサービスのニックネームです kf_id は カスタマーサービス ID です ニックネームカスタマーサービスニックネーム、最大6個漢字または 12 文字の英語パスワードいいえカスタマー サービス アカウントのログイン パスワード。形式は、パスワード プレーン テキストの 32 ビット暗号化 MD5 値です。このパスワードは、公開プラットフォームの公式ウェブサイトの複数顧客サービス機能でのみ使用されます。複数顧客サービス機能を使用しない場合は、パスワードを設定する必要はありません。

メディア	はい	このパラメータは、フォームであるカスタマー サービス アバターを設定する場合にのみ表示されます。データ内のメディア ファイル識別には、ファイル名、ファイル長、コンテンツ タイプ、その他の情報が含まれます

カスタマーサービスインターフェース - メッセージ送信

インターフェース呼び出しリクエストの説明

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

各メッセージタイプに必要なJSONデータパケットは次のとおりです:テキストメッセージ

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

画像メッセージを送信

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

音声メッセージを送信

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

ビデオメッセージを送信

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

音楽メッセージを送信

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

グラフィックメッセージを送信 (クリックすると外部リンクに移動します) グラフィックメッセージの数は 8 個に制限されています。グラフィックメッセージの数が 8 個を超えると応答がありませんので注意してください。

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

グラフィック メッセージを送信します (クリックするとグラフィック メッセージのページに移動します)。グラフィック メッセージの数は 8 に制限されています。グラフィック メッセージの数が 8 を超えると応答がありませんので注意してください。

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

カードとクーポンを送信する

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

カードとクーポンを送信するためのカスタマー サービス メッセージ インターフェイスに特に注意してください。非カスタム コード コードとインポートされたコード モード カードのみがサポートされています。

メッセージを送信するためにカスタマーサービスアカウントを使用する必要がある場合（WeChat 6.0.2以降でカスタムアバターを表示するため）、JSONデータパケットの後半にcustomserviceパラメータを追加する必要があることに注意してください。 、テキスト メッセージの送信など、次のように変更します:

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    },
    "customservice":
    {
         "kf_account": "test1@kftest"
    }
}

のメディアIDです

パラメータ	は必須ですか?	説明
access_token	は	呼び出しインターフェース認証情報
touser	は	一般ユーザーのopenid
msgtype	is	メッセージタイプ、テキストはテキスト、画像はイメージ、音声は音声、ビデオメッセージはビデオ、音楽メッセージは音楽、グラフィックメッセージ（クリックすると外部リンクにジャンプします）はニュース、グラフィックメッセージ（クリックするとグラフィックメッセージページにジャンプします）はmpnews、カードクーポンはwxcardです
content	は	テキストメッセージコンテンツです
media_id	は送信された写真/音声/ビデオ/グラフィックメッセージです	(クリックするとグラフィックメッセージページにジャンプします) メディアID
thumb_media_id	は	thumbnail
title	No	グラフィックメッセージ/ビデオメッセージ/ミュージックメッセージのタイトル
description	No	グラフィックメッセージ/ビデオメッセージ/説明音楽メッセージの
musicurl	は	音楽リンク
hqmusicurl	は	高品質の音楽リンクです。Wi-Fi環境では、このリンクを使用して音楽を再生することが優先されます
url	いいえ	グラフィックメッセージをクリックするとジャンプするリンク
picurl	いいえ	グラフィックメッセージの画像リンクは、JPGおよびPNG形式をサポートしています。最大の効果は、大きい画像の場合は640*320、小さい画像の場合は80*80です。画像

インターフェースの戻り値の説明

戻りデータの例 (正しい場合の JSON 戻り結果):