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
Electron
Unity
React Native
C APIs
C++
서버 APIs
Secure authentication with UserSig
RESTful APIs
Webhooks
콘솔 가이드
New Console Introduction
애플리케이션 생성 및 업그레이드
기본 설정
기능 설정
계정 관리
그룹 관리
Official Channel Management
콜백 설정
모니터링 대시보드
Viewing Guide for Resource Packages
Real-Time Monitor
개발 보조 툴
액세스 관리
Advanced Features
FAQ
uni-app FAQs
구매
SDK 관련 질문
계정 인증
사용자 정보 및 관계망
메시지
그룹
라이브 방송 그룹
닉네임 및 프로필 사진
협약 및 인증
Service Level Agreement
컴플라이언스 인증
IM 정책
개인 정보 보호 정책
데이터 개인 정보 보호 및 보안 계약
에러 코드
문의하기

Importing Group Messages

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-03-16 17:34:19

Feature Overview

This API is used to import group messages without triggering callbacks or sending notifications.
When you are migrating your app from another instant messaging system to Tencent Cloud Chat, you can use this API to import group message data.

API Calling Description

Applicable group types

Group Type
Support for This RESTful API
Private
Yes. Same as work groups (Work) in the new version.
Public
Yes
ChatRoom
Yes. Same as meeting groups (Meeting) in the new version.
AVChatRoom
No
Community
Yes
Above are the built-in group types of the Chat service. For more information, see Group System.
Note
Audio-video groups (AVChatRoom) do not support importing group messages. If you attempt to import group messages for an audio-video group, error 10007 will be returned. Therefore, members of an audio-video group cannot view the messages sent before they join the group.

Sample request URL

https://xxxxxx/v4/group_open_http_svc/import_group_msg?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

Request parameters

The following table describes the modified parameters when this API is called. For other parameters, see RESTful API Overview.
Parameter
Description
xxxxxx
Domain name corresponding to the country/region where your SDKAppID is located.
China: console.tim.qq.com
Singapore: adminapisgp.im.qcloud.com
Seoul: adminapikr.im.qcloud.com
Tokyo:adminapijpn.im.qcloud.com
Frankfurt: adminapiger.im.qcloud.com
Silicon Valley: adminapiusa.im.qcloud.com
Jakarta: adminapiidn.im.qcloud.com
v4/group_open_http_svc/import_group_msg
Request API
sdkappid
SDKAppID assigned by the Chat console when an app is created
identifier
App admin account. For more information, see the App Admin section in Login Authentication.
usersig
Signature generated by the app admin account. For details, see Generating UserSig.
random
A random 32-bit unsigned integer ranging from 0 to 4294967295.
contenttype
Request format. The value is fixed to json.

Maximum call frequency

200 calls per second

Sample request

A single request can import up to seven group messages. After messages are imported through this API, the unread message count for all members will become 0. To retain the unread message count, you need to import group members or set the unread message count for members after importing all messages. The messages must be imported in ascending order by timestamp, and the timestamps of imported messages must be earlier than the current time, and later than the group creation time and the creation time of the latest message in the group. Otherwise, the import will fail.
{
"GroupId": "@TGS#2C5SZEAEF",
"RecentContactFlag":1,// Means to trigger conversation update (This field is not supported by AVChatRoom groups.)
"MsgList": [
{
"From_Account": "leckie", // Message sender
"SendTime":1620808101,
"Random": 8912345, // Random number of the message (optional)
"MsgBody": [ // Message body, which consists of an element array. For details, see the `TIMMessage` message object.
{
"MsgType": "TIMTextElem", // Text
"MsgContent": {
"Text": "red packet"
}
},
{
"MsgType": "TIMFaceElem", // Emoji
"MsgContent": {
"Index": 6,
"Data": "abc\\u0000\\u0001"
}
}
],
"CloudCustomData": "your cloud custom data"
},
{
"From_Account": "peter", // Message sender
"SendTime":1620892821,
"MsgBody": [ // Message body, which consists of an element array. For details, see the `TIMMessage` message object.
{
"MsgType": "TIMTextElem", // Text
"MsgContent": {
"Text": "red packet"
}
}
],
"CloudCustomData": "your cloud custom data"
}
]
}
Specifying Message Recipients
If the To_Account field is added to the message body to specify the message recipients, the message will only be sent to these designated recipients, and ​​the message will not be counted as unread​​. (Supported group types: ​​Private​​, ​​Public​​, and ​​ChatRoom​​).
Note
Only the Flagship Edition and Enterprise Edition support this feature.
{
"GroupId": "@TGS#2C5SZEAEF",
"MsgList": [
{
"From_Account": "peter", // Specifies the message sender
"SendTime":1620892821,
"MsgBody": [ // Message body, composed of an array of elements. Refer to the TIMMessage object for details
{
"MsgType": "TIMTextElem", // Text
"MsgContent": {
"Text": "red packet"
}
}
],
"To_Account":["brennanli2", "brennanli3"] //Specifies the message recipients (up to 50 members). If this field is used, the message will not count as unread.
}
]
}
Message Import Control
If SendMsgControl is added to the request, the behavior of this message import can be controlled. If NoMsgCheck is set, it indicates that after enabling cloud-based auditing, all messages imported in this operation will not be submitted for review.
{
"GroupId": "@TGS#2C5SZEAEF",
"SendMsgControl": ["NoMsgCheck"],
"MsgList": [
{
"From_Account": "peter", // Specifies the message sender
"SendTime": 1620892821,
"MsgBody": [ // Message body, composed of an array of elements. Refer to the TIMMessage object for details.
{
"MsgType": "TIMTextElem", // Text
"MsgContent": {
"Text": "red packet"
}
}
],
"To_Account": ["brennanli2", "brennanli3"] // Specifies the message recipients (up to 50 members). If this field is used, the message will not count as unread.
}
]
}

