An in-depth guide on how to configure CometChat.

Get your Application Keys

Signup for CometChat and then:

  1. Create a new app on the dashboard



Please follow the key concepts guide to create V3 apps

  1. Head over to the API & Auth Keys section and note the Auth Key, App ID & Region

Add the CometChat Dependency

Install the package as NPM module:

npm install @cometchat-pro/[email protected] --save



v2.4+ onwards, Voice & Video Calling functionality has been moved to a separate library. In case you plan to use the calling feature, please install the Calling dependency (@cometchat-pro/ionic-calls).

npm install @cometchat-pro/[email protected] --save

The calling component requires some configuration. Please follow the steps mentioned here.



The Calling Component (@cometchat-pro/ionic-calls) is a capacitor plugin so it won't work in a Cordova project.

Calling Component Configuration


Goto ./android folder and open project-level build Gradle file and add all repository URLs in the repositories block under the allprojects section.

allprojects {
  repositories {
    maven {
            url ""

You also need to update the minimum SDK version to 24. You can update the minSDKVersion in the variables.gradle file located in the android folder.

minSdkVersion = 24

In the main activity, you need to map the Capacitor class:

package io.ionic.starter;

import android.os.Bundle;

import com.cometchat.calling.Calling; // Add this line
import com.getcapacitor.BridgeActivity;
import com.getcapacitor.Plugin;

import java.util.ArrayList;

public class MainActivity extends BridgeActivity {
  public void onCreate(Bundle savedInstanceState) {

    this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
      add(Calling.class); // Add this line


Please update the minimum target version in the Podfile. Goto ./ios folder and open the Podfile. In the Podfile update the platform version to 11.0.

platform :ios, '11.0'

Open the ios/App folder and run pod install this will create an App.xcworkspace open this and run the app.

Initialize CometChat

The init() method initialises the settings required for CometChat.

The init() method takes the below parameters:

  1. APP_ID - Your CometChat App ID
  2. appSettings - An object of the AppSettings class can be created using the AppSettingsBuilder class. The region field is mandatory and can be set using the setRegion() method.

The AppSettings class allows you to configure two settings:
a. Region of the App: The Region code for the app. (For example, eu for Europe and us for the United State)
b. Presence Subscription.

You need to call init() before calling any other method from CometChat.

var appId = "APP_ID";
let cometChatSettings = new CometChat.AppSettingsBuilder().subscribePresenceForAllUsers().setRegion('us').build();
      () => {
        console.log("Initialization completed successfully");
        //You can now call login function.
       error => {
        console.log("Initialization failed with error:", error);
        //Check the reason for error and take apppropriate action.




CometChat App ID


An object of the AppSettings class.

Did this page help you?