WeChatセッション制御


#セッション制御

201610171124143832.png##セッションの作成

#このインターフェースは顧客サービスとユーザーの間にセッションを作成します。顧客サービスとユーザーのセッションがすでに存在する場合は、直接 0 が返されます。指定されたカスタマー サービス アカウントは WeChat ID にバインドされており、オンラインである必要があります。

呼び出し手順

1##http リクエスト メソッド: POST
2
3
4
5
#6
7
https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN
POST データの例は次のとおりです。
{
"kf_account" : " test1 @test",
"openid" : "OPENID"
}
#パラメータの説明
##パラメータ


説明

#kf_accountopenid戻りの説明##1
完全なカスタマー サービス アカウント、形式は次のとおりです: アカウント プレフィックス@パブリック アカウント WeChat ID
fans openid

2

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


#セッションを閉じる

電話の指示

1
2
3
4
5
6
7
http リクエストメソッド: POST
https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
POST データの例は次のとおりです。
{
"kf_account" : "test1@test",
"openid" : "OPENID"
}
パラメータの説明


パラメータ説明kf_account完全なカスタマー サービス アカウント。形式は次のとおりです: アカウント プレフィックス@パブリック アカウント WeChat IDopenidファンの openid
返品手順


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


リターンコード

説明#65413ユーザーに対応するセッション情報がありません#6541440003

顧客セッション ステータスの取得

このインターフェイスは顧客のセッションを取得します。存在しない場合、kf_account は空です。

呼び出し手順

##0成功
65400API は使用できません。つまり、新しいバージョンのカスタマー サービスです。機能はアクティブ化/アップグレードされていません
65401無効なカスタマー サービス アカウント
65402アカウントは WeChat ID にバインドされていないため、使用できません
顧客は別の顧客サービス受付によってサービスを受けています
違法な openid
#パラメータの説明
1
2
http リクエスト メソッド: GET
##https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID


パラメータ説明openidファンの openid

戻り手順

12345 戻りデータの例 (正しい場合は JSON 戻り結果): { "createtime" : 123456789, "kf_account" : "test1@test" } パラメーターの説明 パラメーターの説明 kf_account 受信中の顧客サービス、 empty は、誰も createtime セッション アクセス時間を受信して​​いないことを意味します メイン リターン コード リターン コードの説明 0 成功 65400 API は利用できません、つまり、新しいバージョンのカスタマー サービス機能にアクティブ化/アップグレードされていません 40003 不正な openid カスタマー サービス セッション リストの取得呼び出しの説明 12 http リクエスト メソッド: GEThttps://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT パラメーターの説明 パラメーターの説明 kf_account 完全なカスタマー サービス アカウント、形式は次のとおりです: アカウント プレフィックス @ 公式アカウント WeChat ID は
1
2
3
4
5
を返します。
6
7
8
9
10
11
12
13
戻りデータの例 (正しい場合は JSON が返す結果):
{
「セッションリスト」 : [
#:
"OPENID"
#},
# "作成時刻" ##: 123456789,
"Openid" : "OPENID"
}
]
##未接続セッションのリストを取得
#通話の説明
1
2
http リクエスト メソッド: GEThttps://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN

返品の説明

未接続セッション数
1
2
3
4
5
6
7
8
9
10
11
12
13
14
## 戻りデータの例 (正しい場合は JSON で結果が返されます):
{
"カウント" : 150,
「待機ケースリスト」 : [
##{
"latest_time" : 123456789,
##」 OPENID"##},
## "latest_time" ##: 123456789,
## "Openid" :
"OPENID" }
#]
}
#パラメータの説明
パラメータ
説明
count


waitcaselist

セッションリストに接続されていないため、最大100個のデータが順番に返されます。訪問数openidファンのオープンIDlatest_timeファンの最後のメッセージの時刻

戻りコードの説明

#65400API は利用できません。つまり、アクティベートされていない、または新しいバージョンのカスタマー サービス機能にアップグレードされていません65401無効なカスタマー サービス アカウント65402カスタマー サービス アカウントは WeChat ID にバインドされていないため、WeChat ID に配置できませんuse65413ユーザーに対応するセッション情報がありません65414ファンは他のカスタマー サービスが受信中です#65415##40003不正な openid
戻りコード説明
0成功
指定されたカスタマー サービスはオンラインではありません
#