Request fields

Field
Type
Required
Description
GroupId
String
Yes
ID of the group for which to import messages
RecentContactFlag
Integer
No
Whether to trigger conversation update. The value 1 means to trigger conversation update. Conversation update is not triggered by default. This field is not supported by audio-video groups (AVChatRoom) and community groups.
MsgList
Object
Yes
List of the messages to import
From_Account
String
Yes
Message sender
SendTime
Integer
Yes
Message sending time
Random
Integer
No
A 32-bit unsigned integer. If the random numbers of two messages within five minutes are the same, the later message will be discarded as a repeated message.
MsgBody
Array
Yes
TIM message. For more information, see the definition of TIMMsgElement in Message Formats.
MsgType
String
Yes
TIM message object type. Valid values: TIMTextElem (text message), TIMFaceElem (emoji message), TIMLocationElem (location message), TIMCustomElem (custom message)
MsgContent
Object
Yes
TIM message object. For more information, see the definition of TIMMsgElement in Message Formats.
TopicId
String
No
ID of the topic to which messages are imported. This field applies only to topic-enabled community groups.
CloudCustomData
String
No
Custom message data. It is saved in the cloud and will be sent to the receiver. Such data can be pulled after the app is uninstalled and reinstalled.
To_Account
Array
No
Specify message recipients (up to 50 members). If this field is used, the message will not be counted as unread. This feature is only supported in Flagship Edition and Enterprise Edition, and is compatible with Friend Work Groups (Work), Public Social Groups (Public), and Temporary Meeting Groups (Meeting).
SendMsgControl
String
No
Message importing permission, only valid for the current message. NoMsgCheck indicates that after cloud-based auditing is enabled, messages will not be submitted for review.​​

Sample response

{
"ActionStatus": "OK",
"ErrorInfo": "",
"ErrorCode": 0,
"ImportMsgResult": [
{
"MsgSeq": 1,
"MsgTime": 1620808101,
"Result": 0
},
{
"MsgSeq": 2,
"MsgTime": 1620892821,
"Result": 0
},
]
}

Response fields

Field
Type
Description
ActionStatus
String
Request result. OK: successful; FAIL: failed
ErrorInfo
String
Error information
ErrorCode
Integer
Error code. 0: Successful; other values: Failed
ImportMsgResult
Array
Message import result
Result
Integer
Result of each message
0: The message was imported successfully.
10004: The sending time of the message is invalid.
80002: The message content exceeds the limit of 12,000 bytes. Please adjust the message size.
MsgTime
Integer
Message timestamp
MsgSeq
Integer
Message sequence number, the unique identifier of a message

Error Codes

The returned HTTP status code for this API is always 200 unless a network error (such as error 502) occurs. The specific error code and details can be found in the response fields ErrorCode and ErrorInfo respectively. For public error codes (60000 to 79999), see Error Codes. The following table describes the error codes specific to this API:
Error Code
Description
10004
Invalid parameter. Check the error description and troubleshoot the issue.
10007
No operation permissions. This error occurs when, for example, a member in a public group tries to remove other users from the group (only the app admin can perform this operation).
10010
The group does not exist or has been deleted.
10015
The group ID is invalid. Use the correct group ID.
10020
The message content is too long. Currently, the maximum message length supported is 12 KB. Please adjust the message length.

API Debugging Tool

Use the RESTful API online debugging tool to debug this API.

References

Setting the Unread Message Count of a Member (v4/group_open_http_svc/set_unread_msg_num)

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백