Skip to main content

WhatsApp Integration with Motadata ObserveOps

Overview

Motadata ObserveOps (formerly known as AIOps) supports WhatsApp integration to deliver alerts directly to users through WhatsApp. This integration leverages Meta’s WhatsApp Business Platform, enabling secure, real-time communication for observability events such as alerts, incidents, and policy violations.

Once configured, Motadata ObserveOps can forward Alert notifications to WhatsApp using approved message templates, ensuring reliable delivery and compliance with Meta policies.

Prerequisites

Before configuring WhatsApp integration, ensure the following requirements are met:

  • Verified Meta Business Account.
  • Valid Facebook Developer Account.
  • A WhatsApp Business Account linked to the Meta Business Manager.
  • Access to Meta Developer Console.
  • Admin access to Motadata ObserveOps.

High-Level Configuration Flow

The WhatsApp integration setup involves the following stages:

  1. Login to Meta Business account and app
  2. Enable WhatsApp products
  3. Generate a permanent access token
  4. Obtain the WhatsApp phone number ID
  5. Create and approve message templates

Create App

To create a WhatsApp Virtual Agent using Facebook, follow the below steps.

Step 1: Login to Meta Business Account

  1. Navigate to https://business.facebook.com.
  2. Log in using your Meta business account to verify your business is registered with Meta business.

This account is required to manage WhatsApp Business assets and permissions.

Step 2: Create a Meta App

  1. Go to https://developer.facebook.com.
  2. Sign in using your Facebook Developer Account and click the My Apps option.

  1. Click the Create App button and select Create app from the pop-up..

  1. Enter the App name and click the Next button.

  1. Select Others as the use case from the All use cases displayed on the left side.
  2. Now, select Other from the right side of the screen and click the Next button.

  1. Select Business as the app type and click the Next button.

This will route you to the Details section.

  1. Verify the details and select the verified meta business portfolio from the Business portfolio drop-down.
info

The business portfolio drop-down displays list of portfolios you have already created them.

  1. Click Create App button.

  1. Provide the password and click on Submit button.

Thus, your app is created and will appear in the Apps Dashboard.

Step 3: Add WhatsApp as a product in newly created app

  1. Open the newly created app from the Apps dashboard by selecting it from the upper left drop-down.
  2. Navigate to WhatsApp from the Add product to app section and click the Set up button.

This will display the whatsapp set up landing page.

  1. Click the Continue button.

This will display Whatsapp in your left side bar as added product .

Step 4: Generate a Permanent Access Token

WhatsApp message delivery requires a never-expiring access token.

Create a System User

  1. Navigate to App Roles > Roles and click the Edit Roles in Business Manager.

This will route you to a new tab that displays the business settings.

  1. From the Settings screen, go to Users > System Users.

  1. Click the Add button and select Create a new app ID.
  2. Enter:
    • System User Name
    • Role: Admin (mandatory) Then, click the Create system user and follow the steps displayed on the screen to create the user successfully.

Assign App Permissions

  1. Select the created system user from the System Users list.
  2. Click the Assign Assets button from the right side of the screen.

This will display the Select assets and assign permissions pop-up on the screen.

  1. Select the newly created App from the list for the Apps option.
  2. Enabling the Manage app toggle button from the Full control section will allow you to manage roles, change app settings, test the app and view analytics.

  1. Click the Assign assets button to assign the asset.
  2. Click the Done button to proceed further.

Generate Token

  1. Click the Generate Token option from the screen. This will display the Generate toke pop-up on the screen.

  1. Select the app from the drop-down for What app would you like to generate a token for? and click the Next button.
  2. Now, you need to Set expiration for token expiration timeline.

  1. Clicking Next you can Assign permissions by selecting it from the drop-down.

  1. Click the Generate token button and copy the displayed token on the screen.

  1. Click the Done button to finish generating token an close the tab.

Step 5: Get WhatsApp Phone Number ID

  1. In Meta Dashboard, go to WhatsApp > API Setup.
  2. Under Step 1, select the phone number from the drop-down if already configured or click the Add phone number button.

  1. Provide information such as WhatsApp Business display name, Category and Business description and click the Next button.

  1. You need to provide the phone number in Add number section and verify it by re-entering it in the Verify number section.
  2. Clicking the Done button you will redirected to the Api Setup screen.
  3. Selecting the phone number from the drop-down displays the Phone Number ID below the selected phone number.

This ID is required for sending messages so copy it.

Step 6: Create WhatsApp Message Templates

WhatsApp only allows outbound messages using approved templates.

  1. Click the All tools option from the left navigation bar and search for the Whatsapp Manager.

  1. Select the Manage Templates option from the Message templates section.

  1. Click the Create Template button from the right side of the screen.
  2. Now, set up your template by following the instructions on the screen and click the Next button.

  1. Enter the required details for the template and click the Submit for review button.

Once approved the template is ready for use.