Installing the META WhatsApp Messaging Solution

Prerequisites

Before installing the META WhatsApp Messaging connector, ensure you meet all the prerequisites:

• Make sure you are registered as a Meta Developer.

• Create the DataMiner Alarm Notification app.

• Create a Business Manager account.

• Add WhatsApp to your app and send a test message.

• Create a system user.

Create the 'DataMiner Alarm Notification' app

1. Navigate to My Apps and select Create App.

2. Select I don't want to connect a business portfolio yet.

3. Select Other as the use case.

4. Set the app type to Business.

5. Specify the following app details:

   • Name: DataMiner Alarm Notification

   • Email address: The email address to be used to contact you about this app

6. Click Create App.

   Your app will be loaded in the App Dashboard.

   

Tip

See also: App Type Creation Flow

Create a Business Manager account

1. Go to the Meta Business Suite and select Create an account.

2. Provide the following information:

   • Your business name

   • Your name (i.e. the owner)

   • Your business email (i.e. the email address you will use to conduct company business)

     Note

     Make sure you choose an email address you have access to as you will need to confirm it later.

3. Specify the required details of the business.

4. Confirm the business email address.

Add WhatsApp to your app and send a test message

1. Go to the App Dashboard and select the DataMiner Alarm Notification app.

2. Locate WhatsApp under the Add Products section and select Set up.

3. Click Quick Start and select the commercial portfolio you previously created.

4. Navigate to API Configuration > Send and receive messages and follow steps 1 and 2:

   1. Add a new recipient’s phone number.

      Note

      Add all the recipient numbers you want the WhatsApp alarm notifications to be sent to.

   2. Verify the new phone number by entering the verification code you have received via WhatsApp.

   3. Select the recipient's phone number.

   4. To send a test message to your newly added phone number, click Send message in the lower right corner.

5. Save the Phone number identifier and the WhatsApp Business Account ID, which you can find right below the sender's number.

Create a system user

1. Go to the Meta Business Suite.

2. Navigate to Users > System Users and click the + Add button in the top-right corner.

3. In the pop-up window, enter a name for your new system user and choose the appropriate role (Employee or Admin).

4. Select the user you created, click the ellipsis button ("..."), and select Assign assets.

5. Select the app you want to assign to this system user (i.e. the DataMiner Alarm Notification app), and grant them the appropriate permissions.

6. Select Generate token.

7. Select the app you previously assigned to the user.

8. Choose the duration for the token's validity. For security reasons, a 60-day expiry period is recommended.

9. Ensure that the following permissions are selected for the generated token:

   • business_management

   • whats_app_business_messaging

   • whats_app_business_management

10. After the token is generated, copy it and store it securely. You will need this token when configuring the connector.

Installing the 'META WhatsApp Messaging' connector

1. Look up the META WhatsApp Messaging Solution in the DataMiner Catalog.

2. Click the Deploy button.

3. Select the target DataMiner System and confirm the deployment. The package will be pushed to the DataMiner System.

   This will create a DataMiner element named "META WhatsApp Alerter" in your system. The element will be located in the DataMiner Apps & Solutions view.

   A new Automation script named "Meta Alarm Detection" will also be added to your system.

4. In Cube, go to the DATA > Configuration page of the META WhatsApp Alerter element.

5. Fill in the Phone Number ID, WhatsApp Business ID, and Token parameters with the values you saved earlier.