Create an App

Introduction 

The low-code Connected Apps platform allows you to connect seamlessly to an existing tool in your MarTech stack by creating a new MoEngage channel on the fly. 

Step 1: Create a Connected App

Perform the following steps to create a Connected App:

  1. On the left navigation menu in the MoEngage dashboard, click App marketplace.
  2. On the App marketplace page, click + Create app.Screenshot 2024-11-13 at 2.09.03 PM.png
  3. On the Create app dialog box, enter the following details:
    Field Description

    App name

    Type your App Name.

    App type

    Click Channel and then click Create.

    Screenshot 2024-11-13 at 2.07.07 PM.png
    This will add your Connected App as a Connected Channel in MoEngage. You are directed to the Connected App page.
    Screenshot 2024-11-14 at 9.35.46 PM.png

Step 2: Add a Channel Connector 

After creating a new Connected Channel, you must define the use cases for the channels. These use cases help you define how MoEngage will run and analyze campaigns for the App.

Refer to the following examples to understand the use cases: 

Channels  Connectors (Use Cases) 

Retargeting Apps

(TikTok, Snapchat, LinkedIn, and so on)

  • Connector 1: Add users to the audience.
  • Connector 2: Remove users from the audience.

Messaging Apps 

(Telegram, Line, Viber, WeChat, and so on)

  • Connector 1: Send SMS to users.
  • Connector 2: Send MMS to users.
  • Connector 3: Send a message to a group.
  • Connector 4: Send a message to a community.

Support tools

(Zendesk, Freshdesk, and so on)

  • Connector 1: Create a new ticket.
  • Connector 2: Close a ticket.
  • Connector 3: Update an existing ticket.

After you are ready with your use cases, you can add these Connectors to your App.

Step 2.1: Create a Config File

Every Connector needs a config to be used as a blueprint to instruct MoEngage to interact with the app. For more information on creating your config file for your connector, refer to the Channel Connector Config Guide here.

Step 2.2: Add a New Connector

After the config file is ready, perform the following steps to create a connector for your channel:

  1. On the Connected App page, click the Configure tab, and then click + Add configuration.
  2. In the Upload config section, upload the config file (.json) created in step 2.1. If the upload is successful, proceed to the next step. Screenshot 2024-11-14 at 9.49.31 PM.png
  3. Click Add. Screenshot 2024-11-14 at 9.58.30 PM.png

The Channel Connector is successfully added. It is ready to be integrated and used in campaigns.

info

Information

Click + Add configuration to add multiple connectors.

Edit the connector config 

If there are any issues with the earlier config, replace it with a new file.

  1. In the Upload config section, click the ellipse icon (Screenshot 2024-11-14 at 10.07.30 PM.png).
  2. Click Edit.
  3. Click the cross icon. 
  4. Repeat the steps mentioned in step 2.2 to add the new config. Screenshot 2024-11-13 at 3.52.29 PM.png
warning

Warning

Your existing campaigns will continue showing older fields and associated metrics. Changing your connectors while running campaigns is not recommended because this can lead to inconsistent behavior.

Step 3: Integrate a Connected Channel 

After adding a Channel Connector to your app, you must integrate your Connected Channel with MoEngage to use in your campaigns.

  1. On the Connected App page, click the Integrate tab, and then click + Add integration.
  2. In the Connection details section, enter the following details:
    Term Description
    Connection name

    It is the readable name that can be used to identify the connector while creating campaigns.

    Additional fields

    These would be available only if you have defined any other input fields in your connector config. Enter the details in these fields accordingly.

    Screenshot 2024-11-14 at 10.51.07 PM.png
  3. Click Connect. You have successfully integrated your Channel App with MoEngage. Screenshot 2024-11-14 at 2.37.13 PM.png
info

Information

You can add multiple integrations by clicking + Add integration.

Step 4: Run Campaigns 

After integrating your Connected Channel with MoEngage, you can run MoEngage campaigns. Follow the steps here to create a Connected App Campaign and analyze their performance.

Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?