Mesibo Group Management APIs on mesibo documentation

Mesibo Group Management - Creating a Group

Mon, 01 Jan 0001 00:00:00 +0000

You can create a new group by calling createGroup API. It will send a request to the server to create a new group. When a group is created, Mesibo_onGroupCreated callback function in the listener will be called with the group profile. You can then add members to the group using group profile APIs. Note that, you will be already added as the owner and the member of the group and hence you should not add yourself again.

Mesibo Group Management - Managing Group Members and Admins

Mon, 01 Jan 0001 00:00:00 +0000

Adding Group Members and Admins

You can add members, and admins to the group by calling addMembers API of the group profile. You need to pass the addresses of the users to be added as group members, permissions to be granted and admin permissions if you are adding them as group admins.

You call the same API for adding members or modifying their member and admin permissions.

When you add members or make them admin, they will be immediately notified by a listener function (explained later).

Mesibo Group Management - Group Operations

Mon, 01 Jan 0001 00:00:00 +0000

Get Group Settings and Permissions

You can get group settings, permissions and PINs (only if admin) getSettings API of the group profile. When you call getSettings API, Mesibo_onGroupSettings callback function in the listener will be called with settings, permissions and PINs. If you are not a member, Mesibo_onGroupError callback function in the listener will be called with an error code.

void getSettings(GroupListener listener);

getSettings takes the following parameters:

Parameter	Description
listener	Group listener instance which will be called when group settings are retrived. Note that, if you are using Javascript, you can pass listener or a callback function. For all other platforms, it is the listener.
{:.proto-table}

Delete Group

You can delete the group by calling deleteGroup API of the group profile. You need to have the necessary admin permissions to delete a group.

Mesibo Group Management - PIN-based Group Management

Mon, 01 Jan 0001 00:00:00 +0000

The PINs based group management allows users to add themselves to a group by using a numerical PIN. The group admin can create a PIN with the necessary permissions and publish it to users so that they can join the group. The group admin can create multiple PINs with a different set of permissions. For example, the group admin can create a PIN that only allows limited functionality (say only to receive messages or group calls), while another PIN gives full functionalities like sending and receiving messages, making groups calls, etc.

Mesibo Group Listeners

Mon, 01 Jan 0001 00:00:00 +0000

Your app can implement the Mesibo.GroupListener to be notified of group events. The following listeners are a part of Mesibo.GroupListener:

Mesibo_onGroupCreated

Mesibo_onGroupCreated is called with the group profile when you create a group by calling createGroup API.

Mesibo_onGroupJoined

Mesibo_onGroupJoined is called with the group profile when you are added to the group

Mesibo_onGroupLeft

Mesibo_onGroupLeft is called with the group profile when you leave or removed from the group

Mesibo Group Management - Special Groups

Mon, 01 Jan 0001 00:00:00 +0000

In addition to groups you have created, mesibo provides a few special groups which always exist for each app you create. These groups make it easy to reach the different combinations of contacts and subscribers.

For example, you can send messages to all users who have subscribed to your profile update by sending messages to MESIBO_GROUP_SUBSCRIBERS without any additional coding. The members of these special groups are dynamically updated in real-time depending on the type of the group, and you don’t need to do any coding to reach these special audiences.