著者:php.cn 更新時間:2022-04-11 14:39:39
WeChatセッション制御
#セッション制御
##セッションの作成
#このインターフェースは顧客サービスとユーザーの間にセッションを作成します。顧客サービスとユーザーのセッションがすでに存在する場合は、直接 0 が返されます。指定されたカスタマー サービス アカウントは WeChat ID にバインドされており、オンラインである必要があります。
呼び出し手順
1##http リクエスト メソッド: POST
2345 #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,
「エラーメッセージ」 : 「わかりました」 }
#セッションを閉じる 電話の指示 1234567 | 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 返品手順
メインリターンコード 1234 #5 | 戻りデータの例 (正しい場合は JSON が返す結果):
#{
##「エラーコード」 : 0,
「エラーメッセージ」 : 「わかりました」
#}
|
リターンコード
説明#65413ユーザーに対応するセッション情報がありません#6541440003 顧客セッション ステータスの取得
このインターフェイスは顧客のセッションを取得します。存在しない場合、kf_account は空です。 呼び出し手順 ##0 | 成功 | 65400 | API は使用できません。つまり、新しいバージョンのカスタマー サービスです。機能はアクティブ化/アップグレードされていません | 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" }
]
##未接続セッションのリストを取得
#通話の説明
12
http リクエスト メソッド: GET
https://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 | 成功 | | | | | | | | | | | 指定されたカスタマー サービスはオンラインではありません | | | |
# |