# MoEngage

### MoEngage Integration Guide

1. Click on the Integrations in the left navigation Pane of Gallabox. Hover on MoEngage from the Available apps and click on the Connect Button.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FKJmY22O2FgSWlbTJu9vz%2FMoengage_Integration.png?alt=media&#x26;token=389b46de-1f5c-4a23-a00f-38715df477a9" alt=""><figcaption><p>MoEngage in Gallabox Integration</p></figcaption></figure>

2. MoEngage Integration window will open and you have to type in the Integration Name and click on connect.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FNE3duRmi7SSNIlK8cOKA%2FME%201.2.png?alt=media&#x26;token=eddadaa3-9264-4a48-bcef-737caead5de3" alt=""><figcaption><p>Integration MoEngage</p></figcaption></figure>

3. You will be redirected to Configuration Page of MoEngage Integration. Select the channel you want to share the messages with.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FICTbodNNzpvLwxZw5W7k%2FME%201.3.png?alt=media&#x26;token=11df57c1-eb54-42df-99ec-18e35d83ee93" alt=""><figcaption><p>Configuring the Integration in Gallabox</p></figcaption></figure>

4. To configure Gallabox with MoEngage, do the following:

* Go to MoEngage Settings->Channel (WhatsApp)->Sender Configuration.
* Click +Add connector on the left menu.
* Choose Gallabox from the list of WA providers or connectors available in the dropdown and click *Done*.

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FpnchdlewohOTjTJaiHtj%2FME%201.4.png?alt=media&#x26;token=714640c8-d718-4419-a025-17a806fe1d29" alt=""><figcaption><p>Configuring in MoEngage</p></figcaption></figure>

Click on + Sender at the top right corner of the screen to configure the sender details, as explained below:

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FBpDiVp7Qo8fQDWs2krM5%2FME%201.5.png?alt=media&#x26;token=62dcc44a-5b21-43b1-93a6-5f27c8cb9c51" alt=""><figcaption><p>Selecting sender in MoEngage</p></figcaption></figure>

5. Configuring the sender details, as follows:

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FCLiqWvCdNksLXA7pNG9M%2FME%201.6.png?alt=media&#x26;token=9e2c40c8-3437-495a-8e5b-ec31b55ddea8" alt=""><figcaption><p>Configuring Sender details</p></figcaption></figure>

1. **Sender Name:** This field denotes the name you want to provide to the Sender profile to recognize while creating a campaign inside MoEngage. The *Sender Name* should be between 5-50 characters. This is a mandatory field.
2. **WhatsApp business number**: This field denotes the phone number registered with WhatsApp via Gallabox.  This is a mandatory field and is also referred to as the WABA number.

{% hint style="info" %}
To get the WABA Number from Gallabox - go to Settings -> WhatsApp Channel -> WhatsApp -> Copy the WhatsApp Number and paste in the WhatsApp business number in MoEngage
{% endhint %}

3. **delivery-report-callback-url**: To track the delivery of your WhatsApp Messages in MoEngage, copy the MoEngage Delivery Tracking URL, jump to your Gallabox dashboard, and paste it in the configuration window of MoEngage Integration in Gallabox. Click on Update Configuration to get the API Secret (Authorization) from the Gallabox to be used in the next step.

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FuaS68sNogLtVPbC2UGoW%2FME%201.7.png?alt=media&#x26;token=6ded83b1-e750-45be-bd7a-0ea390c8df9e" alt=""><figcaption><p>Pasting the delivery-report-callback-url in Gallabox</p></figcaption></figure>

4. **authentication**: This field denotes the API Key and will be used to identify the account that is making the API call. After you paste the Status URL in Gallabox and click on Update Configuration, you will get the API key to be used in the MoEngage dashboard as Authorization field.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FYEgL64ZnhmmP5HfyFM05%2FME%201.8.png?alt=media&#x26;token=cd3998f9-5c11-4ce4-a2d9-e288f6059d82" alt=""><figcaption><p>Copying the API Secret</p></figcaption></figure>

6. Copy the API Secret, jump to your MoEngage account, and paste it in the Authorization field as shown in the below picture. Here we have added Bearer before pasting the API Secret. If you don't add Bearer, it would still work.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2F5hgqFzCQZjeCTquOcyDx%2FME%20%201.9.png?alt=media&#x26;token=fc2b366d-08fd-4762-9eb9-24d7f95cf8d9" alt=""><figcaption><p>Pasting the API Key in Authorization in MoEngage</p></figcaption></figure>

