Mesibo Phone Contacts Validation and Formatting

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.

Here is an example of how to use it:

MesiboPhoneContacts contact = phoneManager.getPhoneNumberInfo(phoneNumber, true);

// access phone information if the phone number is valid
if(contact.valid) {
    int type = contact.type; // Type of phone number (mobile, landline, etc)
    String name = contact.name; // Name from the phone book
    String phoneNumber = contact.phoneNumber; // validated and corrected phone number
    String country = country.country; //Country name
    ...
}

getPhoneNumberInfo function

The getPhoneNumberInfo function can be used in the following ways:

MesiboPhoneContact getPhoneNumberInfo(String phoneNumber);
MesiboPhoneContact getPhoneNumberInfo(String phoneNumber, boolean format);
MesiboPhoneContact getPhoneNumberInfo(String phoneNumber, String countryCode, boolean format);

getPhoneNumberInfo takes the following parameters:

For example,

MesiboPhoneContacts contact = phoneManager.getPhoneNumberInfo(phoneNumber, "MX", true);

or

MesiboPhoneContacts contact = phoneManager.getPhoneNumberInfo(phoneNumber, "1", true);

MesiboPhoneContact class members

Following are the members of the MesiboPhoneContact class. Note that, fields may not be populated if the phone number is not valid.

Setting Country Code

The mesibo phone contact API uses multiple algorithms to detect the country code on mobiles with high accuracy. You can further improve accuracy by providing the user's phone country code (e.g. 1 for USA and Canada, 65 for Singapore).

For example, using country phone code:

MesiboPhoneContacts country = phoneManager.setCountryCode("1");

or, by using country iso code

MesiboPhoneContacts country = phoneManager.setCountryCode("SG");

Alternatively, you can use the user's phone number to set the country code. mesibo extracts the country code automatically:

MesiboPhoneContacts country = phoneManager.setCountryCodeFromPhoneNumber("18005551234");

or,

MesiboPhoneContacts country = phoneManager.setCountryCodeFromPhoneNumber("8005551234", "US");

All the above functions return MesiboPhoneContacts which you can examine to know the details of the country set.

It is important to note that inferring the country code from ISO country code, device locale, timezone, etc., is not always reliable. On Android, mesibo uses the SIM mobile country code (MCC) as one of the methods to detect the country code, but this capability is no longer available on iOS.

Phone number validation options

You can configure phone number validation by calling these functions:

phoneManager.ignoreInvalidCharacters(true);

The complete list of functions are below:

In the next section, we will describe phone contact monitoring and synchronization.