Chatroom Destruction Mechanism

The chatroom service supports flexible control over the destruction conditions and lifespan of chatrooms through various methods.

Chatroom Auto-Destruction Mechanism

Chatrooms have an auto-destruction mechanism. If the auto-destruction type is not configured when creating a chatroom and is not subsequently set via API, the default auto-destruction type is auto-destruction after inactivity. The chatroom will kick out all members and automatically destroy itself after 1 hour of inactivity ("inactivity" refers to a continuous period with no member activity or new messages).

You can modify the default settings at the App Key level from the Console to adjust the duration of inactivity after which the chatroom should be automatically destroyed. The self-service configuration supports a maximum of 24 hours. For details, see Adjusting Chatroom Destruction Wait Time.

Once the auto-destruction type is configured via API when creating a chatroom, the API-level configuration (including default values) takes precedence, regardless of whether the destruction time is set via API. The App Key-level configuration will not apply.

Setting Auto-Destruction Type

You can configure whether to destroy the chatroom at a scheduled time or after inactivity when creating a chatroom through parameter settings.

• If set to destroy after inactivity, you can pass the destroyTime parameter to specify the duration of inactivity (in minutes) after which the chatroom should be automatically destroyed (no member activity or new messages).
• If set to auto-destruct at a scheduled time, you can configure the lifespan (in minutes) via the destroyTime parameter. The lifespan starts counting from the time the chatroom is created. Chatrooms with this destruction type can have a maximum lifespan of 10800 minutes (7 days).

After the chatroom is created, you can modify the auto-destruction type of a specific chatroom via Setting Chatroom Destruction Type.

Situations Where Chatrooms Are Not Automatically Destroyed

• Keeping Chatrooms Alive: As long as a chatroom is kept alive, it will not be automatically destroyed. A chatroom in the keep-alive state can only be destroyed by calling the Destroy Chatroom API.