tencent cloud

機能説明

Appバックグラウンドは、このコールバックを通じて、ユーザーのシングルチャットメッセージをリアルタイムで操作できます。次を含めます：

• シングルチャットメッセージの送信をリアルタイムで記録します（ログの記録、またはその他のシステムへの同期など）。
• ユーザーのルール違反の発言リクエストをブロックします。テキスト、画像、カスタムメッセージなどのルール違反メッセージをカスタムブロックできます。

  注意：

  メッセージのプレコールバックはデフォルトで2秒のタイムアウトになり、調整することはお勧めしません。プレコールバックを使用して内容審査を処理すると、プレコールバック全体がタイムアウトする場合があります。

注意事項

• コールバックを有効にするには、コールバックURLを設定し、このコールバックに対応するスイッチをオンにする必要があります。設定方法の詳細については、サードパーティのコールバック設定ドキュメントをご参照ください。
• コールバックの方向は、IMバックグラウンドからAppバックグラウンドへのHTTP POSTリクエストを開始することです。
• Appバックグラウンドは、コールバックリクエストを受け取った後、リクエストURLのパラメータSDKAppIDが独自のSDKAppIDであるかどうかを確認する必要があります。
• シングルチャットメッセージ送信前後の2つのコールバックを同時に有効にし、シングルチャットメッセージ送信前のコールバックで発言禁止が返された場合、シングルチャットメッセージ送信後にコールバックはトリガーされません。
• シングルチャットメッセージ送信前後の2つのコールバックを同時に有効にし、シングルチャットメッセージ送信前のコールバックでメッセージボディが変更された場合、シングルチャットメッセージ送信後にコールバックは変更されたメッセージでコールバックします。
• その他のセキュリティ関連事項については、サードパーティコールバック概要：セキュリティに関する考慮事項ドキュメントをご参照ください。

コールバックをトリガーするシナリオ

• Appユーザーは、クライアントを通じてシングルチャットメッセージを送信します。
• App管理者は、REST API（sendmsgインターフェース）を通じてシングルチャットメッセージを送信します。

コールバックの発生時間

IMバックグラウンドが、ユーザーによって送信されたシングルチャットメッセージを受信した後、そのメッセージをターゲットユーザーに送信する前。

インターフェースの説明

リクエストURLの事例

次の事例のApp設定のコールバックURLはhttps://www.example.comです。
事例：

https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform

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

リクエストパッケージの事例

{
  "CallbackCommand": "C2C.CallbackBeforeSendMsg", // コールバックコマンド
  "From_Account": "jared", // 送信者
  "To_Account": "Jonh", // 受信者
  "MsgSeq": 48374, // メッセージのシーケンス番号
  "MsgRandom": 2837546, // メッセージ乱数
  "MsgTime": 1557481126, // メッセージ送信のタイムスタンプ（秒単位） 
  "MsgKey": "48374_2837546_1557481126", //REST APIがシングルチャットメッセージを撤回するためのメッセージの一意の識別子
  "OnlineOnlyFlag":1, //オンラインメッセージは1、そうでない場合は0となります。
  "MsgBody": [ // メッセージボディです。TIMMessageのメッセージオブジェクトをご参照ください
      {
          "MsgType": "TIMTextElem", // テキスト
          "MsgContent": {
              "Text": "red packet"
          }
      }
  ],
  "CloudCustomData": "your cloud custom data"
}

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

レスポンスパッケージの事例（発言の許可）

送信するメッセージの内容を変更せずにユーザーの発言が許可されます。

{
  "ActionStatus": "OK",
  "ErrorInfo": "",
  "ErrorCode": 0 // 0は発言が許可されることを意味します
}

レスポンスパッケージの事例（発言の禁止）

ユーザーの発言は許可されていません。このメッセージは送信されず、ユーザーにエラーコード20006が返されます。

{
  "ActionStatus": "OK",
  "ErrorInfo": "",
  "ErrorCode": 1 // 1は発言が拒否されることを意味します
}

レスポンスパッケージの事例（サイレントに破棄）

ユーザーの発言は許可されていません。このメッセージは送信されませんが、呼び出し元に成功が返され、メッセージが送信されたと呼び出し元に思わせます。

{
  "ActionStatus": "OK",
  "ErrorInfo": "",
  "ErrorCode": 2 // 2はサイレントに破棄することを意味します
}

レスポンスパッケージの事例（メッセージ内容の変更）

次のレスポンス事例は、ユーザーが送信したシングルチャットメッセージを変更（カスタムメッセージまたはメッセージカスタムデータを追加)し、IMバックグラウンドが変更されたメッセージを送信することです。Appバックグラウンドは、この特性に基づいて、ユーザーが送信したメッセージに、たとえばユーザーレベル、タイトルなど、特別なコンテンツを追加できます。
事例：

{
  "ActionStatus": "OK",
  "ErrorInfo": "",
  "ErrorCode": 0, //  0である必要があります。この方法でのみ、変更後のメッセージを正常に送信できます
  "MsgBody": [ // AppApp変更後のメッセージ、存在しない場合はユーザーが送信したメッセージがデフォルトで使用されます
      {
          "MsgType": "TIMTextElem", // テキスト
          "MsgContent": {
              "Text": "red packet"
          }
      },
      {
          "MsgType": "TIMCustomElem", // カスタムメッセージ
          "MsgContent": {
              "Desc": " CustomElement.MemberLevel ", // 説明
              "Data": " LV1" // データ
          }
      }
  ],
  "CloudCustomData": "your new cloud custom data" // メッセージカスタムデータ
}

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

参考

• サードパーティのコールバック概要
• シングルチャットメッセージ送信後のコールバック
• REST API：シングルチャットメッセージの個別送信
• REST API：シングルチャットメッセージの一括送信