tencent cloud

Chat

製品の説明
製品の概要
Basic Concepts
ユースケース
機能概要
アカウントシステム
ユーザープロフィールとリレーションシップチェーン
メッセージ管理
グループシステム
Official Account
Audio/Video Call
使用制限
購入ガイド
課金概要
価格説明
Purchase Instructions
Renewal Guide
支払い延滞説明
Refund Policy
ダウンロードセンター
SDK & Demo ソースコード
更新ログ
シナリオプラン
Live Streaming Setup Guide
AI Chatbot
極めて大規模なエンターテインメントコラボレーションコミュニティ
Discord実装ガイド
ゲーム内IM統合ガイド
WhatsApp Channel-style Official Account Integration Solution
Send Red Packet
Firewall Restrictions
クライアントAPIs
SDK API(Web)
Android
iOS & macOS
Swift
Flutter
SDK API(Electron)
SDK APIs (Unity)
SDK API(React Native)
C APIs
C++
サービス側 APIs
UserSigの生成
RESTful APIs
Webhooks
コンソールガイド
New Console Introduction
アプリケーションの作成とアップグレード
基本設定
機能設定
アカウント管理
グループ管理
Official Channel Management
コールバック設定
監視ダッシュボード
Viewing Guide for Resource Packages
Real-Time Monitor
補助ツールの開発
アクセス管理
Advanced Features
よくあるご質問
uni-app FAQs
 購入に関する質問
SDKに関する質問
アカウント認証に関する質問
ユーザープロファイルとリレーションシップチェーンに関する質問
メッセージに関する質問
グループに関する質問
ライブ配信グループに関する質問
ニックネームプロフィール画像に関連した問題
一般的なリファレンス
Service Level Agreement
セキュリティコンプライアンス認証
IM ポリシー
プライバシーポリシー
データプライバシーとセキュリティ契約
エラーコード
お問い合わせ
ドキュメントChatサービス側 APIsWebhooksGroup Webhooksグループメッセージを送信した場合の異常系コールバック

グループメッセージを送信した場合の異常系コールバック

PDF
フォーカスモード
フォントサイズ
最終更新日: 2024-04-11 17:24:09

機能説明

アプリのバックグラウンドでは、このコールバックを介して、以下に示すユーザーのグループメッセージの異常状況をモニタリングできます。
送信したメッセージのパラメータが間違っている(グループIDが存在しないなど)
メッセージの送信頻度が上限を超えている
メッセージの送信時にセキュリティ攻撃を受けた
送信者がミュートされているなど

注意事項

コールバックを有効にするには、コールバックURLを設定し、このコールバックプロトコルに対応するスイッチをオンにする必要があります。設定方法の詳細については、サードパーティコールバックの設定ドキュメントをご参照ください。
コールバックの方向は、IMバックグラウンドからアプリバックグラウンドへHTTP POSTリクエストを送信するようになっています。
アプリのバックグラウンドがコールバックリクエストを受信した後、リクエストURLのパラメータSDKAppIDが自分のSDKAppIDであるかどうかを確認する必要があります。
その他のセキュリティ関連事項については、サードパーティコールバックの概要:セキュリティに関する考慮事項ドキュメントをご参照ください。

このコールバックをトリガーする可能性のあるシナリオ

アプリユーザーがクライアントでグループメッセージを送信する。
アプリ管理者がREST APIでグループメッセージを送信する。

コールバックの発生時間

IMバックグラウンドがグループメッセージをグループメンバーに送信できなかった後。

インターフェースの説明

リクエストURLの例

以下の例のアプリ設定のコールバックURLはhttps://www.example.comです。 例:
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform

リクエストパラメータの説明

パラメータ
説明
https
リクエストプロトコルはHTTPS、リクエストメソッドはPOSTです
www.example.com
コールバックURL
SdkAppid
アプリケーションの作成時にIMコンソールで割り当てられたSDKAppID
CallbackCommand
Group.CallbackSendMsgExceptionという固定値が適用されます
contenttype
JSONという固定値が適用されます
OptPlatform
クライアントプラットフォーム。値の詳細については、サードパーティコールバックの概要:コールバックプロトコルにあるOptPlatformのパラメータの意味をご参照ください

リクエストパケットの例

{
"CallbackCommand": "Group.CallbackSendMsgException", // コールバックコマンド
"GroupId": "@TGS#2J4SZEAEL", // グループID
"Type": "Public", // グループタイプ
"From_Account": "jared", // 送信者
"Operator_Account":"admin", // リクエストの送信者
"Random": 123456, // 乱数
"OnlineOnlyFlag": 1, //オンラインメッセージは1、そうでない場合は0となります。ライブストリーミンググループの場合はこの属性を無視し、デフォルト値の0とします。
"MsgBody": [ // メッセージボディです。TIMMessageのメッセージオブジェクトをご参照ください
{
"MsgType": "TIMTextElem", // テキスト
"MsgContent": {
"Text": "red packet"
}
}
],
"CloudCustomData": "your cloud custom data",
"ErrorCode": 10023, // メッセージ異常のエラーコード
"ErrorInfo": "msg count exceeds limit,please retry later", // メッセージ異常の詳細情報
"EventTime":"1670574414123"//ミリ秒レベル、イベントのトリガータイムスタンプ
}

リクエストパケットフィールドの説明

フィールド
タイプ
説明
CallbackCommand
String
コールバックコマンド
GroupId
String
グループメッセージが生成されるグループID
Type
String
グループメッセージが生成されるグループタイプの概要。例:Public
From_Account
String
メッセージ送信者のUserID
Operator_Account
String
リクエスト送信者のUserID。管理者のリクエストかどうかを識別するために使用できます
Random
Integer
メッセージ送信リクエストにある32桁の乱数
OnlineOnlyFlag
Integer
オンラインメッセージ。値は1または0です。ライブストリーミンググループの場合はこの属性を無視し、デフォルト値の0に設定されています
MsgBody
Array
メッセージ内容。詳細については、メッセージ形式の説明をご参照ください
CloudCustomData
String
メッセージカスタムデータ(クラウドに保存され、対向側に送信され、プログラムをアンインストールして再インストールした後にプルできます)
ErrorCode
Interger
メッセージ異常のエラーコード。その他のエラーコードについては、グループのエラーコードをご参照ください
ErrorInfo
String
メッセージ異常の詳細情報
EventTime
Integer
イベントがトリガーされるミリ秒レベルのタイムスタンプ

レスポンスパケットの例

{
"ActionStatus": "OK",
"ErrorInfo": "",
"ErrorCode": 0
}

レスポンスパケットフィールドの説明

フィールド
タイプ
属性
説明
ActionStatus
String
必須
リクエスト処理の結果。入力する固定値:OK
ErrorCode
Integer
必須
エラーコード。入力する固定値:0
ErrorInfo
String
必須
エラー情報。固定値:空の文字列

参照情報

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック