著者:php.cn 更新時間:2022-04-11 14:39:39
WeChatセッション制御
#セッション制御
##セッションの作成
#このインターフェースは顧客サービスとユーザーの間にセッションを作成します。顧客サービスとユーザーのセッションがすでに存在する場合は、直接 0 が返されます。指定されたカスタマー サービス アカウントは WeChat ID にバインドされており、オンラインである必要があります。
呼び出し手順
12345 #6 7 | ##http リクエスト メソッド: POST https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN POST データの例は次のとおりです。
{
"kf_account" : " test1 @test",
"openid" : "OPENID"
}
#パラメータの説明
|
##パラメータ
説明
#kf_account完全なカスタマー サービス アカウント、形式は次のとおりです: アカウント プレフィックス@パブリック アカウント WeChat ID | |
openidfans openid | |
戻りの説明 | |
##1
2
3
45 戻りデータの例 (正しい場合は 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 ID | openid | ファンの openid |
返品手順
1234 #5 | 戻りデータの例 (正しい場合は JSON が返す結果):
#{
##「エラーコード」 : 0,
「エラーメッセージ」 : 「わかりました」
#}
| メインリターンコード
リターンコード
説明 ##0 | 成功 | 65400 | API は使用できません。つまり、新しいバージョンのカスタマー サービスです。機能はアクティブ化/アップグレードされていません | 65401 | 無効なカスタマー サービス アカウント | 65402 | アカウントは WeChat ID にバインドされていないため、使用できません | #65413 | ユーザーに対応するセッション情報がありません | #65414顧客は別の顧客サービス受付によってサービスを受けています | | 40003違法な openid | | 顧客セッション ステータスの取得
このインターフェイスは顧客のセッションを取得します。存在しない場合、kf_account は空です。 呼び出し手順 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 | ファンのオープンID | latest_time | ファンの最後のメッセージの時刻 | 戻りコードの説明 戻りコード | 説明 | 0 | 成功 | #65400 | API は利用できません。つまり、アクティベートされていない、または新しいバージョンのカスタマー サービス機能にアップグレードされていません | 65401 | 無効なカスタマー サービス アカウント | 65402 | カスタマー サービス アカウントは WeChat ID にバインドされていないため、WeChat ID に配置できませんuse | 65413 | ユーザーに対応するセッション情報がありません | 65414 | ファンは他のカスタマー サービスが受信中です | #65415指定されたカスタマー サービスはオンラインではありません | | ##40003 不正な openid | | # |