mesibo documentation

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

mesibo is a real-time messaging and communication platform that provides APIs and SDKs for adding end-to-end encrypted chat, group messaging, voice and video calling, conferencing, and more to your mobile or web app. It is designed for developers who want to build scalable, secure, low-latency communication features without dealing with infrastructure, protocols, or reliability challenges.

In addition to mobile (Android, iOS, Flutter) and JavaScript APIs, mesibo also provides SDKs for Python and C++ (x86 and ARM), enabling integration into desktop applications, AI workflows, and hardware devices.

Frequently Asked Questions - General

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

Bed and Chair Metrics

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

Welcome to the Docsy theme user guide! This guide shows you how to get started creating technical documentation sites using Docsy, including site customization and how to use Docsy’s blocks and templates.

What is Docsy?

Docsy is a theme for the Hugo static site generator that’s specifically designed for technical documentation sets and has a lot of best practices built in. Use Docsy to get a working and reliable documentation site up and running fast, and then get back to focusing on great content for your users. Learn more about Docsy.

Configuring Ponycopters

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Frequently Asked Questions - Messaging

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

Examples

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page that shows you how to use this template site.

Do you have any example applications or code for your users in your repo or elsewhere? Link to your examples here.

Launching Ponycopters

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Frequently Asked Questions - Group Messaging

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

Multi-Bear Domicile Setup

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Porridge Assessment

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Concepts

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

This is a placeholder page that shows you how to use this template site.

For many projects, users may not need much information beyond the information in the Overview, so this section is optional. However if there are areas where your users will need a more detailed understanding of a given term or feature in order to do anything useful with your project (or to not make mistakes when using it) put that information in this section. For example, you may want to add some conceptual pages if you have a large project with many components and a complex architecture.

Frequently Asked Questions - Video and Voice Calls

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

Another Tutorial

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Frequently Asked Questions - Message and File Storage

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

Frequently Asked Questions - Demo Apps

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

Frequently Asked Questions - HTTP Library

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

Frequently Asked Questions - API

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

Frequently Asked Questions - Platform

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

Accessing and Subscribing to Locations

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

You can use the MesiboProfile.location() API to access the locations of other users and groups, subject to the access level granted. The MesiboProfile.location() API returns a MesiboProfileLocation object, which can be used to access various location information, subscribe to location updates, and more.

MesiboProfileLocation profileLocation = profile.location();

MesiboLocation location = profileLocation.get();

val profileLocation = profile.location();

val location:MesiboLocation = profileLocation.get();

let profileLocation = profile.location()

let location = profileLocation.get()

MesiboProfileLocation *profileLocation = [profile location];

MesiboLocation *location = [profileLocation get];

MesiboProfileLocation profileLocation = profile.location();

MesiboLocation? loc = await profile.location().get() as MesiboLocation?;

If the location is available, the mesibo API will return it immediately. If not, it will return null and then request the location from the server. Upon receiving the location from the server, Mesibo_onLocationReceived will be called with the profile. You can then call the get() API again to obtain the location. In case the server does not have the location or the location has expired, Mesibo_onLocationError will be called.

mesibo SDK for Android

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

You can install the latest version of mesibo SDKs into your Android Studio project by adding Gradle dependency and performing Gradle sync.

Install Mesibo Core SDK

First, ensure mavenCentral() is configured in the top-level build.gradle file:

allprojects {
 repositories {
	mavenCentral()
 google()
 }
}

Then add the mesibo dependency in the app’s build.gradle file:

Build and Run Open Source Messenger

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

Welcome to Part 2 of the tutorial! In this section, we will download the source code of Messenger apps and build it on a real device. Let’s get started!

Downloading the Source Code

The latest Messenger App code is regularly updated mesibo GitHub repositories. Follow the instructions below to download Messenger code for language and platform of your choice:

$ mkdir Messenger
$ cd Messenger
$ git clone https://github.com/mesibo/messenger-app-android.git

$ mkdir Messenger
$ cd Messenger
$ git clone https://github.com/mesibo/messenger-app-android-kotlin.git

$ mkdir Messenger
$ cd Messenger
$ git clone https://github.com/mesibo/messenger-app-ios-swift.git

$ mkdir Messenger
$ cd Messenger
$ git clone https://github.com/mesibo/messenger-app-ios.git

$ mkdir Messenger
$ cd Messenger
$ git clone https://github.com/mesibo/messenger-javascript.git

Ensure to Star(*) the project on GitHub to get notified whenever the source code is updated.

Call Listeners

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

The Mesibo Call API provides the following listeners:

IncomingListener, MesiboCall.IncomingListener provides listeners to handle incoming calls, errors, show call UI, etc.
InProgressListener, MesiboCall.InProgressListener allows listeners to handle various call events for an ongoing call example, call ringing, answered, declined, hang up, audio device changed, etc.

You can use mesibo calls with default call handling logic and call UI as it is. You only need to implement these call listeners - IncomingListener and InProgressListener if you would like to customize how mesibo handles and displays call in your application. For example, filtering an incoming call, display a custom call screen, etc.

Configure FCM and APN Push notification Credentials in mesibo Console

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

To enable mesibo to send push notifications to your users, you need to configure push notification credentials in the mesibo console. Alternatively, you can also use mesibo backend APIs to configure push credentials.

Go to your App settings in the mesibo console and then go to the section Push Notifications. Now, upload FCM and APN credentials for your app.

You can perform following steps to get FCM or APN credentials.

Mesibo Connection Monitoring

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

You can monitor if your app is connected with the mesibo real-time server (cloud or your on-premise) by implementing Mesibo_onConnectionStatus in the connection listener. The connection listener is invoked when the connection status is changed. It is also invoked when the token is about to expire.

void Mesibo_onConnectionStatus(int status) {


}

The following are the status values:

Parameter	Description	Value
MESIBO_STATUS_ONLINE	The user is connected and online	1
MESIBO_STATUS_OFFLINE	The user is offline	2
MESIBO_STATUS_SIGNOUT	The user has signed out. The most likely reason is that the user has logged in from another device. You can use multi-device login feature if the user is required to log in from multiple devices simultaneously.	3
MESIBO_STATUS_AUTHFAIL	Token is wrong or expired. For Javascript, C++, and Python, it also happens if you have passed the wrong app id in `setAppName()`	4
MESIBO_STATUS_STOPPED	The user is offline and stopped. Automatic reconnection will not be attempted	5
MESIBO_STATUS_CONNECTING	The user is connecting but not online yet	6
MESIBO_STATUS_CONNECTFAILURE	Connection Failed	7
MESIBO_STATUS_NONETWORK	Mesibo API could not detect network connection on your device	8
MESIBO_STATUS_ONPREMISEERROR	You have configured the on-premise server but it is not running or the firewall is preventing your apps from connecting to the on-premise server	9

Contribution Guidelines

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

These basic sample guidelines assume that your Docsy site is deployed using Netlify and your files are stored in GitHub. You can use the guidelines “as is” or adapt them with your own instructions: for example, other deployment options, information about your doc project’s file structure, project-specific review guidelines, versioning guidelines, or any other information your users might find useful when updating your site. Kubeflow has a great example.

Create a Conference Room

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

In this section, we will learn about a conference room, its permissions, and settings. Then, we will explain how to create a conference room with required permissions & settings and add participants using Mesibo real-time and Backend APIs.

Before proceeding further:

Ensure that you are familiar with mesibo APIs and read throgh Get Started Guide. Also, you are familar with mesibo Group Management APIs.

Download Conferencing App Source code. Follow along as you go through this document.

Creating User Access Tokens

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

Now that you have created an Application and obtained the App Token, the next step is to create user access tokens. A user access token is required by every user to authenticate with mesibo and use its real-time APIs — messaging, calls, conferencing, and more. Your client applications (Android, iOS, Flutter, Web, etc.) use these tokens to connect to mesibo on behalf of your users.

User access tokens are generated by your backend server using the mesibo Backend API. Each token is bound to three things: the App Token that identifies your Application, the Address that identifies the user, and the App ID that identifies where the token is permitted to be used.

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 End-to-End Encryption APIs

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

There are only two classes to configure mesibo E2EE:

MesiboEndToEndEncryption

MesiboEndToEndEncryption is a global class to manage global and per-user E2EE configurations. Mesibo creates an instance of the class which you can access by calling Mesibo.e2ee() function as shown above.

MesiboEndToEndEncryption

MesiboProfileEndToEndEncryption is a class to manage a user-specific E2EE configurations. MesiboProfile creates an instance of the class which you can access by calling MesiboProfile.e2ee() function.

Mesibo Real-time APIs - File Transfer and Hosting

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

Overview

Just like text messages, mesibo’s real-time file transfer API allows you to send and receive any arbitrary file - images, videos, documents, audio files, and more - in real-time.

By default, all media and files are stored on mesibo’s secure file servers, making it easy to get started quickly. However, many organizations - particularly those in regulated industries such as healthcare (HIPAA compliance), financial services, legal, government, and dating applications - require complete control over where and how their sensitive data is stored.

mesibo On-Premise Local Configuration

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

While mesibo On-Premise can be configured entirely through the mesibo Console, many mesibo users, particularly those in regulated industries — prefer a local configuration file — /etc/mesibo/mesibo.conf, for stricter control over credentials and deployment settings. Parameters in the local file take priority over both command line arguments and console settings.

Local configuration is useful in the following scenarios:

