WeChatカスタマーサービス管理

##https://api.weixin.qq.com/ cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

}

パラメータの説明

##パラメータ説明##kf_accountkf_nick kf_idカスタマーサービス番号##invite_expire_timeinvite_status 招待のステータスには、確認を待っている「waiting」、拒否された「rejected」、# #

基本的なカスタマー サービス情報の取得

##電話の指示

カスタマー サービス アカウントを完成させます。形式は次のとおりです: アカウント プレフィックス@パブリック アカウント WeChat ID
カスタマー サービス ニックネーム
kf_headimgurl	カスタマー サービス アバター
kf_wx	カスタマー サービス アカウントにバインドされているカスタマー サービス スタッフの WeChat ID、 WeChat ID はここに表示されます
invite_wx	カスタマー サービス アカウントの場合WeChat ID にバインドされていませんが、バインディング招待が開始されました。 バインディング招待の WeChat ID がここに表示されます
	カスタマー サービス アカウントが WeChat ID にバインドされていないが、バインドされた招待が開始された場合、 招待の有効期限は UNIX タイムスタンプです
	expired 「期限切れ」 # が含まれます。

1#http リクエスト メソッド: GET

#返品の説明

2	https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN

1戻りデータの例 (正しい場合は JSON 結果が返されます):

2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