7. Click on Save to successfully integrate the MoEngage with Gallabox. Upon successful integration, you will get a success message.

<figure><img src="broken-reference" alt=""><figcaption><p>Details saved successfully</p></figcaption></figure>

### Supported WhatsApp Templates

Apart from the Text Templates and Button Templates, you can also send the below WhatsApp Templates via MoEngage to your customers:&#x20;

* Flow Template
* Carousal Template
* Location Template
* Catalogue Template
* Payment Template

### WhatsApp Template Configuration

You have to add the templates which are already approved by **META** via Gallabox on your MoEngage dashboard.&#x20;

If you haven't added any template in Gallabox, go to our guide for [Creating WhatsApp Templates.](https://docs.gallabox.com/basic-modules/whatsapp-template-guidelines)

{% hint style="info" %}
MoEngage does not validate your templates when you save them on your account. Hence, make sure that they are accurate else your campaign may fail because of template mismatch.
{% endhint %}

1. Sign in on your MoEngage account. From the left navigation, click on **Settings**. The navigation tab for Settings will open up. Under **Channel** click on WhatsApp. You will be redirected to window and then click on **Approved templates**.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FddGbe8GaPQCRNze7XnfO%2FMoEngage_templates_.png?alt=media&#x26;token=5671c5d2-d43b-4533-a498-110d60be8ff9" alt=""><figcaption></figcaption></figure>

2. To add the verified template in Gallabox to your MoEngage account, click on **+ Template** on the right side of the window as directed in the screenshot below.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FZlL64QWzTV2WX7KP18LZ%2FMoEngage_add_template.png?alt=media&#x26;token=d41e6029-4247-45bd-8954-3344a4c35af9" alt=""><figcaption></figcaption></figure>

3. Once you click on **+ Template** you will be redirected to add the information related to the template you would like to add in your MoEngage Account.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2F3Q7Pv2s8mUFDzKY7rOdV%2FMoEngage_add_template_info.png?alt=media&#x26;token=5fc35414-3dfd-47a2-b41d-94ce40e4e774" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="179.5">Field</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Paste the name of the template as per Gallabox. If the template name in Gallabox is <strong>order_confirmation_1</strong> or <strong>welcome_message,</strong> make sure in the MoEngage account the name stays similar. </td></tr><tr><td>Service Provider</td><td>Choose Gallabox from the dropdown. </td></tr><tr><td>Sender profile</td><td>Check the box for the WhatsApp number from the dropdown.</td></tr><tr><td>Language</td><td>Choose the language in which the verified template on Gallabox was created. Most preferred language is <strong>English</strong>. </td></tr><tr><td>Category</td><td>Choose the category from the dropdown which you selected in Gallabox. If the message category in Gallabox is <strong>Utility</strong> make sure that you choose the same in MoEngage. </td></tr><tr><td>Header</td><td>Paste the header (text, image, video, document, and location) as per the verified template in Gallabox. Remember to upload or paste the same URL as in Gallabox Message template.</td></tr><tr><td>Body</td><td>Paste the message body from the verified template in Gallabox. Make sure to change the variables into numbers. For example if the message template in Gallabox has 3 variables - {{customer_Name}}, {{OrderId}}, and {{Date}}. Change the variables as {{1}}, {{2}}, and {{3}} while pasting the message body. </td></tr><tr><td>Footer</td><td>Paste the footer from the Gallabox template.</td></tr><tr><td>Buttons</td><td>If you have used Quick Reply Buttons or CTA Buttons, make sure to paste as it is from the verified Gallabox template. </td></tr></tbody></table>

{% hint style="info" %}
**PRO TIP**: Open your Gallabox account in adjacent tab and double check if you have pasted the right contents from your Gallabox to your MoEngage account.&#x20;
{% endhint %}

After you are done pasting the verified template from Gallabox to your MoEngage account, it would look something like the below picture.&#x20;

*We have used a sample template here to give you an idea.*&#x20;

<figure><img src="broken-reference" alt=""><figcaption></figcaption></figure>

4. After copy & pasting the verified template from your Gallabox to your MoEngage account, click on **SAVE** button at the bottom right corner. When the template is saved, you can see in the list of templates as shown in the picture below. &#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FWNRskZP02kNUffgV8glI%2FMoEnagage_template_added.png?alt=media&#x26;token=58a41fb3-4b3c-49b5-b9c6-644d3708760c" alt=""><figcaption></figcaption></figure>