Regulatory Compliance — Financial institutions, government agencies, and other security-sensitive organizations often have strict requirements that prohibit sharing database credentials with external systems. Local configuration keeps credentials entirely within your own infrastructure.
Custom Certificates — Specify SSL certificate paths in the config file rather than on the command line.
Advanced Logging — Enable granular, per-component logging for debugging or audit purposes.
Network Configuration — Override hostname validation and other server-specific settings.

Creating the Configuration File

Step 1 - Create the Configuration Directory

Create the configuration directory on your host system if it does not already exist:

Mesibo Chatbot and Scripting - Mesibo Object

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

The core class Mesibo defines a set of event handlers and utilities that you can use to send messages, get message flags, receive messages, etc.

Constructor

The class Mesibo is not instantiable. A single instance of the class Mesibo, named mesibo exists in global context whose properties can be initialized. Refer Usage Notes for more details.

Properties

Mesibo.onmessage _mandatory

An event listener to be called when message is receieved. It is mandatory to initialize this event handler. MUST return Message.PASS, Message.FAIL, Message.CONSUMED, Message.READ, Message.DELIVERED etc, or the message string.

Mesibo Open Source Chat, Voice and Video Calls UI Modules

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

There are primarily two categories of Messaging UI screens:

Messaging Screen

The Messaging Screen displays all messages for a specific user or group. It enables users to send and receive a wide variety of messages, including but not limited to:

Text messages
Rich messages containing images, videos, documents, audio, and more
Location sharing
URL preview
etc.

It addition, it also shows

Send, Delivery and read indicator for sent messages
Typing Indicators
Other presence status indicators such as online or actively chatting
Message date and time

The entire messaging screen can be customized, allowing adjustments to text styles, colors, and other elements, as elaborated in subsequent sections.

Frequently Asked Questions - On-Premise Deployment

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

Publishing a Profile and Controlling Profile Privacy

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

Your app users can create and publish a profile about themself so other users can view it. Depending on the app, users can add different information to the profile like name, photos, location, relationship status, etc. In addition, group owners and admins can also create, edit and publish profiles for their groups with information about the group. Note that a user can’t modify or publish another user’s profile.

In this section, we’ll explore:

Uploading and Configuring Scripts

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

The scripting interface is provided through the Mesibo console. You need not configure or install anything additional to use the mesibo chatbot and scripting framework. Just login to your mesibo console, upload your script, and get going!

There are two parts to the process:

Upload one or more scripts using the mesibo console. When you upload a script, it will get added to your script library. However, it will not be active unless you assign it to your app or one or more users.

Mesibo Backend APIs - User Management

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

Before your users can use mesibo services, mesibo need to know about your users so that mesibo can enable real-time messaging, calls, and conference between them.

mesibo identifies each user by a unique random string, called address. The address can be anything, for example, phone number, email address, your enterprise user ID, etc. You need to create a mesibo user for each of your app users.

mesibo will generate an authentication token when you create a user. This user token is also called the access token. You need to send this token to your apps so that your app can initialize mesibo Mesibo Real-time APIs using this token. Refer to the Get Started tutorial to learn more about it.

Mesibo Release v2.4

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

We are excited to announce the release of mesibo v2.4, which includes a powerful new profile API with enhanced customization and access control.

This update introduces major improvements you’ll want to integrate into your Mesibo applications. We recommend reviewing these changes and updating your Mesibo APIs accordingly.

Key Highlights

Flexible Profile Schema

Previously Mesibo profiles had predefined fields like name, status, etc. Many of our customers have requested for additional fields. You can now add custom profile fields suited to your app needs instead of predefined ones using set and get APIs, same as provided for ‘MesiboMessage’. For example:

Mesibo Phone Contacts Validation and Formatting

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

mesibo simplifies the process of validating, correcting, and formatting phone numbers to a great extent. mesibo’s phone APIs offer faster performance compared to other APIs like libphonenumber while maintaining the same or even better accuracy and reducing unnecessary overhead.

You can utilize the getPhoneNumberInfo() function to validate and format phone numbers. It will also attempt to detect and add the country code if it’s missing. This function returns a MesiboPhoneContact object that contains various fields such as name, country, and type, as described below.

Frequently Asked Questions - Pricing, customization and terms

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

Frequently Asked Questions - SDK

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

Frequently Asked Questions - Webhooks and Push Notifications

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

Frequently Asked Questions - Security and Privacy

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

Frequently Asked Questions - UI Modules

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

Frequently Asked Questions - Other

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

Frequently Asked Questions - Support

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

Frequently Asked Questions - Chatbot and Scripting

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

Frequently Asked Questions - Voice and Video Conferencing

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

Mesibo Backup and Data Migration APIs

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

Mesibo backup and data migration APIs allow you to regularly backup your users’ data (messages, call history, profiles, settings, etc) and then restore it when needed, for example, when the user moves to another device.

In addition to backup and restore, mesibo provides APIs to know when the last backup was taken, and the age of the database so that you can decide when to initiate the next backup as required by your app or organization policies.

Configure Tokens and Run Sample App

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

We are now ready to configure the app with user access tokens and run it. We’ll first briefly understand the initialization code, then run the app, all in just 4 steps:

Before proceeding further:

Download the source code of the app in this tutorial from the mesibo GitHub repositories.

Open it in your IDE (Android Studio, Xcode etc). Follow along as you go through this tutorial.

Step 1: Set Up mesibo Listeners

mesibo is a real-time, asynchronous platform. Messages, calls, and status updates can arrive at any moment — your app does not poll or check for them. Instead, you register listeners that mesibo calls instantly the moment an event occurs.

Customization and Rebranding Android, iOS and Web Messenger

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

With the complete source code at your disposal, you have the freedom to customize every aspect of these apps to meet your specific requirements and branding. Not only can you modify the app’s visual appearance, but you can also customize how each message is rendered (which we will cover in our upcoming chatbot tutorial).

Although we won’t cover all the possible customizations in this tutorial, we will focus on some important ones, as follows:

Mesibo End-to-End Encryption - Cryptography APIs

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

mesibo automatically sets optimized cryptography configuration and hence you don’t need to use any of these APIs unless you have special needs.

Setting Supported and Preferred Ciphers

mesibo uses 256-bit encryption and supports using multiple ciphers simultaneously to make interception difficult. By default, all the ciphers are enabled. mesibo prefers to use CTR-based and AEAD (authenticated encryption with associated data) ciphers and the AES-GCM is the default preferred cipher. You can change the supported and preferred ciphers by calling setCiphers method of MesiboEndToEndEncryption.

Customizing User Interface and Message Rendering

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

Mesibo messaging UI is completely open-source, allowing you to download the entire source code and tailor the user interface to suit your application’s needs.

Alternatively, you can also customize most of the user interface including how messages are rendered by implementing MesiboUIListner. The mesibo UI will call this listener functions with the screen and row data as explained below.

Prerequisites

The Mesibo messaging UI is based on RecyclerView in Android and UITableView in iOS. Hence, you must be well-acquainted with these components:

mesibo Documentation

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

Mesibo Scripting Essentials

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

In this section, we will look at some of the essential elements of mesibo scripting. Although you will be using the same Javascript you are already familiar with, there are a few mesibo specific extensions you need to use for handling incoming messages, sending responses, etc.

Let’s get started with the global object mesibo.

mesibo - the master object

There exists a global object, mesibo which is an instance of the class Mesibo(). It is accessible from anywhere in the script and used for configuration and setting various event handlers such as message handler, message status handler, login handler, timer handler, exception handler, etc.

Mesibo Real-time Chat APIs - Forward Messages

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

In this section, we will describe how to forward existing messages and check if any incoming message was forwarded.

Forward a Message

To forward an existing message, you only need to create a MesiboMessage object from the original message and send it.

MesiboMessage msg = origMessage.forward(profile);
msg.send();

where the profile is the user or group profile to whom you want to forward the message. You can change the properties of the new message like expiry, message ID, type, etc. However, you can not modify the message content.

Mesibo Backend APIs - Group Management

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

mesibo allows you to create groups having a set of users as group members. Once you create a group, you can send messages to the group, and all the group members will receive the messages.

Unless you have a specific need for creating groups using backend API, we recommend using real-time Group Management APIs to create groups and add members. It is real-time, powerful, and works across both cloud and on-premise deployment without any changes.

Hosting Backend APIs with mesibo On-Premise

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

When using mesibo On-Premise, mesibo has no access to your database. As a result, only a limited set of operations — useradd, userset, and usertoken — can be performed through the mesibo-hosted backend API. For all other operations such as group management or sending messages, you must use the real-time APIs, for example the real-time group management APIs.

For this reason, hosting the backend APIs on your own server is the recommended setup for all On-Premise deployments. When you host the backend APIs, all backend API calls go directly to your own database without passing through mesibo at all, keeping your data entirely within your control. It also gives you full access to the complete backend API, ensures your database is updated instantly for all operations, and unlocks additional endpoints like usersget, groupsget, and more.

Integrate Conferencing APIs

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

Prerequisites

Before we dive into the various concepts and APIs for conferencing & streaming, you need to go through the following to familiarize yourself with mesibo APIs.

Get Started Guide
Familiar with Real-time Group Management and Group Messaging APIs.
Basic familiarity with Mesibo Call APIs
It is also recommended that you refer to the source code of mesibo open-source Conferencing App to quickly learn how each API is used.

