tencent cloud

All product documents
Chat
Last updated: 2025-03-20 16:26:34
Flutter
Last updated: 2025-03-20 16:26:34

Feature Description

A targeted group message is a message sent to specified members in a group, which cannot be received by other group members.
Note:
1. This feature is supported only by the SDK for Flutter on v3.8.0 or later.
2. To use this feature, you need to purchase the Pro edition 、Pro Plus edition or Enterprise edition.
3. The original message object used to create a targeted group message cannot be a group @ message.
4. The targeted group message feature is unavailable for communities (Community) and audio-video groups (AVChatRoom).
5. By default, targeted group messages are excluded from the unread count of a group conversation.

Sending a Targeted Group Message

A targeted group message is a message sent to specified members in a group, which cannot be received by unspecified group members. It can be implemented in the following steps:
1. Call the createXXXMessage API (here, XXX indicates the message type) to create an original message object V2TIMMessage.
2. Call the createTargetedGroupMessage API (Details) to create a targeted message object V2TimMessage based on the original message object and specify the list of group members to receive the message.
3. Call the sendMessage API to send the targeted message.
Sample code:
// Create a message first
V2TimValueCallback<V2TimMsgCreateInfoResult> target = await TencentImSDKPlugin.v2TIMManager.getMessageManager().createTextMessage(text: "");
// Get the ID for sending a message
String id = target.data.id;
// Create a targeted message
V2TimValueCallback<V2TimMsgCreateInfoResult> groupTarget = await TencentImSDKPlugin.v2TIMManager.getMessageManager().createTargetedGroupMessage(id: id, receiverList: ['user1','user2'],);
// Send the message
TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(id: groupTarget.data.id, receiver: "", groupID: "groupID");

Receiving a Targeted Group Message

By default, targeted group messages are excluded from the unread count of a group conversation. A targeted group message can be received in the same way as an ordinary message. For detailed directions, see Receiving Message.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon