Skip to content

Commit e5f0ff1

Browse files
authored
Merge pull request SkylineCommunications#439 from SkylineCommunications/META-WhatsApp-Messaging
Update META_WhatsApp_Messaging.md
2 parents 44f9086 + 32642cc commit e5f0ff1

File tree

1 file changed

+6
-60
lines changed

1 file changed

+6
-60
lines changed

connector/doc/META_WhatsApp_Messaging.md

+6-60
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@ The META WhatsApp Messaging connector acts as a link between the DataMiner Syste
2626
|-----------|---------------------|-------------------------|-----------------------|-------------------------|
2727
| 1.0.0.x | No | Yes | - | - |
2828

29+
## Installation
30+
31+
See [Installing the META WhatsApp Messaging solution](https://docs.dataminer.services/user-guide/Standard_Apps/Monitoring_Solutions/META_WhatsApp_Messaging/META_WhatsApp_Messaging_Installation.html).
32+
2933
## Configuration
3034

3135
### Connections
@@ -39,64 +43,6 @@ HTTP CONNECTION:
3943
- **IP address/host**: The polling IP or URL of the destination. For this connector, it should be set to `https://graph.facebook.com`.
4044
- **IP port**: The IP port of the destination. For this connector, it should be set to 443.
4145

42-
### Initialization
43-
44-
#### Prerequisites
45-
46-
##### 1. Register on the Meta Developers Platform
47-
48-
1. Follow the steps on the following page to register: <https://developers.facebook.com/docs/development/register>.
49-
1. When you have registered, go to *My Apps* and then click *Create App*.
50-
1. Select *I don't want to connect a business portfolio yet*.
51-
1. As the use case, select *Other*.
52-
1. Make sure the app type is set to *Business*.
53-
1. Specify a name for the app and attach an email address to it.
54-
55-
##### 2. Create a Business Manager Account
56-
57-
1. Go to the Meta Business Suite at <https://business.facebook.com/>.
58-
1. Create a new account by specifying a business name, the owner name, and the email that should be associated with the business.
59-
1. Set the required details of the business.
60-
1. Confirm the business email address.
61-
62-
##### 3. Add WhatsApp to the App and Send a Test Message
63-
64-
1. Back on the developer page, in the *Add Products* section, locate WhatsApp, and click *Set up*.
65-
1. Go to the WhatsApp *Quick Start* and select the commercial portfolio you created in the previous step.
66-
1. In the *API Configuration* section, add a new recipient’s phone number.
67-
1. Enter the verification code you received in the recipient's WhatsApp app to verify the phone number.
68-
1. Select the recipient's phone number and send the test message by clicking the *Send Message* button.
69-
1. Save the **Phone Number Identifier** and the **WhatsApp Business Account ID** located just below the sender's number for later steps.
70-
71-
> [!NOTE]
72-
> At this point, make sure to add all the recipient numbers to which you want to send the WhatsApp alarm notifications.
73-
74-
##### 4. Create a System User
75-
76-
1. Go to the Meta Business Suite again (at <https://business.facebook.com/>).
77-
1. In the *Users > System Users* section, add a new system user, specifying a name and a role (*Employee* or *Admin*).
78-
1. Select the user you created, click the "..." button, and select *Assign assets*.
79-
1. Assign your app and give the user the appropriate permissions.
80-
1. Click *Generate token*.
81-
1. Select the app.
82-
1. Select the desired time for the token to expire (for security reasons, 60 is recommended).
83-
1. Assign the following permissions: *business_management*, *whats_app_business_messaging*, *whats_app_business_management*.
84-
1. Save the **generated token** in a safe place, as it will be needed in later steps.
85-
86-
#### Installation
87-
88-
1. Install this connector along with the corresponding Automation script (META Alarm Detection) using the installation package.
89-
1. Create a new element running the **META WhatsApp Messaging** connector.
90-
1. Set the IP address/host to `https://graph.facebook.com`.
91-
1. Set the IP Port to `443`.
92-
1. Once the element is running, fill in the *Phone Number ID*, *WhatsApp Business ID*, and *Token* parameters on the **Configuration** page with the values you saved earlier.
93-
1. Create a Correlation rule. For more information, see [DataMiner Correlation](https://aka.dataminer.services/Correlation) or the [Orchestration & Automation learning course](https://community.dataminer.services/learning/courses/orchestration-automation/).
94-
1. Set the alarm filter that should trigger the rule.
95-
1. Set an action to run the **META Alarm Detection** script, which you installed earlier.
96-
1. In the Contacts table, add the phone numbers that should receive WhatsApp alarm notifications.
97-
98-
The numbers must start with the country code and exclude any non-numeric characters.
99-
100-
## How to Use
46+
## How to use
10147

102-
If everything went well during the installation and configuration, and an alarm occurs that matches the filtering criteria defined in the Correlation rule, the people in the Contacts table will receive an alarm message in their WhatsApp apps, informing them about the generated alarm.
48+
See [Using the META WhatsApp Messaging solution](https://docs.dataminer.services/user-guide/Standard_Apps/Monitoring_Solutions/META_WhatsApp_Messaging/Using_META_WhatsApp_Messaging.html).

0 commit comments

Comments
 (0)