Key Terms

In this document, we will use the following terms

mesibo SDK for iOS

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

The Mesibo SDKs for iOS are available via CocoaPods or as standalone frameworks that can be installed manually.

Minimum Requiements

Latest stable Xcode version.
Target iOS 11.0 and above
Ensure to add -ObjC linker flag to your Xcode project Build Settings -> Linking -> Other Linker Flags

You can install mesibo into your Xcode project by using CocoaPods or manually downloading mesibo frameworks from GitHub and adding them to your project.

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).

MesiboCall Class Reference

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

MesiboCall is the main class to access all the mesibo call API functionalities and access the following classes:

For a detailed review of the Call API, see Mesibo Voice and Video Call API .

MesiboCall is a singleton class. You can access the instance of MesiboCall using the getInstance() method.

For example, in Android,

MesiboCall.getInstance()

Once you obtain the instance, you can then call the following methods.

MesiboCall methods

init

Initialize the mesibo call.

Mesibo Chatbot and Scripting - Message Class

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

The Message class can be used to send messages. Messages received in the handler mesibo.onmessage will be of this type.

Constructor

Message()

The constructor initializes the Message class. It must be called before you perform any method calls. Some of the property fields will be already initialized for you by mesibo and are also protected(read-only).

Properties

Message.aid _read-only

Application ID. If you are sending a message, it is necessary to set this field to a vaild aid. Automatically initialized.

Mesibo Phone Contacts Monitoring and Synchronization

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

In the previous section, we covered the basic phone contacts APIs. Now, we will discuss the mesibo APIs for synchronizing phone contacts and monitoring contact changes. The phone contact synchronization API uses mesibo contact syncronization APIs internally and hence familaize yourself with it before reading further.

Why Phone Contacts Synchronization is important?

Contact synchronization is important for several reasons:

If your app logs in users based on their phone number, syncing contacts allows identifying which of the user’s contacts are also using your app. This facilitates connecting users with their contacts seamlessly.

Preparing your App to receive Push Notifications

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

Once you configure push credentials in the mesibo console, mesibo is almost ready to send push notifications to your users. However, you still need to prepare your app to receive and process push notifications. You need to ensure that your app can process push notifications quickly and can perform the following tasks.

Initialize mesibo on receiving a push
Use local notifications to show customized notifications
Send device token to mesibo

1. Initialize mesibo on receiving a push

When your app receives a push notification, the system launches your app or wakes it from the suspended state. If you have already initialized mesibo, and when the system wakes your app from the suspended state, mesibo will connect automatically. However, if the system launches your app on receiving push, your app MUST ensure that mesibo is initialized quickly before the system suspends your app.

Searching Users and Groups Based on Location

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

The mesibo location search APIs allow you to search for other users and groups based on location, distance, location age, and more. Your users can search based on the current or a custom location. To implement location search feature in your app, you need to follow these two steps:

Step 1 - Implement Mesibo Profile Search Listener

You need to implement the MesiboProfileSearchListener interface to receive profile search results. The following are listener functions:

mesibo release - v2.3

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

The last mesibo update brings forth numerous enhancements, including the introduction of the new Flutter SDK and Phone Contacts API. Among various other enhancements, we’ve incorporated real-time billing notifications using webhooks as requested by many enterprise customers. Furthermore, we have expanded platform support by introducing APIs for Microsoft Windows.

We highly recommend reviewing these changes and updating mesibo APIs in your applications:

Flutter SDK

mesibo introduces the first version of Flutter SDK for Android and iOS. For detailed information, please refer to the Flutter SDK installation instructions and tutorial.

Viewing Profile Information and Images

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

As explained before, a user can publish a profile about themselves that other users can view. Groups can also publish profile information that members can view. This section explains how users can access and view those profiles.

Getting the Profile of another User or a Group

You can get the profile of any user or group by calling getProfile API.

profile = Mesibo.getProfile(userAddress);

Or,

profile = Mesibo.getProfile(groupId);

If the profile already exists locally, the getProfile() function will instantly return it. If not, it will return an empty profile and request the profile from the mesibo (or your on-premise) server.

Conference Admin and Moderation | Mesibo Video Conferencing SDK

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

In this section, we will learn about conference room administration. The group owners and admins can perform various admin tasks using Admin API, depending on the admin permissions. For example,

mute or unmute participants
ask participants to publish voice and video streams on demand
ask participants to stop publishing without leaving the room
ask participants to view/subscribe to a particular publisher
ask participants to leave the room
ask participants to view streams in full screen
make other participants admin
etc.

To administer or moderate a conference room, one needs to be an owner or an admin of the room. Refer to the Real-time Group Management APIs to learn about how to add admins to the group.

Call API Reference

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

The following is a list of methods available in Call API. The Call object is created by calling MesiboCall.call() or mesibo creates for you in an incoming call as explained in Overview.

Initialization Functions

start

It starts call processing. This MUST be the first function you should call once your user-interface is ready.

It takes the following parameters:

ctx, Activity/View Controller
InProgressListener, InProgressListener

setListener

Set the listener class that will be called during the active call. You will only need to use this function if you need to change the listener after calling start().

mesibo SDK for Flutter

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

mesibo Flutter SDK allows you to quickly add messaging, calls, and conferencing on your Flutter app in a few lines of code.

Supported Platforms

mesibo flutter SDK supports

Android
iOS

Minimum Requiements

Latest Flutter 3.19 and above
Refer to the minimum requirements for mesibo Android and iOS APIs

Installing mesibo SDKs in your Flutter Apps

With Flutter:

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.

High Availability for mesibo On-Premise

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

mesibo On-Premise supports high availability (HA) configurations that keep your service running through server failures, hardware faults, network outages, or data center incidents. This is achieved by running multiple mesibo On-Premise instances, where one or more standby instances automatically take over if the active server becomes unavailable.

mesibo offers the highest form of high availability configuration, known as M+N redundancy, where the M is the number of active servers which will serve your users and N is the number of the standby server that will take over when one of the active servers will fail. This approach provides resiliency against any kind of failure including catastrophic events by adding standby servers across the globe. M & N varies depending on the type of the account, M is currently 1 for on-premise.

Backend for Open Source Android, iOS and Web Messenger

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

Adding a login mechanism to an app is a fundamental part of building secure applications that require user authentication. You need to implement a registration process where new users can sign up for your app by providing their information, such as phone, email, username, and password. Once users provide this data, your app communicates with your server to perform the authentication process, which requires the creation of APIs on your server for authentication. It’s important to note that this process is entirely independent of mesibo, and the implementation of your login mechanism is at your discretion.

Mesibo Chatbot and Scripting - HTTP Class

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

The Http class can be used to make REST calls to a request endpoint and receive data asynchronously.

Constructor

Http()
The constructor initializes the Http class. It must be called before you perform any method calls.

Properties

To make an HTTP call you can set the following properties for an Http class object.

Http.url

Both http and https URL are supported. You can also pass authentication information in URL. For example, https://username:password@yourapiurl.com

Mesibo End-to-End Encryption - Man-in-the-middle Protection APIs

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

It is generally not necessary to configure these options for casual chat. The default end-to-end encryption provides best-in-class security. However, if you are worried about eavesdropping, you can use a secret password, or install the public certificate of the peer. They are included in the per-message encryption process, and these out-of-the-band methods make it nearly impossible for anyone to intercept your communication.

Setting a Password

You can set a password that is included in the encryption process (KDF). The peer needs to use the same password to decrypt the messages. Setting a password can be very effective against a man-in-the-middle attack. Refer to the article link above for the description.

Mesibo Backend APIs - Messaging

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

While your users can send messages to each other or groups using Mesibo real-time APIs, your backend can also send messages to one of your users or groups using backend API.

To send a message, you need to send a message JSON request to the backend API, for example:

{
 "op": "message",
 "token": "ptlk9hdel1gqxf3p0s15f5f5gtusldej18tl794suzit",

 "message": {
 "from": "me",
 "to": "you,she,he",
 "gid": 111,
 "type": 0,
 "expiry": 3600,
 "flags": null,
 "forced": true,
 "message": "This is my message"
 }
}

Parameter	Description	Default
op	MUST have the value - “message” (see example above)	Mandatory
token	Application Token obtained from the mesibo console	Mandatory
message.from	From address [MUST be a valid user]
message.to	To addresses, comma separated
message.gid	Group ID	0
message.type	Message Type	0
message.expiry	Expiry in seconds	1 year
message.when	Schedule after `when` seconds	0 (now)
message.message	Message
message.url	File URL
message.title	Title, when sending a file URL

If the request is successful, the response will be like,

Changing Default Texts, Localization, Colors, and other UI elements

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

You can change default texts, perform localization, change colors, and other UI properties to suit your app needs

MesiboUI creates a singleton object MesiboUiDefaults having various properties which you change as needed. You should configure it once at the start. It is NOT RECOMMENDED to change these values at runtime.

Below is a list of a few properties. Refer to the source code for the complete definition

public static class MesiboUiDefaults {
	...
	public String messageListTitle = "Messages";
	public String userListTitle = "Contacts";
	public String createGroupTitle = "Create a New Group";
	public String modifyGroupTitle = "Modify Group details";
	public String selectContactTitle = "Select a contact";
	public String selectGroupContactsTitle = "Select group members";
	...
}

To change, get the instance of MesiboUiDefaults and change the necessary variable.