### MoEngage WhatsApp Campaign

In this article, we will understand how you can create a campaign on MoEngage.&#x20;

Before creating a campaign, make sure you have

-> Connected your Gallabox with MoEngage.&#x20;

-> Pasted the verified template in Gallabox to your MoEngage account.&#x20;

1. Sign in on your MoEngage account and from the left navigation click on **Engage**. The dropdown will appear and from the list of options, click on **Campaigns** like shown in the picture.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FDDAn1cO0YNRWHazjHzoX%2FMoEngage_campaign_.png?alt=media&#x26;token=553c269a-6145-4c21-a6e1-221d763e3b0c" alt=""><figcaption></figcaption></figure>

2. The **Campaigns** window will open up and you have to click on Create Campaign on the top right corner like shown in the picture below.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2F1uZ2EwQuRZzc5ZUPuWCh%2FMoEngage_create_campaign.png?alt=media&#x26;token=66e7a59d-ee9a-446d-96bb-e728f43eb716" alt=""><figcaption></figcaption></figure>

3. Create Campaign pop-up will open once you click on the button. You have to select the frequency of the campaign under Messaging Apps.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2F5Fhb0n8h7c254LE7wetw%2FMoEngage_create_campaign_pop_up.png?alt=media&#x26;token=669cd1ed-e1fb-432f-b670-2a85a2f27b25" alt=""><figcaption></figcaption></figure>

4. Click on Messaging Apps option and you will have 3 options - One Time, Periodic, and Event Triggered. You can select the frequency depending on the nature of the campaign.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FnXvORixqtYcNuf0XicrW%2FMoEngage_create_campaign_pop_up_frequency.png?alt=media&#x26;token=7b6b3562-1f8c-4954-ade7-3b66aa136553" alt=""><figcaption></figcaption></figure>

5. Once you click the frequency either One Time, or Periodic, or Event triggered it will redirect you to the window where you will have to select Target Users. Provide the Campaign name and choose the campaign tags from the dropdown.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FQnUz5Qo8VJ9qFHNvHrZs%2FMoEngage_create_campaign_targetted_users.png?alt=media&#x26;token=faa4271a-f971-402b-b27f-e170b759b1e1" alt=""><figcaption></figcaption></figure>

Once you select the event in the Audience field, click on **Next** to select the **content** for the campaign.&#x20;

6. In the content step, you have to select the sender, the template, and you have to provide the sample value for the variable. [**Detailed guide on Personalization**](https://help.moengage.com/hc/en-us/articles/5197221466260-Personalization-in-WhatsApp#steps-to-personalize-0-0).

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2Fq1fHytnpknlcFXvzGn7H%2FMoEngage_create_content.png?alt=media&#x26;token=f88cf5e4-6b8d-4b87-8bf0-8011d0c94986" alt=""><figcaption></figcaption></figure>

6.1 You have the option to test the campaign before publishing. It gives you the chance to resolve any error. You have to select the **Mobile Numbe**r (External/Not Registered with MoEngage) and provide the **mobile number with Country code** and click on **Test**.&#x20;

<figure><img src="broken-reference" alt=""><figcaption></figcaption></figure>

7. After testing the campaign, click on **Next** to schedule the campaign. You can either select **As soon as possible** or **At Specific date and time,** if you want to schedule the campaign for later.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FKDqmiEhjOY8MKu6hFjMd%2FMoEngage_test_campaign_schedule.png?alt=media&#x26;token=906873c2-ea18-4fd4-afc7-9fc10d66f0f7" alt=""><figcaption></figcaption></figure>

You will have to provide the start day and send time for the campaign. Once you do that, click on **Publish** Button at the bottom right of the screen. There will be a pop-up asking you to confirm again.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FuK269iNBVnQnjazeEjD0%2FMoEngage_test_campaign_publish.png?alt=media&#x26;token=2914108a-c789-4a49-a111-50da1be872d0" alt=""><figcaption></figcaption></figure>

Click on **Publish** again.&#x20;

You will be redirected to the campaign info to monitor the progress.&#x20;

<figure><img src="https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2Fdi4Wgu7VcI0ORxEV55AP%2FMoEngage_test_campaign_info.png?alt=media&#x26;token=d52ca560-d85d-4e73-9678-42045daabf28" alt=""><figcaption></figcaption></figure>
