Skip to main content

Chatroom Service Configuration

The chatroom service does not require separate activation, but certain chatroom-related features need to be enabled and configured in the Console, such as Chatroom Broadcast, Cloud Storage for Chatroom Messages, and callback URLs related to chatrooms.

Chatroom service configurations are primarily found in the Chat settings pages under the Chat section of the Console.

Feature Configuration​

The following configuration options are available in the RC Console under Chat > Chat settings > Chatroom:

  • Single User Joins Multiple Chatrooms: By default, a user can only join one chatroom. When enabled, a user can simultaneously join multiple chatrooms.
  • Chatroom Status Update Callback: This is a server-side callback service provided by RC. A valid callback URL must be provided. Once configured, real-time status updates (including creation, destruction, member join/exit events) will be synchronized to your application server. For details, refer to the Chatroom Status Update Callback documentation under "Chatroom Management" in the IM Server API documentation.
  • Specified Message Retrieval Upon Joining Chatroom: By default, up to 50 recent messages of all types are retrieved when joining a chatroom. When enabled, you can configure specific message types to retrieve.
  • Chatroom Custom Attributes: Custom attributes can be set for specific chatrooms, useful for scenarios like voice live streaming room synchronization or card game role/state tracking. For details, see the Chatroom Attribute Management documentation under "Chatroom Business". If your app server requires RC to synchronize attribute changes, provide a valid callback URL to automatically enable this server-side callback service. Refer to Chatroom Attribute Sync under "Chatroom Management" in the IM Server API documentation.
  • SDK Users Cannot Send Messages Without Joining Chatroom: By default, users can send messages to chatrooms without joining them. When enabled, users not in the chatroom cannot send messages via client SDK. Note: Server-side chatroom message APIs are unaffected by this setting.
  • Multi-Device Synchronized Exit from Chatroom: When a user is online on multiple devices in the same chatroom, exiting on one device won't automatically exit other devices by default. Enabling this feature ensures all devices exit the chatroom when one device exits.
  • Retrieve Specified Messages When Joining Chatroom: Only returns specified message types when joining a chatroom, filtering out other message types.

Modifying Service Configuration​

Visit the Chat settings page under Chat in the Console to adjust chatroom-related settings.

Last updated on