Mesibo Phone Contacts Utility Functions

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

You can also use the followng functions as needed:

Country Information

You can use one of the following functions to get country information:

MesiboPhoneContact getCountryCode();
MesiboPhoneContact getCountryCode(String countryCode);

where countryCode is the ISO country code (for example, ‘US’) or phone code (for example, ‘1’). If invoked without any parameters, getCountryCode returns the information about the currently set country.

Name Lookup Options

The mesibo phone contact API allows you to retrieve contact names, country information, and more from phone numbers. mesibo uses native Android and iOS APIs for this purpose and maintains a cache for efficient lookups.

Subscribing to Mesibo Profile Update

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

Subscribing to a Profile

You can subscribe to a user’s profile so your app can be notified when that profile is changed.

When you first call getProfile() for a user, if their profile doesn’t exist locally, your app will automatically be subscribed to receive updates for that profile. You can also manually subscribe or unsubscribe anytime:

profile.subscribe(false);

Once subscribed to a profile, your app will be notified of any updates through listeners. There are two types of listeners that you can implement:

Message Reply and Conversation Threading

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

Conversation threading is a very useful feature that allows you to create message threads by

Replying to messages
Associating and Grouping a set of messages with something related to your apps (message context).

Threading by Reply

You can create a message thread by replying to messages. There is no limit on the depth of the message thread and hence you can reply to a reply and so on.

Creating your first chatbot

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

In this tutorial, we will create a simple chatbot with mesibo scripting. Mesibo scripting allows you to easily interface with chatbot and NLP engines like Dialogflow, IBM Watson, Microsoft Azure Bot Services, etc. For this sample, we will be using Dialogflow, but you can modify this example to connect with any other services.

Prerequisites

We will not get into the details of building the Dialogflow agent from scratch. Please refer to the Dialogflow Docs for learning the basics of Dialogflow and building your chat agents.
DialogFlow Project ID and the keys which you can get from DialogFlow console.

1. Create a Dialogflow agent

Go to Dialogflow Console and create an agent. Refer to Creating an Agent. You can build your agent from scratch or import prebuilt-agents like Smalltalk. If you wish to customize the responses, you can do so by clicking on the intent and modifying the Text response. Here is a detailed tutorial for building a basic chatbot in Dialogflow

Troubleshooting Push Notifications

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

Push notifications are crucial for keeping your app users engaged and informed. If you’re facing issues with push notifications, follow these steps to troubleshoot and resolve the problem. Do not skip any steps or the final note. We have covered all scenarios, common mistakes, and even provided you with scripts to bypass mesibo and send push directly.

Step 1: Verify Firebase and Apple Push Credentials

Ensure that you have correctly configured the push credentials for Android (Firebase) and iOS (Apple Push Notification Service) in the mesibo console as described here. Common mistakes include:

Users and Groups

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

Before driving into messaging, calls, and other aspects, let’s first understand the concept of end-points or destinations.

For instance, when you send an SMS, the destination is a phone number. When sending an email, the destination is an email address. Similarly, in mesibo, the address (previously used for creating tokens) serves as the destination for one-to-one messages or calls. As mentioned earlier, the address could be any string, as defined by your application. In your application, a user is identified by their address.

CallProperties Class Reference

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

MesiboCall.CallProperties defines various call properties and behavior, for example, video size, bitrate, hide on proximity, etc.

For information on the entrance class, MesiboCall see MesiboCall.

Creating an instance of CallProperties

Use the method MesiboCall.createCallProperties() to get an instance of CallProperties.

For example, in Android, to create call properties for a video call,

MesiboCall.CallProperties cp = MesiboCall.getInstance().createCallProperties(true);

Set audio properties for a call using CallProperties.audio which will contain an instance of AudioProperties
Set video properties for a call using CallProperties.video which will contain an instance of VideoProperties

Example, in Android,

Installing mesibo on-premise as Linux service without using Docker

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

If you are an experienced Linux user, you can install mesibo on-premise with web-based control panel on your Linux server directly (just like any other software) without using docker. We earlier offered Amazon EC2 AMI created using this approach. However, since many mesibo users use other hosting providers, we are making all the steps, and scripts available in this document.

The Pros and cons of this approach are:

Pros

Simplified setup (networking, file system access, etc)
Control mesibo using Linux service manager systemctl that provides more flexibility compared to docker
[Optional] web-based control panel to configure and control (start/restart/stop/update) mesibo
Slight performance advantage.

Cons

Limited Distributions, unlike the mesibo docker image which supports almost all Linux distributions, this approach is supported only on RHEL8 (Ubuntu soon) based distributions.

Prerequisites

It is required that you refer to and try Docker-based installation first before you attempt this.

mesibo SDK for JavaScript

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

Install Mesibo Javascript SDK

The easiest way to install mesibo Javascript SDK is to include following in <HEAD> section of your HTML file:

<script src="https://cdn.mesibo.com/api/mesibo-version_js.js"></script>

or, to always use the latest version,

<script src="https://cdn.mesibo.com/api/mesibo.js"></script>

You can also use async and defer attributes inside script tag if requires.

Alternatively, you may also use DOM method to load the mesibo JS on demand when it is not possible to use the script tag.

Backend for Open Source Android and iOS Messenger

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

In this section, we will discuss hosting the complete Mesibo real-time messaging, voice, and video server on your own premises.

It is important to note that there is no need to make changes to the mesibo messenger or any mesibo-powered application when deploying on-premise. This ensures that the transition from a cloud-based deployment to an on-premise configuration, changing the on-premise server, or deploying in a high availability configuration will not have any negative impact on your current app users. Your users can continue using the same app irrespective of your deployment model.

Open-Source Video Conferencing App

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

To make it easier for you, we have created a fully-featured open-source Zoom-like conferencing app for web and mobile.

Standard, HD, FHD, UHD, and 4K resolution
Multiple Camera, Multi-angle Streaming
Multiple Screen Sharing
Talk Detection
Collaborative Whiteboard
Group Voice and Video Call
One-to-One & Group Chat

Try the Demo

Download Source Code

You can download the entire source code from our GitHub repository, customize and rebrand it without any restrictions. Using mesibo SDKs and open source code, it will only take a few hours for you to build a fully-featured conferencing app.

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 Profile Customization Listener and Functions

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

In some situations, you may want to modify or fill in missing profile information. For instance, if a user hasn’t uploaded a profile picture, their profile image will be empty. Instead of displaying nothing, you can replace it with a custom image. Similarly, you might need to override the user’s name with a name from their phone book based on your app’s logic. In this section, we will describe mesibo customization listener and functions.

Mesibo Backend APIs - Push Notifications

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

This section describes how to configure push notification credentials using backend APIs. For in-depth details on how to use mesibo push notifications and configuration using the console, refer to the mesibo push notification documents.

If you are using the mesibo on-premise server, it is highly recommended to use backend APIs to configure push notifications instead of the mesibo console. This ensures complete privacy of your push notification credentials. If you configure push notifications using both the backend API and the console, the on-premise server will give preference to the credentials configured via the backend APIs, which are saved in your database.

Reading Stored Messages and Sending Read Receipts

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

This set of APIs deal with reading stored messages in the database, sending read receipts, and syncing messages across devices.

To read stored messages from the database, you need to create a read session and set the criteria to read messages; for example,

read all messages
read messages from a sender
read messages for a particular group
read messages matching a search query
read messages for a conversation thread
etc.

Reading Modes

There are two modes of operation

Sending and Receiving Messages

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

In this section, we will describe how to send and receive messages.

mesibo allows you to send and receive various types of real-time messages - plain text, rich message with media such as image, audio, video, doc, etc, URL preview, location, binary data, etc.

A message has various properties, for example, id, status, expiry, etc. Refer to the messaging api documentation for more details.

Sending Messages

To send messages, you only need to create a MesiboMessage object using the destination profile, which could be user profile or a group profile.

Mesibo Chatbot and Scripting - Socket Class

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

The Socket class can be used to connect to a host through a scoket, to send and receive data asynchronously.

Constructor

Socket(url)

The constructor initializes the Socket class. It must be called before you perform any method calls. Call the constructor by passing the url(For websockets) or host address(for regular sockets).

The URL is to be specified in the format: <type>://<url>

The following types are available:

Conclusion

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

Congratulations!

You’ve created a fully functional Messenger/Chat app with messaging, voice and video calls. Visit our Support Page if you have any questions.

There is much more to the Mesibo platform than what was covered here. We will soon have more tutorials for you to fully utilize Mesibo platform to suit your needs.

Configuring On-Premise Conferencing and Group Calls

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

mesibo live is the conferencing and group calls server included with mesibo On-Premise. It runs as a separate instance from the main mesibo On-Premise server and can be scaled horizontally by running multiple instances.

You can run multiple instances of the mesibo live server depending on the load. The mesibo live automatically handles load balancing across instances and scales up or down as you add or remove more instances.

Note: mesibo On-Premise must be running before you start mesibo live.

Mesibo Chatbot and Scripting - Dialogflow Class

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

The Dialogflow class can be used to connect to the Dialogflow chatbot service endpoint over REST

Constructor

Dialogflow()

The constructor initializes the Dialogflow class. It must be called before you perform any method calls.

Properties

To connect to a chatbot you can set the following properties for an Dialogflow class object.

Dialogflow.project_id

Google Cloud Project ID linked with your Dialogflow chatbot.

Dialogflow.service_account

