Get Started with mesibo on mesibo documentation

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.

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.

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.

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.

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,

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.

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.

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.

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.

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.

Get Started with mesibo on mesibo documentation

Creating User Access Tokens

Configure Tokens and Run Sample App

Step 1: Set Up mesibo Listeners

Users and Groups

Sending and Receiving Messages

Sending Messages

Reading Messages & Call History from Database

Creating Groups

Video and Voice Calls

Video and Voice Conferencing (Group Calls)

Hosting Media and Files

Hosting Media and Files on Your Server

Multi-Device Synchronization

Prerequisites

Multi-Device Synchronization

Other Topics

Get Started | UI Modules

Prerequisites

Ready to use UI Modules

Get Started | User Authentication in your App