Group chats and multi-person chats

# Group chats and multi-person chats

LINE Official Accounts can interact with users in group chats or multi-person chats using the Messaging API. Learn how you can use your LINE Official Account in a group chats and multi-person chats.

# Types of chats with multiple users

LINE has two types of chats with multiple users: group chats and multi-person chats. The users in a group chat or multi-person chat are called members.

Multi-person chat is merged into group chat

From LINE version 10.17.0, multi-person chat was merged into group chat. You can continue to use the multi-person chats that were opened before. But if you create a new chat with multiple friends on LINE version 10.17.0 or later, the chat becomes a group chat. See Create and manage groups (opens new window) (only available in Japanese) in the LINE user's guide.

# Group chats

Group chats are the chats designed for continuous use by multiple participants. A group ID is generated to identify a group chat. LINE users can create group chats with a desired name. Group chats support features such as albums and notes.

Tip

When a user invites a third user to a one-to-one chat, a group chat is created. Users can set whether or not to have an approval flow for users invited to the group chat. For more information on how to set approval flow up, see Create and manage groups (opens new window) (only available in Japanese) in the LINE user's guide.

# Multi-person chats

Multi-person chats are the chats designed for temporary use by multiple people. A room ID is generated to identify a multi-person chat. The name of the multi-person chat is automatically set to the names of the chat members. Multi-person chats don't support features such as albums and notes.

From LINE version 10.17.0, multi-person chat was merged into group chat. You can continue to use the multi-person chats that were opened before. But if you create a new chat with multiple friends on LINE version 10.17.0 or later, the chat becomes a group chat.

# Add LINE Official Account in group & multi-person chats

You can invite a LINE Official Account in a group chat or multi-person chat. To be invited, go to LINE Developers Console > Messaging API tab of your channel and enable Allow bot to join group chats. This setting is disabled by default. At any time, only one LINE Official Account can be in a group chat or multi-person chat.

# Receive webhook events

You'll receive webhook events for group and multi-person chats, like you do for one-on-one chats. For more information, see Webhook events for chats and Webhook Event Objects in the Messaging API reference.

# Tip for using message events

When a user send a message in a group or multi-person chat that your LINE Official Account is added, the LINE Platform sends the bot server a message event, like in one-on-one chats.

The message event has a property source that specifies the ID of the group chat (groupId) or of the multi-person chat (roomId).

"source": {
    "type": "group",
    "groupId": "Ca56f94637c...",
    "userId": "U4af4980629..."
}

For more information on group IDs and room IDs, see What are the user ID, group ID, and room ID values?.

# Send a request to an endpoint

The following operations are specific to group chats and multi-person chats. For more information, see Messaging API reference.

# Tip for sending messages

You can send reply messages and push messages in group chats and multi-person chats, like in one-on-one chats.

When you send a push message, specify the recipient with the group ID or room ID in the to property of the request body. You can get the recipient ID in webhook event objects. The messages you send in group chats and multi-person chats are displayed to all members of the chat.

Tip

You can't send multicast messages to multiple users in group chats and multi-person chats.