Google Project service account. A service account is identified by its email address, which is unique to the account.

Mesibo Video Conferencing API - Listeners

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

The Mesibo Conferencing API provides the following listeners:

GroupCallListener, MesiboCall.GroupCallListener provides listeners that inform you about participants publishing and subscribing in the conference.
GroupCallInProgressListener, MesiboCall.GroupCallInProgressListener allows listeners to handle the stream that you are receiving from a participant such as, mute, hang up, talk detection, etc.
MesiboGroupCallAdminListener, MesiboCall.GroupCallAdminListener provides listeners that inform you about the admin requests in the conference. For example, if the participant was muted by the admin, or the admin is requesting participant to publish, or to go full screen, 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 Presence APIs - Online Status, Typing Indicators, and more

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

Mesibo presence APIs allow your active users to share their activities, for example, online and offline status, typing indicator, joining and leaving the chat, game actions, etc. as it happens in real-time. Although sending and receiving presence information is completely optional, it can greatly enhance chat engagement.

Note that, presence messages are never stored and only delivered to online users.

You can define and send different types of presence messages to meet your app requirements. Mesibo also has some pre-defined presence messages, as described below.

Contact Management and Profile Synchronization

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

An app can have millions of users. However, each user of the app is only communicating with a set of users. Even within this set, only a few users with whom the user may be interested in receiving updates. Also, there are users with whom the user does not want to communicate at all.

Similarly, not every user may wish to disclose their information to all others. Effectively managing these preferences and ensuring synchronization for millions of users is a complex task that mesibo makes very easy.

mesibo SDK for Python

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

mesibo Python API allows you to add real-time communication to your Python apps.

Supported Platforms

mesibo Pythons APIs are tested on the following platforms.

RedHat 8.x / Rocky Linux 8.5 / CentOS 7.x and 8.x / Oracle Linux 8
Ubuntu 22.04 and 20.04 (should work on Debian too)
Mac OS - both X86_64 and Arm64 (M1) versions
Microsoft Windows 10 and above
Raspberry Pi 3 and 4 (64-bit)

Reading Messages & Call History from Database

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

In this section, we will describe how to read messages from the database.

mesibo provides a set of APIs to read messages and call history stored in the database and sending read receipts. The messages you read will be delivered to Mesibo_onMessage lisetener. You can then use msg.isRealtimeMessage() or msg.isDbMessage() to differentiate between real-time and database message.

To read stored messages from the database, you need to create a read session and set the criteria to read messages; for example,

Mesibo Backend APIs - Scripting and Chatbot Configuration

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

This section describes how to upload and manage scripts for the mesibo scripting and chatbot feature using the Backend APIs. For in-depth details on how to use mesibo scripting and chatbot features, refer to the mesibo Scripting and Chatbot Documentation.

If you are using the mesibo on-premise server, you must use the Backend APIs to upload and manage scripts. This also ensures complete privacy of your scripts.

If you are using the mesibo cloud service, you can use either the Console or the Backend APIs.

Custom TURN Server Configuration

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

Overview

TURN (Traversal Using Relays around NAT) servers enable peer-to-peer communication between users behind firewalls or NAT devices. When direct peer-to-peer connections fail, the TURN server acts as a relay, forwarding media traffic between participants to ensure call connectivity even in restrictive network environments.

mesibo TURN Server

By default, mesibo’s TURN server is enabled for all users, providing reliable call connectivity across various network configurations.

mesibo provides an option to enable or disable the TURN server in User Access Control (UAC), although it is strongly recommended not to disable it as this may prevent calls from connecting in certain network environments.

Blocking and Unblocking Users

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

Blocking and Unblocking APIs allow a user to block and unblock communication with another user.

There are multiple ways a user can block another user. Mesibo Blocking and Unblocking APIs allow you to individually control each type of blocking. Depending on your app, you can block one or multiple aspects of the communication.

Block all messages from a user including text messages, binary messages, file messages, presence, activity, etc. However, if the blocked user sends a message to the group, it will not be blocked.
Block group messages from a user. Other group members will still get the message.
Block voice and video calls
Block video calls
Block profile views. The blocked user will not be able to view the profile and online status of the user.

Mesibo also provides a combined block() API that blocks and unblocks messaging, calls, profile views, and online status views between users in one API call. Alternatively, your app can block individual features like messaging, group messaging, calls, video calls, profile, and online status view as per your application requirements.

mesibo SDK for C++

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

The mesibo C++ API allows you to create a real-time application on Linux, Mac OS, Microsoft Windows, and Raspberry Pi platforms. mesibo C++ API is a low-level API that is extremely powerful, efficient, and light-weight.

mesibo C++ library is available as a shared library libmesibo.so/libmesibo.dylib/mesibo.dll, which can be seamlessly integrated into any application by compile-time linking or by loading it dynamically. You can even use it from other languages of your choice like Python, PHP, Matlab, etc. as all of these languages allow interfacing with C++ libraries.

Creating Groups

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

Group messaging is no different from the one-to-one messaging. You can invoke the same messaging APIs to send a group message, instead of the user’s profile, you need to use group profile.

mesibo allows you to create various types of groups, with different level of permissions for members and admins. You can learn more about it in Group Management APIs documentation.

In this section, we will quickly learn to create a group.

On-Premise Database Tables Schema

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

mesibo On-Premise gives you complete access to your data. All database tables created by mesibo and the data written to them are accessible to you directly in your own database.

The tables and columns listed below are safe to read from. All other tables and columns are used internally by mesibo and may be modified or removed without notice — do not access or depend on them.

Caution

Never write to any table in the mesibo On-Premise database. If you need frequent read access, set up MySQL in a master-slave replication configuration so that reads are served from the replica, keeping load off the primary. Never overload the primary database with analytical or bulk queries.

GoogleCloudService

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

The GoogleCloudService class can be used to connect to various Google Cloud API Services like Google Translate, Dialogflow, GoogleMaps, etc

Constructor

GoogleCloudService()

The constructor initializes the GoogleCloudService class. It must be called before you perform any method calls.

Properties

To connect to a chatbot you can set the following properties for an GoogleCloudService class object.

GoogleCloudService.url

REST URL endpoint of the API

MesiboGroupCall Class Reference

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

MesiboCall.MesiboGroupCall controls various aspects of a group call, like joining and leaving the conference call, playing in-call sound, etc. The following is a list of methods available in the MesiboGroupCall API. The first step in starting a group call is to create a MesiboGroupCall object.

Refer to Conferencing API Documentation to learn more.

Creating an instance of MesiboGroupCall

You can get a group call instance using MesiboCall.groupCall().

Before you make a group call, ensure the following :

Sending Online and Offline Status

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

As described in the Mesibo presence APIs, users can show their Online and Offline status to other users or group members by sending Online and Offline presence. However, modern mobile OSs can suspend or kill your app without notice, and hence your app may not get an opportunity to update other users with the status. Since mesibo API knows when you are online and offline, we recommend leaving this task of sending Online and Offline presence to mesibo. You only need to configure when to show online status and privacy as described in the next section.

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.

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

Mesibo Backend APIs - User Access Control (UAC)

UAC allows you to assign different feature sets to different classes of users instead of managing each user and each feature individually. UAC provides granular controls across messaging, calls, presence, group calls, location, files, and more, enabling you to configure and assign precise capabilities to different user segments in your app. User segments vary by application type, for example:

Social Apps: Free users vs. paid subscribers
Telemedicine: Doctors, patients, administrative staff
Enterprise: HR, managers, employees, contractors
Education: Teachers, students, administrators
Marketplaces: Buyers, sellers, verified merchants

Each segment can be assigned different UAC configurations with specific feature sets tailored to their needs and subscription level. When you need to change feature sets or enhance your app with new capabilities, simply modify the UAC configuration once and it automatically applies to all assigned users, eliminating the need to update each user individually. Similarly, you can instantly change a user’s feature set by switching their assigned UAC. For example, when a free user becomes a paid subscriber, assigning them a different UAC immediately grants them the enhanced feature set without any manual configuration.

Deleting and Recalling Messages

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

mesibo offers a rich set of APIs for deleting, wiping, recalling or editing messages. These APIs can be utilized in various ways depending on your app logic, for example:

Invoking the delete or wipe message API when a user taps to remove a message.
Leveraging the message retraction APIs when a user wants to retract or modify a sent message.
Sending disappearing messages that will be deleted after set intervals.
Scheduling regular cleanup on app start by wiping old, unwanted messages that are no longer relevant.
Deleting messages when user is blocked or unmatched.

There are different types of deletion:

Loadable Modules - Extending the mesibo Platform

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

mesibo On-Premise’s loadable module architecture lets you extend the platform with your own code — intercepting messages, adding custom processing logic, and integrating with any external service or backend. You can build profanity filters, message translators, AI-powered chatbots connected to LLMs or services like Dialogflow, vector database lookups, IoT and robotics control systems, analytics pipelines, and more. All of this runs inside your own infrastructure with full control over your data.

mesibo SDK for Linux

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

Mesibo on Linux is available as a shared library(.so) which allows you to use it from any application OR languages of your choice like C, C++, Python, PHP, Matlab, Octave etc.

OS requirements

mesibo Linux API are tested on the following platforms.

RedHat 8.x / Rocky Linux 8.5 / CentOS 7.x and 8.x / Oracle Linux 8
Ubuntu 22.04 and 20.04 (should work on Debian and mint too)

