• UIKit
  • SDK
  • サーバー API
Chat/
SDK/
React Native/
メッセージ/
SDK
  • Overview
    • Product Features
    • Pricing
      • Billing Overview
      • Chat Monthly Package
      • Billing of Chat Out-of-Package Usage
  • Quick Start
  • Init and Login
    • SDK の統合
    • Step 2: Initialize Chat SDK
    • Step 3: Login and Logout
  • メッセージ
    • メッセージの概要
    • メッセージ送信
    • メッセージの受信
    • 過去のメッセージ
    • メッセージ転送
    • メッセージの変更
    • メッセージ挿入
    • メッセージ削除
    • メッセージをクリア
    • メッセージの取り消し
    • オンラインメッセージ
    • 既読レシート
    • クエリーメッセージ
    • グループ @ メッセージ
    • ターゲットグループメッセージ
    • 通知のサイレントモード
    • メッセージ拡張
    • Translation
    • Voice-to-Text
  • Conversation
    • Overview
    • Conversation List
    • Get Conversations
    • Unread Count
    • Pin Conversations
    • Delete Conversations
    • Draft
    • Mark
    • Conversation Group
  • グループ
    • Overview
    • グループ管理
    • グループプロファイル
    • グループメンバーの管理
    • グループメンバープロファイル
    • グループプロパティのカスタマイズ
    • コミュニティ管理
  • Community and Topic
    • Manage Community
  • ユーザー
    • ユーザープロファイル
    • User Status
    • 友達管理
    • 友達リスト
    • ブラックリスト
    • Follow
  • シグナリング管理
  • Client APIs
  • Changelog
  • UserSig の生成
  • コンソールガイド
    • New Console Introduction
    • アプリケーションの作成とアップグレード
    • 基本設定
    • 機能設定
    • アカウント管理
    • グループ管理
    • コールバック設定
    • Usage Statistics
    • Real-Time Monitor
    • Auxiliary Development Tools
  • 製品紹介
    • メッセージ管理
      • シングルチャットメッセージ
      • メッセージの保存
      • オフラインプッシュ
      • グループメッセージ
      • メッセージフォーマット
    • アカウントシステム
      • ログイン認証
      • オンライン状態管理
    • グループ関連
      • グループシステム
      • グループ管理
    • ユーザープロファイルとリレーションシップチェーン
      • 資料管理
      • リレーションシップチェーン管理
  • Push Service
    • Overview
    • Activate the Service
    • Quick Start
    • Manufacturer Channel
      • Manufacturer Configuration
        • Android
        • iOS
        • Flutter
        • React-Native
      • Quick Integration
        • Android
        • iOS
        • Flutter
        • React-Native
    • Statistics
    • Troubleshooting Tool
    • Client APIs
      • Android
      • iOS
      • Flutter
      • React Native
    • REST API
      • Pushing to All/Tagged Users
      • UserID-Targeted Push
      • Obtaining Application Attribute Names
      • Setting Application Attribute Names
      • Obtaining User Attributes
      • Setting User Attributes
      • Deleting User Attributes
      • Obtaining User Tags
      • Adding User Tags
      • Deleting User Tags
      • Deleting All User Tags
      • Recalling Push
    • Push Callback
      • All Users / Tags / UserID Push Callback
      • Other Push Callbacks
    • Advanced Features
      • Custom Definition Badge
      • Custom Definition Ringtone
      • Customized Icon
      • Custom Definition Click Redirect
      • Push Message Categorization
    • Release Notes
      • Android
      • iOS
      • Flutter
      • React Native
    • FAQS
  • エラーコード
このページは現在英語版のみで提供されており、日本語版も近日中に提供される予定です。ご利用いただきありがとうございます。

クエリーメッセージ

Feature Overview

You can call findMessages to query a local message by messageID.
1. Only local messages can be queried, for example, received messages or historical messages pulled by API.
2. Audio-video group (AVChatRoom) messages cannot be queried, as they are not saved locally.
You can call searchCloudMessages to search for cloud messages(recommended).

UI Display








Find A Local Message

