How to setup Whatsapp Meta API

Connect with an official external Meta developer backend to route high-volume transactional traffic directly through official Cloud API conduits. You can integrate Meta API using either the new automated Quick Connect method (Recommended) or the advanced Manual Setup method.

Method A: Quick Connect via Facebook (Recommended)

This is the easiest and fastest way to connect. By providing your Meta App ID, you can authorize Wawp to automatically retrieve your Access Token, WhatsApp Business Account ID, and Phone Number ID, and automatically subscribe your Webhooks.

Step 1: Create WhatsApp Meta API App

To get started, you must register a developer app on Meta's platform to obtain your App ID and App Secret:

1. Access the application dashboard: FaceBook Developer apps
2. Click on the Create APP button to begin standard workflows.

3. Define Use cases matching explicit business communication funnels. Select Other, then choose WhatsApp.

4. Customize organizational binding parameters to link your entity safely.

5. Input accurate App Name and standard administrative Contact E-Mail buckets.

6. Tie application strictly to your dedicated Facebook Business Account directory.

7. Final review screen display. Complete mandatory setup steps to persist variables.

8. Enter account credentials to securely verify creation completion authorization.

9. Copy the App ID and App Secret from the top bar or from the App Settings > Basic tab in your Meta Developer Dashboard.

Step 2: Initialize & Quick Connect in Wawp

Once you have your Meta App ID and App Secret, you can authorize Wawp in a single click:

1. Navigate to the Meta API Sender section within your Wawp dashboard.

2. In the Meta App ID (Client ID) and Meta App Secret fields, paste the keys you copied from Facebook, and click Save.
3. Under the Quick Connect banner, click the Connect with Facebook button.
4. A secure Facebook OAuth popup will open. Log in to your Facebook account and select the WhatsApp Business Accounts and Phone Numbers you want to grant Wawp access to.
5. Grant the necessary scopes: whatsapp_business_management and whatsapp_business_messaging.
6. Once authorized, Wawp will automatically use Meta's Graph API to fetch:
   • Permanent Access Token (populated in settings)
   • WhatsApp Business ID (WABA) (automatically populated)
   • Phone Number ID (automatically populated)
   • Verify Token (automatically generated as a secure random string)

Step 3: Automatically Subscribe Webhooks

With the App Secret and App ID saved, you can subscribe to real-time events automatically without manual configuration:

1. Scroll down to the Incoming Events (Webhook) card in Wawp.
2. Verify that your Verify Token is present.
3. Click the Subscribe Automatically button. Wawp will automatically request Meta Graph API to register the webhook callback URL and verify token.
4. Click Save in Wawp.

Under-the-Hood: How Quick Connect Works

For advanced developers, the Connect with Facebook mechanism automates the entire configuration handshake using official Meta SDK and OAuth API calls:

• 1. App Configuration & SDK Initialization: When you save your Meta App ID, the Wawp plugin loads and initializes the official Facebook JavaScript SDK (FB.init()) on your WordPress admin page.
• 2. OAuth Authorization Flow: Clicking Connect with Facebook triggers window.FB.login(), opening a secure Facebook dialog asking you to authorize Wawp with two critical WhatsApp permissions:
  • whatsapp_business_management (to discover and configure your WhatsApp Business account).
  • whatsapp_business_messaging (to send high-volume transactional messages).
• 3. Access Token & Key Generation: Upon approval, Facebook returns an OAuth Access Token to the Wawp frontend, which populates the Permanent Access Token field. Wawp also instantly generates a secure random string for the Verify Token.
• 4. Business & Phone Auto-Discovery: Wawp queries Meta's Graph API (/me/whatsapp_business_accounts). It instantly retrieves your WhatsApp Business ID (WABA ID) and the associated Phone Number ID, auto-filling the settings fields instantly.
• 5. Automated Webhook Subscription: When clicking Subscribe Automatically, Wawp's backend calls Meta's app subscription endpoint (/v17.0/{waba_id}/subscribed_apps) using your Access Token, securely binding your site's webhooks.

Method B: Manual Setup (Fallback Setup)

If you prefer to configure the parameters manually or encounter any authorization issues with Facebook OAuth, you can use the traditional manual configuration:

Step 1: Create WhatsApp Meta API App

Follow the same App creation workflow outlined in Method A - Step 1 to obtain your Meta developer application.

Step 2: Customize WhatsApp to Get Keys

Once the App is created, activate the WhatsApp product and generate credentials manually:

1. Locate and activate the WhatsApp product module within the app dashboard.

2. Connect mandatory assets across dashboards matching intended deployment targets.

3. Choose Opt-In models carefully:

• Opt-In All: Grants application full dynamic accessibility to any registered numbers globally.
• Opt-In Selected: Restricts application boundary to precisely enumerated number assets only.

4. Save configurations to persist operational settings.

5. Finalize and generate dynamic authorization credential streams.

6. Copy persistent tokens generated during lifecycle events safely.

Step 3: Port Keys to Wawp Plugin

Route developer components across the Wawp configuration plane to establish communication bridge:

1. Locate the Meta API Sender section within Wawp.
2. Inject copied authorization token stream directly into the Permanent Access Token field.

Step 4: Integrate Business Identifiers

Synchronize specific background identity integers enabling cloud broadcast routing logic:

1. Locate and copy the distinct WhatsApp Business Account ID and Phone Number ID visible inside your Meta Dashboard.

2. Navigate to input container fields and paste the extracted ID streams into their respective WABA ID and Phone Number ID fields.

3. Click Save in Wawp.

Step 5: Setup Dynamic Webhooks (Manual Method)

Synchronize state callbacks allowing real-time delivery verification and notification updates from handsets:

1. Enter explicit integration panel designated strictly for Webhook handlers in the Meta Developer Dashboard.

2. Copy the Rest Endpoint URL displayed under the Webhook card in Wawp.

3. Paste it in Meta's Webhook configuration window under Callback URL, and enter your Wawp Verify Token under Verify Token. Verify and save the webhook handshake.

4. Activate required subscriptions specifying actionable event pipelines. Under Webhook field subscriptions, subscribe to messages to receive incoming notifications and delivery statuses.

Next Steps

Step 6: Sync Approved Templates

Wawp retrieves and caches all your pre-approved templates so you can use them inside flows:

1. Scroll down to the WhatsApp Templates section.
2. Click Sync Now to fetch the catalog from Meta Cloud.

Step 7: Test Official Transmission Pipelines

Validate live broadcasts through native plugin notification modules after finalized hookups.

1. Notifications Builder: Dispatch instant test payloads.

2. Bulk Campaigns: Validate segment broadcasts efficiently.

3. Cart Recovery: Run automated abandon cart logic checks.

Monitor real-time response trackers verifying valid dispatch success states.

Monitoring & Debugging

Once your Meta API is live, you can monitor every sent message and its delivery status in real-time through the Wawp Activity Hub. (For advanced developers, explore Wawp API Messaging Endpoints for custom integrations).