mesibo APIs should work on other Linux platform too as it has minimum system dependencies. However, send us an email if your platform is not supported.

MesiboParticipant Class Reference

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

The following is a list of methods available in the MesiboParticipant class.

You MUST not directly create an instance of MesiboParticipant. You will get a new MesiboParticipant object:

When you create a publisher using GroupCall.createPublisher()
Or through listeners, MesiboGroupcall_OnPublisher and MesiboGroupcall_OnSubscriber

Refer to Conferencing API Documentation to learn more.

Call Functions

The following methods handle the call to a participant

call

The call() method takes the following parameters:

audio, true if you would like to receive the audio stream, false otherwise
video, true if you would like to receive the video stream, false otherwise
groupCallInProgressListener, An instance of GroupCallInProgressListener

For example, in Android, if you would like to have both audio and video while viewing a publisher, make a call as follows

Mesibo Backend APIs - Hosting Backend APIs

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

If you are using mesibo on-premise, mesibo (and mesibo console) will NOT have any access to your on-premise setup or database. Hence, there are only limited operations (useradd, userset, and usertoken) you can perform with mesibo hosted backend API when using on-premise. For all other operations like group management or sending messages, you will need to use real-time APIs, for example, real-time group APIs.

Alternatively (though OPTIONAL), you can host entire backend APIs to your own server. This will enable you to access entire backend APIs while using mesibo on-premise. Even if you are not using backend APIs for group management or sending messages, it is highly recommended that you enable and use backend APIs bundled with mesibo docker image as it will update your database instantly and also give you access to additionals ops like usersget, groupsget, etc.

Utility functions

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

mesibo provides a set of utilities for generating a random number, hashing, etc.

random32()

Returns a 32-bit psuedo-random number.

Syntax

random32()

Parameters

None.

Return value

unsigned 32-bit integer

random64()

Returns a 64-bit psuedo-random number.

Syntax

random64()

Parameters

None.

Return value

unsigned 64-bit integer

hash64()

Returns a hash of the input.

Syntax

hash64()

Parameters

Any valid object

Video and Voice Calls

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

mesibo allows you to enable peer-to-peer HD video and voice calls between your users in just a few lines of code. As with messaging, mesibo video and voice calls are end-to-end encrypted and hence secure. mesibo does not charge any additional amount for the voice or video call APIs.

Making and receiving voice & video calls with mesibo is simple. You only need to initialize MesiboCall once using just one line of code! Then, mesibo will automatically handle incoming calls. For outgoing calls, you can invoke call API as required.

Disappearing Messages

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

The disappearing feature allows the sender to control how long the receiver can view or store the received messages, after which the message will be deleted on both the sender and the receiver side.

You can use this feature on a per-message basis to control which messages should disappear and which messages should not.

Mesibo gives you fine control over how and when a message should disappear by setting Age. You can set three types of Age (time interval) after which the message will disappear. Depending on your app logic, you can use one or all three-time intervals.

mesibo SDK for macOS

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

mesibo on macOS is available as a dynamic library (.dylib) which allows you to use it from any application OR languages of your choice like C, C++, Python, PHP, Matlab, Octave etc.

OS requirements

macOS (both Apple Silicon M1/M2/M3 etc, and Intel)

Install using the convenience script

mesibo provides a convenience script for installing mesibo on all the supported platforms.

$ curl -fsSL https://raw.githubusercontent.com/mesibo/libmesibo/master/install.sh | sudo bash -

Please note the following points:

Video and Voice Conferencing (Group Calls)

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

In this section, we will quickly learn how to add Video and Voice Conferencing (group calling) to your apps, in just one line of code.

For detailed documentation and examples for conferencing refer to Mesibo Conferencing Docs and download the example source code for conferencing from GitHub

To add mesibo Group Calling to your app, you only need to initialize MesiboCall once using just one line of code. This you would have already done in the previous section.

Hosting Media and Files

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

In this part, we will describe how to host media and files on your server instead of the mesibo file server.

Hosting Media and Files on Your Server

As we learned before, mesibo allows you to send and receive any arbitrary file (image, audio, video, doc, etc) in real-time.

By default, all media and files you send are stored on the mesibo file server. However most mesibo users, especially those having sensitive data (financial institutes, healthcare, dating, etc.) prefer to store files on their servers. We highly recommend that you should use the mesibo server only for initial development and use your own servers for deployment.

Retracting or Modifying Sent Messages

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

Message retraction APIs allow users to modify or delete the sent messages. For example, to correct typos or to remove messages they didn’t mean to send.

You can enable or disable different retraction features by specifying retraction policies. You can also configure the max time limit for message retraction. Any messages that are older than the retraction time limit will not be retracted. The default retraction time limit is 3600 seconds which can be set from 1 second to any arbitrarily large value. You can also set various retraction policies that we will cover later in this document.

mesibo SDK for Windows

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

Mesibo on Microsoft Windows is available as a dynamic link library (.dll) which allows you to use it from any application OR languages of your choice like C, C++, Python, PHP, Matlab, Octave etc.

OS requirements

Microsoft Windows 10 and above (64-bit)

Download from GitHub

You can download header file and DLL for Microsoft Windows (and other platforms) from mesibo GitHub repository:

git clone git@github.com:mesibo/libmesibo.git

Multi-Device Synchronization

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

In this part, we will learn about synchronizing messages and user data on multiple devices with mesibo.

Note, to use the synchronization feature, you need to use the mesibo On-Premise, which allows you to store all the messages in your data center.

Prerequisites

You MUST go through the following prerequisites before you read further.

Familiar with reading messages.
Run mesibo On-Premise. See On-Premise Docs for installation instructions and more.

Multi-Device Synchronization

mesibo stores your app’s messages on the server till they are delivered. Once the app receives messages, they are stored on the local device database so that your app can quickly access them later (both when online and offline). This is a very optimal approach used by many popular and high user density apps like Whatsapp.

mesibo SDK for Raspberry Pi

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

Instantly add real-time communication on your embedded devices by using mesibo. You can control and communicate with your Raspberry Pi based devices from mobile apps, web, Linux, using the same API.

Mesibo on Raspberry Pi is available as a shared library(.so) which allows you to use it from any application OR languages of your choice like C, C++, Python, PHP, etc. You can also use mesibo Python APIs for Raspberry Pi.

Restricting Communication Audience Per User

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

By default, your mesibo users will be able to communicate with all the users of your apps. In addition, all the users can send and receive messages, make calls, create groups, etc. However, if you prefer, you can restrict how your app users communicate and with whom they can communicate.

For example, in a dating or a social app, you may allow two users to communicate with each other only if they match, not otherwise. In addition, you need to break the communication link if they unmatch. You may even configure users to allow messaging but not calls unless they are premium users.

Chat / Messaging / Video Call App Source Code for Android, iOS and Web

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

Mesibo Messenger is an open-source app with real-time messaging, voice, and video call & conferencing features. We have released the entire source code of Mesibo Android, iOS, and JavaScript Apps on GitHub that you can download, customize, rebrand, and reuse in your own mesibo based applications without any restrictions.

Some of the Key Features

Secure One-on-one messaging and Group chat
High-quality voice and video calling
Video and Voice Conferencing and Group Calls
Rich messaging (text, picture, video, audio, location, other files)
Message status and typing indicators
Online status (presence) and real-time profile update
Push notifications
etc.

Mesibo Android App Source Code (Java and Kotlin)

https://github.com/mesibo/messenger-app-android/

Multi-Device Login and Synchronization

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

As more and more users use multiple devices, it is an absolute necessity for all apps to support multi-device login and synchronization to maintain a consistent and smooth user experience across all their devices.

mesibo offers the capability for users to sign in from multiple devices. Users have the option to log in from up to eight devices simultaneously. All their data, including messages, calls, profiles, images, files, etc. will be automatically synchronized across all their devices.

How mesibo SDKs are versioned

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

mesibo follows Semantic Versioning. This document explains the version number scheme for mesibo release and beta SDKs.

Release Versions

Each mesibo release SDK has a version number defined as MAJOR.MINOR.PATCH, for example 2.2.7, in which:

MAJOR version is incremented for major API changes
MINOR version is incremented when new features/functionality are added
PATCH version is incremented for bug fixes or minor updates

Beta Versions

Beta versions are not published and offered to mesibo users only as needed in response to support tickets.

Log in and Synchronization Across Browser Tabs and Windows [Web Only]

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

Similar to multi-device login and syncronization described in the previous section, you can also enable your users to log in from multiple browser windows and tabs. All the messages and calls will be synchronized between all browser windows and tabs. This feature is quite useful when you want your users to continue chatting even when they open another page of your website in a new tab, for example, Facebook pop-out chat.

Managing User Devices and Browser Tabs

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

Your users might use multiple devices simultaneously or switch devices. Depending on your use case, your app should display all messages and calls from all devices. mesibo provides multiple APIs depending on your use case. Below are the use cases:

Syncing on Multiple Devices Simultaneously

mesibo offers the capability for users to sign in from multiple devices. Users can log in from up to eight devices simultaneously. All their data, including messages, calls, profiles, images, files, etc., will be automatically synchronized across all their devices.

Messaging APIs - Content Moderation and Filtering Messages

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

mesibo allows you to filter both incoming and outgoing messages as per the content moderation policy of your app, for example, profanity, personal details, URLs, file type, size, etc. It is up to you to decide what is inappropriate for your app.