{ "kf_online_list ": [ "kf_account" { "kf_account" " : 「test1@test」、 「ステータス」: 1, 「kf_id」: 「1001」, 「accepted_case」: 1 }, { 「kf_account」: 「test2@test」, "ステータス": 1, "kf_id": "1002", 「accepted_case」: 2 } ] }

パラメータの説明

パラメータ	説明
kf_account	完全なカスタマー サービス アカウント、形式は次のとおりです: アカウント プレフィックス@public WeChat ID
status	カスタマー サービスのオンライン ステータス、現在: 1. web online
kf_id	カスタマー サービス番号
accepted_case	カスタマー サービスが現在受信しているセッションの数

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

##電話の手順

#1http リクエスト メソッド: POST

パラメータの説明

2 3 4 5 6 7

https://api.weixin.qq.com/customservice/kfaccount/ add?access_token=ACCESS_TOKEN POST データの例は次のとおりです。 { "kf_account" : "test1@test", "ニックネーム" : "カスタマー サービス 1" }

参数	说明
kf_account	完整客服帐号，格式为：帐号前缀@公众号微信号，帐号前缀最多10个字符，必须是英文、数字字符或者下划线，后缀为公众号微信号，长度不超过30个字符
nickname	客服昵称，最长16个字

#返品の説明

1

メインリターンコード

2 3 4 5

戻りデータの例 (正しい場合は JSON が結果を返します): { 「エラーコード」 : 0, 「エラーメッセージ」 : 「わかりました」 ##}

#戻りコード説明0成功65400API は利用できません。つまり、新しいカスタマー サービス機能がアクティブ化/アップグレードされていません65403顧客サービスのニックネームは不正です65404カスタマー サービス アカウントは不正です

	#
65405	アカウント数が上限に達したため、これ以上追加できません
65406	既存のお客様サービス アカウント

#カスタマー サービス アカウントのバインドへの招待

新しく追加されたカスタマー サービス アカウントは直接使用できません。バインドできるのはカスタマー サービス スタッフのみですカスタマーサービスアカウントを設定すると、ウェブカスタマーサービスにログインして操作できるようになります。このインターフェイスは、顧客サービス スタッフの WeChat ID へのバインディング招待を開始します。顧客サービス スタッフは、アカウントを使用する前に、WeChat クライアント上の WeChat ID を確認する必要があります。 WeChat ID にバインドされていないアカウントは、招待操作にバインドできますが、招待の有効期限が切れていない場合、アカウントを WeChat ID にバインドして再度招待することはできません。

#呼び出し手順

1##http リクエスト メソッド: POST

2 3 4 5 6 7

https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN POST データの例は次のとおりです。 { "kf_account " : "test1@test", "invite_wx" : "test_kfwx" }

パラメータの説明

参数	说明
kf_account	完整客服帐号，格式为：帐号前缀@公众号微信号
invite_wx	接收绑定邀请的客服微信号

#返品の説明

1

メインリターンコード

2 3 4 5

戻りデータの例 (正しい場合は JSON が結果を返します): { 「エラーコード」 : 0, 「エラーメッセージ」 : 「わかりました」 ##}

#戻りコード説明0成功65400API は利用できません。つまり、アクティブ化されておらず、カスタマー サービスの新しいバージョンにアップグレードされていません#6540165407

無効なカスタマー サービス アカウント
招待者はすでにこの公式アカウントのカスタマー サービスです
65408	この公開アカウントはこの WeChat ID に招待を送信しました
65409	無効な WeChat ID
65410	公式カスタマー サービス アカウントにバインドされた招待者の数が上限に達しました (現在、各 WeChat アカウントは最大 5 つの公式カスタマー サービス アカウントにバインドできます)
65411	このアカウントには確認待ちの招待がすでにあり、再度招待することはできません
65412	これアカウントは WeChat ID にバインドされているため、招待できません

#カスタマー サービス情報の設定

電話の指示

パラメータの説明

1 2 3 4 5 6 7

http リクエスト メソッド: POST https://api.weixin.qq.com/customservice/kfaccount/update? access_token =ACCESS_TOKEN POST データの例は次のとおりです。 { "kf_account" : "test1@test", "ニックネーム" : "カスタマー サービス 1" }

参数	说明
kf_account	完整客服帐号，格式为：帐号前缀@公众号微信号
nickname	客服昵称，最长16个字

返品の説明

1 2 3 4 5

戻りデータの例 (正しい場合は JSON が結果を返します): { 「エラーコード」 : 0, 「エラーメッセージ」 : 「わかりました」 }

メインリターンコード

#戻りコード説明0成功65400API は利用できません。つまり、新しいバージョンのカスタマー サービス機能が有効化/アップグレードされていません65401無効なカスタマー サービス アカウント65403カスタマー サービスのニックネームは不正です##

カスタマー サービス アバターのアップロード

##通話手順

#1httpリクエスト方法: POST/FORM

パラメータの説明

2 3 4 5

https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account= KFACCOUNT 呼び出し例 (curl コマンドを使用して、FORM フォームを使用してマルチメディア ファイルをアップロード): curl - F media =@test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT"

##パラメータ説明##kf_accountmedia 以内です。

戻り値の説明 12345 戻り値データの例 (正しい場合の JSON 戻り結果): { "errcode" : 0, "errmsg" : "ok" } 主な戻りコード 戻りコードの説明 0 成功 65400 API はありませんavailable 、つまり、カスタマー サービス機能がアクティブ化されていない、新しいバージョンにアップグレードされていない 65401 無効なカスタマー サービス アカウント 65403 不正なカスタマー サービスのニックネーム 40005 サポートされていないメディア タイプ 40009 不正なメディア ファイルの長さ カスタマー サービス アカウントの削除手順の呼び出し 12 http リクエスト メソッド: GET https://api.weixin.qq. com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT パラメータの説明 パラメータの説明 kf_account 完全な顧客サービス アカウント、形式は次のとおりです: アカウント プレフィックス @ 公式アカウント WeChat ID 戻り値の説明

完全なカスタマー サービス アカウント、形式は次のとおりです: アカウント プレフィックス@公式アカウント WeChat ID
フォーム データ メディア ファイル ID (ファイル名、ファイル長、コンテンツを含む) -ファイルの種類などの情報が含まれており、ファイルサイズは 5M

1 2 3 4 5

戻りデータの例 (正しい JSON 結果が返された場合): { #"エラーコード" : 0, "エラーコード" : "ok 「 }

メインリターンコード

返回码	说明
0	成功
65400	API不可用，即没有开通/升级到新版客服功能
65401	无效客服帐号

#顧客サービス管理インターフェイスの戻りコードの説明

#戻りコード説明0成功65400API は利用できません。つまり、新しいバージョンのカスタマー サービス機能が有効化/アップグレードされていません65401無効なカスタマー サービス アカウント65403カスタマー サービスのニックネームは不正です

65404	カスタマー サービス アカウントは違法です
65405	アカウント数が上限に達したため、これ以上は使用できません追加が可能です
65406	既存のカスタマー サービス アカウント
65407	招待者はすでにパブリック アカウントのカスタマー サービス アカウントです
65408	このパブリック アカウントにはすでに WeChat への招待があります
65409	無効な WeChat ID
65410	公開アカウントのカスタマー サービス番号がバインドされています招待者へ 上限に達しました (現在、各 WeChat アカウントは 5 つの公式カスタマー サービス アカウントにバインドできます)
65411	このアカウントにはすでに招待を待っています
65412	このアカウントは WeChat ID にバインドされているため、招待できません
40005	サポートされているメディア タイプがありません
40009	メディア ファイルの長さが不正です