- Release Notes
- Product Introduction
- Purchase Guide
- Getting Started with Demos
- Console Guide
- SDK Documentation
- SDK Download
- Quick Integration (Including UI Library)
- General Integration (No UI Library)
- Update Logs (Web & Mini Programs)
- Update Log (Native)
- Legacy API Tutorials
- Client APIs
- Server APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Account Management
- One-to-One Messages
- Profile Management
- Pushing to All Users
- Relationship Chain Management
- Group Management
- Getting All Groups in an App
- Creating a Group
- Getting Group Profiles
- Getting Group Member Profiles
- Modifying the Profile of a Group
- Adding Group Members
- Deleting Group Members
- Modifying the Profile of a Group Member
- Disbanding a Group
- Getting the Groups a User Has Joined
- Querying the Roles of Users in a Group
- Bulk Muting and Unmuting
- Getting the List of Muted Group Members
- Sending Ordinary Messages in a Group
- Sending System Messages in a Group
- Recalling Group Messages
- Changing Group Owner
- Importing a Group Profile
- Importing Group Messages
- Importing Group Members
- Setting the Unread Message Count of a Member
- Recalling Messages Sent by a Specified User
- Pulling Historical Messages
- Getting the Number of Online Users in an Audio-Video Group
- Global Mute Management
- Operations Management
- Online States
- Third-Party Callbacks
- Third-Party Callback Overview
- Callback Command List
- Online Status Callbacks
- Relationship Chain Callbacks
- One-to-One Message Callbacks
- Group System Callbacks
- Callback Before Creating a Group
- Callback After Creating a Group
- Callback Before Accepting a Request to Join a Group
- Callback Before Accepting a Request to Add a User to a Group
- Callback After a User Joins a Group
- Callback After a User Leaves a Group
- Callback Before Sending a Group Message
- Callback After Sending a Group Message
- Callback After a Group Is Full
- Callback After Disbanding a Group
- Callback After Modifying Group Profile
- Callback Mutual Authentication Configuration Guide
- Best Practices
- FAQs
- General References
- Error Codes
- Release Notes
- Product Introduction
- Purchase Guide
- Getting Started with Demos
- Console Guide
- SDK Documentation
- SDK Download
- Quick Integration (Including UI Library)
- General Integration (No UI Library)
- Update Logs (Web & Mini Programs)
- Update Log (Native)
- Legacy API Tutorials
- Client APIs
- Server APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Account Management
- One-to-One Messages
- Profile Management
- Pushing to All Users
- Relationship Chain Management
- Group Management
- Getting All Groups in an App
- Creating a Group
- Getting Group Profiles
- Getting Group Member Profiles
- Modifying the Profile of a Group
- Adding Group Members
- Deleting Group Members
- Modifying the Profile of a Group Member
- Disbanding a Group
- Getting the Groups a User Has Joined
- Querying the Roles of Users in a Group
- Bulk Muting and Unmuting
- Getting the List of Muted Group Members
- Sending Ordinary Messages in a Group
- Sending System Messages in a Group
- Recalling Group Messages
- Changing Group Owner
- Importing a Group Profile
- Importing Group Messages
- Importing Group Members
- Setting the Unread Message Count of a Member
- Recalling Messages Sent by a Specified User
- Pulling Historical Messages
- Getting the Number of Online Users in an Audio-Video Group
- Global Mute Management
- Operations Management
- Online States
- Third-Party Callbacks
- Third-Party Callback Overview
- Callback Command List
- Online Status Callbacks
- Relationship Chain Callbacks
- One-to-One Message Callbacks
- Group System Callbacks
- Callback Before Creating a Group
- Callback After Creating a Group
- Callback Before Accepting a Request to Join a Group
- Callback Before Accepting a Request to Add a User to a Group
- Callback After a User Joins a Group
- Callback After a User Leaves a Group
- Callback Before Sending a Group Message
- Callback After Sending a Group Message
- Callback After a Group Is Full
- Callback After Disbanding a Group
- Callback After Modifying Group Profile
- Callback Mutual Authentication Configuration Guide
- Best Practices
- FAQs
- General References
- Error Codes
Note：Do not use APIs of new and old versions at the same time.
Initialization and Login APIs
To use Tencent Cloud IM services, you need to perform initialization and log in.
| API | Description |
|---|---|
| initSDK | Initializes the SDK. |
| unInitSDK | Uninitializes the SDK. |
| login | Logs in. |
| logout | Logs out. |
| getLoginStatus | Gets the login status. |
| getLoginUser | Gets the UserID of the current login user. |
Simple Message APIs
Use the following message APIs if you only need to use text and signaling (a piece of custom buffer) messages.
| API | Description |
|---|---|
| addSimpleMsgListener | Sets an event listener for simple messages (text messages and custom messages). Do not use it and addAdvancedMsgListener at the same time. |
| removeSimpleMsgListener | Removes the event listener for simple messages (text messages and custom messages). |
| sendC2CTextMessage | Sends a one-to-one (C2C) text message. |
| sendC2CCustomMessage | Sends a one-to-one (C2C) custom (signaling) message. |
| sendGroupTextMessage | Sends a group text message. |
| sendGroupCustomMessage | Sends a group custom (signaling) message. |
Signaling APIs
| API | Description |
|---|---|
| addSignalingListener | Adds a signaling listener. |
| removeSignalingListener | Removes a signaling listener. |
| invite | Invites a user. |
| inviteInGroup | Invites certain users in the group. |
| cancel | The inviter cancels the invitation. |
| accept | The invitee accepts the invitation. |
| reject | The invitee rejects the invitation. |
| getSignalingInfo | Gets the signaling information. |
| addInvitedSignaling | Adds invitation signaling (can be used for invitation signaling triggered by group offline push messages). |
Advanced Message APIs
If you need to send/receive rich media messages (images, videos, files, etc.) and use advanced features such as recalling messages, marking messages as read, and querying message history, use the following set of advanced message APIs. Do not use simple messages APIs and advanced message APIs at the same time.
| API | Description |
|---|---|
| addAdvancedMsgListener | Sets an event listener for advanced messages. Do not use it and addSimpleMsgListener at the same time. |
| removeAdvancedMsgListener | Removes the listener for advanced messages. |
| createTextMessage | Creates a text message. |
| createTextAtMessage | Creates an @ text message. |
| createCustomMessage | Creates a custom message. |
| createImageMessage | Creates an image message. |
| createSoundMessage | Creates a voice message. |
| createVideoMessage | Creates a video message. |
| createFileMessage | Creates a file message. |
| createLocationMessage | Creates a location message. |
| createFaceMessage | Creates an emoji message. |
| createMergerMessage | Creates a combined forward message. |
| createForwardMessage | Creates a single forward message. |
| sendMessage | Sends a message. The message object can be created by the createXXXMessage API, where XXX is a variable. |
| setC2CReceiveMessageOpt | Sets the Mute Notifications option for one-to-one messages. |
| revokeMessage | Recalls a message. The message object can be created by the createXXXMessage API, where XXX is a variable. |
| setGroupReceiveMessageOpt | Sets the Mute Notifications option for group messages. |
| getC2CHistoryMessageList | Gets one-to-one (C2C) message history. |
| getGroupHistoryMessageList | Gets group message history. |
| getHistoryMessageList | Gets message history. |
| markC2CMessageAsRead | Marks one-to-one (C2C) messages as read. |
| markGroupMessageAsRead | Marks group messages as read. |
| deleteMessageFromLocalStorage | Deletes a message from local storage. |
| insertGroupMessageToLocalStorage | Adds a message to the group message list. |
| insertC2CMessageToLocalStorage | Adds a message to the one-to-one message list. |
| findMessages | Finds local messages by msgID. |
Group APIs
Tencent Cloud IM SDK supports four preset group types, each of which pertains to different scenarios.
- Work group (Work): similar to a regular WeChat group. Users can only join the group by being invited by existing group members.
- Public group (Public): similar to a QQ group. Users can join the group through requests, which need to be approved by the group owner or group admin.
- Meeting group (Meeting): when used with TRTC, ideal for scenarios such as video conferencing and online education. Users can join and exit the group freely and view the existing message history before they join the group.
- Audio-video group (AVChatRoom): suitable for scenarios such as live streaming and chat rooms with on-screen comments. Users can join and exit the group freely. There is no limit on the number of group members.
| API | Description |
|---|---|
| setGroupListener | Sets an event listener for groups. |
| createGroup | Creates a group (simple). |
| createGroup | Creates a group (advanced). Group information and initial group members can be set during group creation. |
| joinGroup | Joins a group. |
| quitGroup | Quits a group. |
| dismissGroup | Deletes a group. Only the group owner and group admin can delete the group. |
| getJoinedGroupList | Gets the list of groups the current user has joined, excluding audio-video groups. |
| getGroupsInfo | Pulls the profiles of groups. |
| setGroupInfo | Modifies the profile of a group. |
| initGroupAttributes | Initiates group attributes. |
| setReceiveMessageOpt | Sets the group message receiving option. |
| deleteGroupAttributes | Deletes group attributes. |
| getGroupAttributes | Gets group attributes. |
| getGroupOnlineMemberCount | Gets the number of online group members. |
| getGroupMemberList | Gets the group member list. |
| getGroupMembersInfo | Gets the profiles of specified group members. |
| setGroupMemberInfo | Modifies the profile of a specified group member. |
| muteGroupMember | Mutes a group member. |
| kickGroupMember | Removes a member from a group. |
| setGroupMemberRole | Sets the role for a group member. |
| transferGroupOwner | Changes the group owner. |
| inviteUserToGroup | Invites users to a group. |
| getGroupApplicationList | Gets the list of requests to join a group. |
| acceptGroupApplication | Accepts a request to join a group. |
| refuseGroupApplication | Rejects a request to join a group. |
| setGroupApplicationRead | Marks the request list as read. |
Conversation List APIs
The conversation list is the list a user sees on the first screen after logging in to WeChat or QQ. It includes elements such as conversation node, conversation name, group name, last message, and unread count.
| API | Description |
|---|---|
| setConversationListener | Sets a conversation listener. |
| getConversationList | Gets the conversation list. |
| getConversation | Gets a single conversation. |
| getConversationList | Gets multiple conversations. |
| deleteConversation | Deletes a conversation. |
| setConversationDraft | Sets draft for a conversation. |
| pinConversation | Pins a conversation to the top. |
| getTotalUnreadMessageCount | Gets the total unread message count. |
User Profile APIs
APIs for querying user profiles, modifying one's own user profile, and blocking messages from a specified user (or adding a specified user to the blocklist).
| API | Description |
|---|---|
| getUsersInfo | Gets users’ profiles. |
| setSelfInfo | Modifies one's own user profile. |
| addToBlackList | Blocks the messages from a user, which means adding the user to the blocklist. |
| deleteFromBlackList | Unblocks the messages from a user, which means removing the user from the blocklist. |
| getBlackList | Gets the blocklist. |
Offline Push APIs
Use the offline push service if you want your app to receive IM messages in real time when it is in the background. As there is currently no unified push service in the Chinese mainland, to implement Android offline push, the mobile phones of different vendors need to be specifically adapted.
| API | Description |
|---|---|
| setOfflinePushConfig | Sets the offline push configuration. |
Friend Management APIs
By default, Tencent Cloud IM does not check your relationship with a user when receiving and sending messages. You can enable the "Check Relationship for One-to-One Messages" on Feature Configuration > Login and Message > Relationship Check in the IM console and use the following APIs to delete/add friends and manage your friend list.
| API | Description |
|---|---|
| setFriendListener | Sets a relationship chain listener to receive friend list and blocklist change events. |
| getFriendList | Gets the friend list. |
| getFriendsInfo | Gets the profiles of specified friends. |
| setFriendInfo | Sets the profile of a specified friend. |
| addFriend | Adds a friend. |
| deleteFromFriendList | Deletes a friend. |
| checkFriend | Checks the relationship with a specified user. |
| getFriendApplicationList | Gets the list of friend requests. |
| acceptFriendApplication | Accepts a friend request. |
| refuseFriendApplication | Rejects a friend request. |
| deleteFriendApplication | Deletes a friend request. |
| setFriendApplicationRead | Sets a friend request as read. |
| createFriendGroup | Creates a friend list. |
| getFriendGroups | Gets the information of friend lists. |
| deleteFriendGroup | Deletes friend lists. |
| renameFriendGroup | Modifies the name of a group list. |
| addFriendsToFriendGroup | Adds friends to a friend list. |
| deleteFriendsFromFriendGroup | Deletes friends from a friend list. |
Yes
No
Was this page helpful?