You can filter each incoming or outgoing message by implementing the Mesibo_onMessageFilter listener. The mesibo APIs will call your Mesibo_onMessageFilter listener every time a new real-time message is received or sent. You can return true to pass the message or false to drop the message.

Mesibo HTTP Library for Android, iOS, Linux, Mac

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

Introduction

Mesibo HTTP is a light but fast and powerful http client library compliant with RFC 7230-7235, 1738, 2046. It is an extension of mesibo real-time Client APIs.

Mesibo HTTP not only makes networking easier, but also makes it faster, and cross-platform (Android, iOS). It lets you control almost all aspects of the HTTP protocol giving you finer control over HTTP requests.

While there are some good HTTP libraries such as Volley for Android and AFNetworking for iOS, mesibo has the distinct advantage of being cross platform by offering the same APIs across platforms thus eliminating the need to use different libraries for different platforms. mesibo HTTP also performed faster in a benchmark test and has the smaller memory footprint.

Messaging APIs - Generating URL Preview

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

When you send a URL link as part of the message text or set URL using the setContent() API, the mesibo can generate a rich URL preview with a title, description, thumbnail image, etc. before sending it. This feature allows users to share links including tweets, Instagram posts, YouTube videos, news articles, etc with a preview so that the recipient knows about the link before opening it.

To generate a URL preview, mesibo needs to open the website, download the content and then generate a preview from it. Depending on the network speed, the process may take small time, often unnoticeable.

Messaging APIs - Date and Time of Message and Message Status

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

This section describes mesibo APIs to access various timestamps associated with a message, for exammple, when message was sent, delivered or read, and how to format the timestamp in human readable date and time representations.

The mesibo time and date API provides MesiboDateTime object, which store timestamps in milliseconds. The MesiboDateTime object offers access to various date and time components, such as year, month, day, hour, minute, second, and more. It also provides convenient functions for converting timestamps into human-readable date and time strings.

Messaging APIs - Setting Default Parameters

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

Mesibo sets various default parameters when you create a MesiboMessage object. You can override those defaults by providing your own parameters which will be used as default, for example, message expiry, type, link preview, emojify, etc.

Setting Default Parameters

To set default parameters, you only need to create a MesiboMessage object with parameters of your choice and then set it as default by calling MesiboMessage.setDefaults() static method.

MesiboMessage defaults = new MesiboMessage();
defaults.expiry = 3600*24*30;
defaults.emojify = false;
MesiboMessage.setDefaults(defaults);

Once you set defaults, all future MesiboMessage objects created by the following methods will have default parameters copied from the default you have set.

Mesibo - Other Messaging Functions

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

In this reference section, we will describe MesiboMessage class functions that are not covered elsewhere or for general use.

Message Status Functions

function	Description
isIncoming()	returns true if the message was received (incoming)
isOutgoing()	returns true if the Message was sent or being sent (outgoing)
isInOutbox()	returns true if the message is being sent
isSent()	returns true if the message is sent but not delivered yet
isDelivered()	returns true if the message is delivered but not read yet
isReadByPeer()	returns true if the message was delivered and read
isReadByUs()	returns true if the incoming message was read
isUnread()	returns true if the incoming message is unread
isCustom()	returns true if the message is the custom message saved locally (not incoming or outgoing)
isUnread()	returns true if the incoming message is unread

Mesibo Messaging Properties

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

In this reference section, we will describe various message properties you can set for outgoing messages and also properties you can view from any incoming or outgoing messages.

Message Content Properties

Following are the actual message content properties that you can set when sending a message. In addition, you can add a file or media using setContent() function.

Property	Description	Default
data	Binary Data Message	null
message	Text Message	null
title	Message Title	null
subtitle	Message Subtitle	null
footer	Message Footer	null
latitude	Location - Latitude	-720 (out of range)
longitude	Location - Longitude	-720 (out of range)

Messaging Endpoint Properties

Following are some of the protocol-level properties which describe the message ID, type, timestamp, remote peer, and group.

Easy documentation with Docsy

Tue, 10 Feb 2026 00:00:00 +0000

This is a typical blog post that includes images.

The front matter specifies the date of the blog post, its title, a short description that will be displayed on the blog landing page, and its author.

Including images

Here’s an image that includes a byline and a caption.

Image cropped to 500x300
Photo by Peter Xie from Pexels

The front matter of this post specifies properties to be assigned to all image resources:

Second blog post

Tue, 06 Jan 2026 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Another Great Release

Thu, 04 Jan 2018 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

Example Page

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. Replace it with your own content.

Text can be bold, italic, or ~~strikethrough~~. Links should be blue with no underlines (unless hovered over).

There should be whitespace between paragraphs. Vape migas chillwave sriracha poutine try-hard distillery. Tattooed shabby chic small batch, pabst art party heirloom letterpress air plant pop-up. Sustainable chia skateboard art party banjo cardigan normcore affogato vexillologist quinoa meggings man bun master cleanse shoreditch readymade. Yuccie prism four dollar toast tbh cardigan iPhone, tumblr listicle live-edge VHS. Pug lyft normcore hot chicken biodiesel, actually keffiyeh thundercats photo booth pour-over twee fam food truck microdosing banh mi. Vice activated charcoal raclette unicorn live-edge post-ironic. Heirloom vexillologist coloring book, beard deep v letterpress echo park humblebrag tilde.

Parameter Reference

Thu, 05 Jan 2017 00:00:00 +0000

This is a placeholder page. For an example of the kind of content that can be added here, see the example page.

Welcome!

What is Docsy?

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

In this part, we will explore the {{page.platform}} Conferencing app.

Let’s get started.

Prerequisites

Before we dive into running a fully featured Conference app for {{page.platform}}, ensure that you go through the following

Must read the first part of this tutorial and Prerequisites mentioned there. {{prerequisites}}

Before we get into the code, we recommend that you build the app and try it out, to have a feel of how the app works. This is a basic conferencing app with all the essential features. You can easily refer to the source code and the documentation, to modify it to your needs.

Building the Open-Source Conferencing App for Android

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

Downloaded the Source Code for the Android App
Gone through the Quick Start with Mesibo Conferencing API - Android and have a basic familiarity with mesibo conferencing APIs.
Android Studio Installed
An Android Device to run the app

Build Instructions

Building the code is as simple as:

Launch Android Studio
Open the project android/java/MesiboConference from the folder where you have downloaded the code using the menu File -> Open
Build using menu Build -> Rebuild Project
It may take a while to build the project for the first time.
Once the build is over, run on the device using the menu Run -> Run (app)
That’s it, you should see the welcome screen and then the login screen.

Refer to the source code here for an example on invoking the login REST API.

Building the Open-Source Conferencing App for iOS

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

Downloaded the Source Code for the iOS App
Gone through the Quick Start with Mesibo Conferencing API - iOS and have a basic familiarity with mesibo conferencing APIs..
XCode Installed
An iPhone Device to run the app

Build Instructions

Building the code is as simple as:

Launch Xcode
Open the project ios/MesiboConference from the folder where you have downloaded the code using the menu File -> Open
Build using menu Product -> Build
It may take a while to build the project for the first time.
Once the build is over, run on the device using the menu Product -> Run
That’s it, you should see the welcome screen like below and then the login screen.

If you receive linker errors

If you receive linker errors, it means that your download was incomplete. One of the likely reasons is that you forgot to issue git lfs install. There are two ways to fix it:

Building the Open-Source Conferencing App for Javascript

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

Downloaded the Source Code for the Javascript App
Gone through the Quick Start with Mesibo Conferencing API - Javascript and have a basic familiarity with mesibo conferencing APIs. .
A webserver with HTTPS support to host the Web App.

Hosting the App

Running the web app is as simple as:

Open the folder web/live-demo
Serve this folder securely(*requires HTTPS)
Open index.html in your web browser
That’s it! You should now see the login page

Invoke the login REST API as follows. Refer to the source code in login.js.

Conclusion

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

Congratulations!

You’ve created a fully functional Zoom like Conferencing app. Visit our FAQ Page if you have any questions.

Frequently Asked Questions - Other

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

Get Started | UI Modules

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

In this part, we will cover how to use mesibo in your UI apps and mesibo UI modules.

Prerequisites

Read the First App Guide.
Read one of the Android, iOS, JS section of this tutorial.
Install Mesibo UI Modules by following Instructions for Android and Instructions for iOS

Ready to use UI Modules

Mesibo provides a variety of pre-built UI components that allow you to quickly add messaging, voice & video call graphical user interface in your app. Mesibo UI modules are completely customizable. You can not only customize colors, icons, etc but also customize how each message is rendered. This enables you to create powerful chatbots in no-time.

Get Started | User Authentication in your App

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

A typical first step in every app is user authentication. This generally involves a login form where users enter their credentials. Note that mesibo does not recommend or enforce any particular authentication method. You can use any authentication mechanism suitable to your app, for example, email, phone, user-id, LDAP, RADIUS, OAuth2, Kerberos, SAML, fingerprint, etc. All you need to do is to generate a mesibo access token for the user only after your user passed your authentication.

Loadable Modules - add your own custom features to Mesibo

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

Imagine, if you could have the ability to process every message between your users, or could add custom features and functionalities. For example, create chatbots, filter profanity, translate messages between sender and recipient, analyze messages with machine learning and AI tools, and more. This can open up a plethora of creative possibilities for your apps. Now with mesibo modules, all of this is possible!.