Note:
1. This interface queries the messages stored locally through getMessageList.
API
chat.findMessage(messageID);
Parameters
Name
Type
Description
messageID
String
Message ID
Return value
Message or null.
Examples
let message = chat.findMessage('144115217363870632-1647417469-77069006');
if (message) {
// Read the attributes of `message`, such as `readReceiptInfo`
}

Search cloud messages

Note:
1. This feature is a value-added service, and you need to purchase the cloud search plugin.
2. This interface has a local rate limit of 2 times per second.
3. When searching for messages in [All Conversations], if the number of matching messages messageCount > 1, the interface returns an empty messageList []. You can display [${messageCount} ]related records on the UI. If you want to highlight the matching messages, please refer to [Specified Search] to highlight the returned messageList.
4. When searching for messages in [All Conversations], if the number of matching messages in a conversation = 1, then messageList is the matching message.
5. Community, topic, and live group chats do not support searching cloud messages.
API
chat.searchCloudMessages(options);
Parameters
The options parameter is of the Object type. It contains the following attribute values:
Name
Type
Description
keywordList
Array.<String>
Keyword list, supporting up to 5 keywords. When neither the message sender nor the message type is specified, the keyword list must not be empty; otherwise, the keyword list can be empty.
keywordListMatchType
String
Keyword list matching type
or: "or" relationship search (default)
and: "and" relationship search
senderUserIDList
Array.<String>
Specify messages sent by userID, supporting up to 5 IDs.
messageTypeList
Array.<String>
Specify the collection of message types to search for, with the default being to search all types.

When not provided, it indicates searching for all supported types of messages (TencentCloudChat.TYPES.MSG_FACE, TencentCloudChat.TYPES.MSG_GRP_TIP, and TencentCloudChat.TYPES.MSG_GRP_SYS_NOTICE are not supported).
For specific values when provided, refer to TencentCloudChat.TYPES.
conversationID
String
Search "All Conversations" or "Specified Conversations". If not specified, it means all conversations. Default: All Conversations. Conversation ID composition:
C2C${userID} (one-to-one chat)
GROUP${groupID} (group chat)
timePosition
Number
The starting time point of the search. The default is 0, which means searching from now. Unit: seconds
timePeriod
Number
The past time range from the starting time point, in seconds. The default is 0, which means no time limit. Passing 24 * 60 * 60 represents the past day.
cursor
String
The starting position of each cloud search. Do not pass in the cursor for the first search; when continuing the search, fill in the value of the cursor returned by the last call to the searchCloudMessages interface.
Note: The cursor is valid for 2 minutes during a full search.
Return value
Promise
Examples
let promise = chat.searchCloudMessages({
keywordList: ['hello', 'where are you'],
});
let promise = chat.searchCloudMessages({
keywordList: ['hello', 'where are you'],
keywordListMatchType: 'and',
});
let promise = chat.searchCloudMessages({
keywordList: ['hello', 'where are you'],
senderUserIDList: ['user1', 'user2'],
});
let promise = chat.searchCloudMessages({
keywordList: ['hello', 'where are you'],
messageTypeList: [TencentCloudChat.TYPES.MSG_TEXT, TencentCloudChat.TYPES.MSG_CUSTOM],
});
let promise = chat.searchCloudMessages({
keywordList: ['hello', 'where are you'],
timePosition: Number((new Date().getTime()/1000).toFixed(0)),
timePeriod: 24 * 60 * 60,
});
promise.then(function(imResponse) {
const { totalCount, cursor, searchResultList } = imResponse.data;
// The total number of all conversations where messages meet the search criteria.
console.log(totalCount);
// The starting position for the next cloud search. If there is no next position, it indicates that the search result retrieval is complete.
console.log(cursor);
// Messages that meet the search criteria are grouped by conversation ID and returned in pages.
console.log(searchResultList);
for (let i = 0; i < searchResultList.length; i++) {
const searchResultItem = searchResultList[i];
const { conversationID, messageCount, messageList } = searchResultItem;
console.log(conversationID);
console.log(messageCount);
console.log(messageList);
}
}).catch(function(imError) {
console.error(imError); // Search message failed
});

コミュニティに質問しよう!
技術的な議論を始め、すぐに専門家のサポートを受けよう!