tencent cloud

フィードバック

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

最終更新日: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
    必須
    エラー情報。固定値:空の文字列

    参照情報

    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)