Mesibo is designed “by Developers for Developers!”. As developers, we understand that a platform is very limited unless it allows its users to build more features and functionalities on it. This is how Mesibo loadable modules come in.

mesibo API documentation

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

Goldydocs provides a single web UI providing visibility into porridge temperature, chair size, and bed softness metrics! You can even find out who’s been eating your porridge.

mesibo Backend API Playground

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

mesibo Backend API Playground

This is an interactive playground for trying out REST based mesibo Backend APIs. You can administer your account, manage apps, manage users and groups etc using backend APIs. Refer to Backend API Documentation to know more.

Mesibo Backend APIs - Group Management

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

mesibo allows you to create groups having a set of users as group members. Once you create a group, you can send messages to the group, and all the group members will receive the messages.

Unless you have a specific need for creating groups using backend API, we recommend using real-time Group Management APIs to create groups and adding members. It is real-time, powerful, and works across both cloud and on-premise deployment without any changes.

Mesibo End-to-End Encryption APIs

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

mesibo end-to-end algorithm is an improvement over existing protocol, namely OTR, Silent_Circle_Instant_Messaging_Protocol, and Open Whisper System (used by WhatsApp, Signal, etc).

improvements

third party man in middle elimination
improved rachet algoruthm in terms of
efficency in key generation
imprioved ephernal keys for out of order packets.
assymetrical key generation where receiver dicates how sender generates key, while maintaining systmmetric cipher
indentiy update
does not maintain centralize key directory
configurable level of strength, same, more, or lower than other algorithm. As an appl developers, you can decide the strength (banking vs dating vs casual chat) depending on bandwidth and cpu usage

Mesibo Open Source Chat, Voice and Video Calls UI Modules

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

mesibo provides a variety of pre-built open-source UI components that allow you to quickly add messaging, voice & video calls, and conferencing graphical user interface in your app in just a few lines of code. mesibo UI components are optional and provided to aid in the app development process. You can completely design your own UI components using mesibo core APIs.

{:width=“225px”}| {:width=“225px”} | {:width=“225px”}

Mesibo Open Source Chat, Voice and Video Calls UI Modules

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

{:width=“225px”}| {:width=“225px”} | {:width=“225px”}

Mesibo Profile APIs - Listeners

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

There are two types of listeners in the mesibo Profile API:

UserProfileListener The global profile listener
UserProfile.Listener Per UserProfile listener.

UserProfileListener

Your app must implement the UserProfileListener to be notified of global profile events. The following global listeners are available through the UserProfileListener interface:

Mesibo_onUserProfileUpdated, called when a profile that you have subscribed to is updated globally. Also called when you request for a profile using getProfile
Mesibo_onUserProfileAccess, called when your app wants to access a profile. You can make modifications to the profile object here as per your local context. For example, if you are syncing profiles of contacts on your phone, you may change the name on a user’s profile as per your local address book.

Mesibo Real-time Chat APIs - Messaging

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

In this section, we will describe how to send messages.

Basic Usage

To send messages, you only need to create a MesiboMessage object for the destination, add your content (text message, files, location, etc.), set message properties if requires, and call send method. You can create a MesiboMessage object by calling

Create

MesiboMessage message = profile.newMessage();

OR,

MesiboMessage message = new MesiboMessage(profile);

where the profile is the user or group profile to whom you want to send a message. Once you create a MesiboMessage object, all you need to do is to add your message content and call send(). There is no difference between how you send messages to an individual user or a group, the destination is set based on the profile you have used to create MesiboMessage.

Mesibo real-time webhooks

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

Webhooks allow you to monitor your app and users in real-time by getting updates from the mesibo cloud or on-premise server, as it happens.

You can select events you are interested in, say, for example, an offline message, a user comes online, goes offline, billings, etc. You also need to provide an URL in the mesibo console that will be invoked with POST data in real-time by Mesibo when such events happen.

MesiboProfile

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

MesiboProfile/MesiboSelfProfile methods

The following methods are available in the MesiboProfile class to access and modify a profile. MesiboSelfProfile is a derived class of MesiboProfile.

toggleArchive

Enable or disable whether a profile is to be archived.

mMesiboProfile.toggleArchive();

isArchieved

Returns true if profile is archieved, false otherwise.

mMesiboProfile.isArchieved();

toggleMute

Enable or disable profile updates. If you mute, you will not be notified when that profile is updated.

Mesibo Voice & Video Call API - MesiboVideoView

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

MesiboVideoView is a UI Component available in Android & iOS, that you need to use for displaying a video in One-to-One Video-Calls, Conferencing(Group Video Calls), etc.

For example, in Android, you can have a MesiboVideoView element like below:

<com.mesibo.calls.api.MesiboVideoView
 android:id="@+id/my_video"
 android:layout_width="match_parent"
 android:layout_height="match_parent"/>

and get the MesiboVideoView object like below:

MesiboVideoView videoView = findViewById(R.id.participant_stream_view);

In Javascript, MesiboVideoView is not available. You can simply use the HTML <video> player.

MesiboVideoView extends View in Android and UIView in iOS. So, in addition to methods and properties in View or UIView, MesiboVideoView has the following methods:

Real-time Chat APIs - Utility

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

Following are some of the utility APIs which you can use in your apps. Ensure that you have the necessary permissions from the app users to use these APIs.

Networking, Timings and other Utility APIs

getNetworkConnectivity [Android and iOS only]

Returns current network connectivity. It can be one of the following

CONNECTIVITY_UNKNOWN
CONNECTIVITY_DISCONNECTED
CONNECTIVITY_WIFI
CONNECTIVITY_2G
CONNECTIVITY_3G
CONNECTIVITY_4G

getTimestamp

Returns current timestamp in milliseconds.

It does not take any parameters.

Search Results

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

Setting up the Admin API

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

In previous sections, we have implemented conferencing apps for Android, iOS, and Web. In all these apps, we have used the Admin API which is already hosted at https://app.mesibo.com/conf/api.php so that you can quickly play with the apps without worrying about the backend. Now in this part, we will describe how to host the Admin API backend on your servers/infrastructure and having complete control over your conference participants, the resolution of the room, who are allowed to publish or view streams in the conference, etc.

Using Mesibo UI Modules for Android - Messaging

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

Mesibo offers ready to use UI components which you can quickly add to your applications. Mesibo UI components are completely customizable as per your needs. On Android, Mesibo UI components are available as Fragments.

There are primarily two types of Mesibo UI components:

MesiboUserListFragment, which displays a list of users in different modes. The modes are explained below.
MesiboMessagingFragment, which renders all the messages for a particular user or a group

mesibo documentation

mesibo documentation

Frequently Asked Questions - General

Bed and Chair Metrics

Welcome!

What is Docsy?

Configuring Ponycopters

Welcome!

What is Docsy?

Frequently Asked Questions - Messaging

Examples

Launching Ponycopters

Welcome!

What is Docsy?

Frequently Asked Questions - Group Messaging

Multi-Bear Domicile Setup

Welcome!

What is Docsy?

Porridge Assessment

Welcome!

What is Docsy?

Concepts

Frequently Asked Questions - Video and Voice Calls

Another Tutorial

Welcome!

What is Docsy?

Frequently Asked Questions - Message and File Storage

Frequently Asked Questions - Demo Apps

Frequently Asked Questions - HTTP Library

Frequently Asked Questions - API

Frequently Asked Questions - Platform

Accessing and Subscribing to Locations

mesibo SDK for Android

Install Mesibo Core SDK

Build and Run Open Source Messenger

Downloading the Source Code

Call Listeners

Configure FCM and APN Push notification Credentials in mesibo Console

Mesibo Connection Monitoring

Contribution Guidelines

Create a Conference Room

Creating User Access Tokens

Mesibo Group Management - Creating a Group

Mesibo End-to-End Encryption APIs

MesiboEndToEndEncryption

MesiboEndToEndEncryption

Mesibo Real-time APIs - File Transfer and Hosting

Overview

mesibo On-Premise Local Configuration

Creating the Configuration File

Step 1 - Create the Configuration Directory

Mesibo Chatbot and Scripting - Mesibo Object

Constructor

Properties

Mesibo.onmessage mandatory

Mesibo Open Source Chat, Voice and Video Calls UI Modules

Messaging Screen

Frequently Asked Questions - On-Premise Deployment

Publishing a Profile and Controlling Profile Privacy

Uploading and Configuring Scripts

Mesibo Backend APIs - User Management

Mesibo Release v2.4

Key Highlights

Flexible Profile Schema

Mesibo Phone Contacts Validation and Formatting

Frequently Asked Questions - Pricing, customization and terms

Frequently Asked Questions - SDK

Frequently Asked Questions - Webhooks and Push Notifications

Frequently Asked Questions - Security and Privacy

Frequently Asked Questions - UI Modules

Frequently Asked Questions - Other

Frequently Asked Questions - Support

Frequently Asked Questions - Chatbot and Scripting

Frequently Asked Questions - Voice and Video Conferencing

Mesibo Backup and Data Migration APIs

Configure Tokens and Run Sample App

Step 1: Set Up mesibo Listeners

Customization and Rebranding Android, iOS and Web Messenger

Mesibo End-to-End Encryption - Cryptography APIs

Setting Supported and Preferred Ciphers

Mesibo.onmessage _mandatory

Message.aid _read-only