Rate this page:

Create, manage, and remove conversations

This article will teach you how to create, manage, and remove an IM conversation with Voximplant.

There are two types of conversations in Voximplant: direct and public. A direct conversation is one between two users only. A public conversation, or a chat room, can consist of up to 1000 users.

Before creating a conversation, create an application, users, and add Voximplant SDK to your project.

Create a conversation

To create a conversation, use the createConversation method:

Create a conversation

Create a conversation

By default, the conversation's members have the following permissions: canRead, canWrite, canRemove. You can specify another default permissions at conversation creation.

The user that created the conversation becomes its owner. After the conversation is created, other users can join it or be invited by administrators.

Manage a conversation

Administrators of a chat room or its owner can change the following preferences of the conversation:

  • Title
  • User permissions
  • Add and remove the participants
  • Custom data
Note

To make someone an administrator, the chat room's owner needs to set the canManageParticipants permission of a chat member to true.

Here is how you can manage a chat room's preferences:

Manage a conversation's preferences

Manage a conversation's preferences

Refer to the chat room user management guide to learn how to add and remove users and how to change their permissions.

Remove a conversation

To remove a conversation, the administrators of a chat room or its owner need to delete all the participants via the removeParticipants method, then leave the conversation via the leaveConversation method.

Remove a conversation

Remove a conversation

After that the conversation is deleted.