Plugin Pros View Plugins

How to Connect Your WhatsApp Channel in WordPress Using Kinetix Messaging

Plugin Pros

A complete step-by-step guide — from creating your Meta App to receiving your first live message in the inbox.

Introduction

Kinetix Messaging by Ppros is a unified inbox plugin for WordPress that brings all your customer conversations — WhatsApp, Telegram, email, and more — into one central dashboard. This guide walks you through the entire process of connecting WhatsApp Business API to your WordPress site, covering every click you need to make in Meta for Developers and every field you need to fill in the plugin. What you’ll need before you start:

  • A WordPress site with Kinetix Messaging installed and activated
  • A Meta (Facebook) Developer account — developers.facebook.com
  • A Meta Business Manager account — business.facebook.com
  • A phone number that is NOT already registered on a personal WhatsApp account (a fresh/dedicated number is recommended)
  • Your WordPress site must be accessible over HTTPS (SSL certificate required — Meta won’t accept plain HTTP webhook URLs)

Part 1 — Set Up Your Meta App & WhatsApp Product

Step 1: Log in to Meta for Developers

  1. Go to https://developers.facebook.com.
  2. Click My Apps in the top-right corner.
  3. Click the Create App button.

Step 2: Create a New Meta App

  1. When prompted “What do you want your app to do?”, choose Other, then click Next.
  2. On the next screen, select Business as the app type, then click Next.
  3. Fill in the app details:
    • App name: e.g., MyStore WhatsApp Bot
    • App contact email: your email address
    • Business portfolio: Select your existing Meta Business Manager account (or create one if you haven’t already)
  4. Click Create App and complete any security verification (you may be asked to re-enter your Facebook password).

Tip: Keep the Meta App Dashboard open — you’ll be copying several values from it into the plugin.

Step 3: Add the WhatsApp Product to Your App

  1. On your new app’s dashboard, scroll down to the Add Products to Your App section.
  2. Find WhatsApp and click Set Up.
  3. Meta will redirect you to the WhatsApp → Quickstart page.

Step 4: Connect Your WhatsApp Business Account (WABA)

  1. On the Quickstart page, under Step 1: Select a WhatsApp Business Account, click Create a new WhatsApp Business Account (or select an existing one from the dropdown).
  2. Follow the prompts to verify or create your Business Account.
  3. Once connected, Meta will show you a test phone number (a free sandbox number) for development, and you’ll see the option to add your own number for production.

Step 5: Add Your Production Phone Number

  1. In the left sidebar, go to WhatsApp → Phone Numbers.
  2. Click Add phone number.
  3. Enter your number in international format (e.g., +15550001234).
  4. Verify the number via SMS or a voice call — Meta will send a 6-digit code.
  5. Once verified, the number appears in the list with a Phone Number ID next to it.

📋 Copy the Phone Number ID — you’ll need it in the plugin.

Step 6: Collect Your Key Credentials

Before leaving the Meta dashboard, gather these four values. You can find them all in the WhatsApp → API Setup panel:

CredentialWhere to Find It
WhatsApp Business Account ID (WABAID)WhatsApp → API Setup — shown at the top (“From” section)
Phone Number IDWhatsApp → Phone Numbers → click your number
Temporary Access TokenWhatsApp → API Setup → copy the token shown (valid 24 hours; you’ll replace with a permanent one)
App SecretApp Settings → Basic → App Secret → click “Show”

⚠️ Important: The temporary access token expires in 24 hours. See Part 3 of this guide to generate a permanent token using a System User.

Part 2 — Configure the Plugin Settings

Step 7: Open WhatsApp Settings in Kinetix Messaging

  1. Log in to your WordPress Admin dashboard.
  2. In the left menu, click Kinetix Messaging → Inbox.
  3. The Inbox React app will load. Click the Settings (gear ⚙️) icon in the sidebar.
  4. In the channel list, find WhatsApp Business and click on it.
  5. Make sure you are on the API Setup tab (the first tab).

Step 8: Fill in the API Setup Tab

You’ll see the following fields. Fill each one in using the credentials you collected in Part 1:

① Enable WhatsApp

Toggle this ON. The integration won’t work unless this is active.

② WhatsApp Business Account ID (WABAID)

Paste your WABAID here.

  • Helper text in plugin: “Found in Meta Business Manager → WhatsApp → Business Accounts.”

③ Phone Number ID

Paste the Phone Number ID for the specific number you want to use.

④ Permanent Access Token

Paste your access token here.

  • For development you can paste the temporary token to test things first.
  • For production, use a permanent System User token (see Part 3).

⑤ App Secret

Paste your App Secret from App Settings → Basic.

  • This is critical. The plugin uses it to verify the X-Hub-Signature-256 security signature on every inbound webhook from Meta. Without it, inbound messages will be rejected.

⑥ Webhook Verify Token

Type any secret string of your choice — e.g., my_kmbp_whatsapp_token_2026.

  • You’ll enter this same string in the Meta webhook configuration in the next step.
  • Write it down — you need it in both places.

⑦ Display Phone Number

Enter your WhatsApp number in international format (e.g., +1 555 000 1234).

  • This is used for the click-to-chat button and the wa.me/ share link.

⑧ Webhook URL (read-only)

At the bottom of the API Setup section you’ll see a read-only field showing your webhook URL:

https://yourdomain.com/wp-json/kmbp/v1/webhooks/whatsapp

Copy this URL — you’ll paste it into Meta in the next step.

⑨ Save & Test

Click Save (the main save button in the settings panel). Then click Test Connection to verify your credentials are accepted.

Part 3 — Configure the Webhook in Meta

Step 9: Register the Webhook Callback URL

  1. Go back to the Meta Developer dashboard.
  2. In the left sidebar: WhatsApp → Configuration.
  3. Scroll to the Webhooks section and click Edit.
  4. Fill in the two fields:
    • Callback URL: Paste the webhook URL you copied from the plugin:https://yourdomain.com/wp-json/kmbp/v1/webhooks/whatsapp
    • Verify Token: Type the exact same verify token you entered in the plugin (e.g., my_kmbp_whatsapp_token_2026).
  5. Click Verify and Save.

✅ If everything is correct, Meta will send a GET request to your site, the plugin will echo back the challenge, and Meta will show a green “Verified” checkmark. If it fails, double-check that your site is accessible over HTTPS and the verify tokens match exactly.

Step 10: Subscribe to Webhook Fields

After the webhook is verified:

  1. Still on WhatsApp → Configuration → Webhooks, click Manage next to your verified URL.
  2. Enable (subscribe to) the following fields:FieldPurposemessagesReceive inbound customer messagesmessage_template_status_updateGet notified when templates are approved/rejectedaccount_updateAccount-level status changesphone_number_quality_updatePhone number quality rating changes
  3. Click Done / Save.

Part 4 — Generate a Permanent Access Token (Recommended for Production)

The default token Meta shows you expires every 24 hours. To avoid your integration breaking overnight, create a System User token which never expires.

Step 11: Create a System User

  1. Go to Meta Business Settings → business.facebook.com/settings.
  2. In the left sidebar, find Users → System Users.
  3. Click Add, give the system user a name (e.g., Kinetix WA Bot), and set the role to Admin.
  4. Click Create system user.

Step 12: Assign the App & Permissions

  1. Select your new system user, then click Add Assets.
  2. Choose Apps → find the Meta app you created → click Add.
  3. Enable Full Control (or at minimum: whatsapp_business_messaging, whatsapp_business_management).
  4. Click Save Changes.

Step 13: Generate the Permanent Token

  1. Still on the system user page, click Generate New Token.
  2. Select your app from the dropdown.
  3. Under Permissions, enable:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Set Token Expiration to Never.
  5. Click Generate Token and copy the token immediately — Meta will only show it once.

Step 14: Update the Plugin with the Permanent Token

  1. Return to Kinetix Messaging → Inbox → Settings → WhatsApp → API Setup.
  2. Replace the temporary token in the Permanent Access Token field with the new system user token.
  3. Click Save.

Part 5 — Optional but Recommended Settings

Step 15: Configure the Webhook Tab

Click the Webhook tab in the WhatsApp settings panel. This tab shows:

  • The Callback URL (same as API Setup)
  • The required webhook field names you should subscribe to (reference for your Meta configuration)
  • A sample inbound message payload so you know what data arrives from Meta No configuration is needed here — it’s informational. Use it to double-check your Meta setup.

Step 16: Set Up the Website Button (Optional)

The Website Button tab lets you add a WhatsApp click-to-chat button anywhere on your site.

  1. Enter a Pre-filled message (e.g., Hello! I'd like to get some help.).
  2. Choose a Button Style: Floating bubble, Inline banner, or None.
  3. Enter a Button Label (e.g., Chat on WhatsApp).
  4. Copy the Embed Snippet and paste it into any page/post, or use the shortcode:

Step 17: Configure Messaging Behaviour (Optional)

Click the Messaging tab and tune these options to your workflow:

SettingRecommendation
Read receiptsTurn ON — sends read receipts when an agent opens a conversation
Allow media attachmentsTurn ON — lets customers send images, documents, audio, video
Auto-assign new conversationsTurn ON for teams — round-robins conversations to online agents
Business hours onlyOptional — rejects messages outside working hours
Auto-reply on new conversationTurn ON — sends an instant acknowledgement. Use the token {{customer_name}} in your message for personalization

Step 18: Compliance Settings (Optional but Important for Marketing)

Click the Compliance tab if you plan to send outbound marketing messages:

  • Enable Process STOP keyword — automatically opts out contacts who reply STOP
  • Enable Process START keyword — re-subscribes contacts who reply START
  • Add your Business Portfolio ID for 10DLC / WABA registration tracking
  • Complete business verification in Meta Business Manager before sending high-volume campaigns

Part 6 — Test the Integration End-to-End

Step 19: Send a Test Message

  1. From your personal WhatsApp (or the Meta Test Phone Number sandbox), send a message to your registered business number.
  2. In Kinetix Messaging → Inbox, the conversation should appear in the list within a few seconds.
  3. Click the conversation and reply from the inbox — the message should land on the customer’s WhatsApp. If the message appears in the inbox: 🎉 Your WhatsApp channel is live!

Troubleshooting

ProblemLikely CauseFix
Webhook verification failsVerify tokens don’t matchCheck for leading/trailing spaces in both fields
Webhook verifies but messages don’t arriveWebhook fields not subscribedRe-check Step 10 and subscribe messages
Messages arrive but are rejected (HTTP 401)App Secret is wrong or missingCopy App Secret from App Settings → Basic → Show
Token expires after 24 hoursUsing temporary tokenFollow Part 4 to create a permanent System User token
“Channel not enabled” errorEnable toggle is OFFTurn on the Enable WhatsApp toggle in API Setup tab
Outbound messages failWrong Phone Number IDConfirm the ID in Meta → WhatsApp → Phone Numbers
Site isn’t over HTTPSMeta rejects plain HTTPInstall an SSL certificate (Let’s Encrypt is free)

Summary Checklist

  • Created a Meta Developer App (type: Business)
  • Added WhatsApp product to the app
  • Connected / created a WhatsApp Business Account (WABA)
  • Added and verified a phone number → copied Phone Number ID
  • Copied WABAID, App Secret
  • Created a permanent System User token (or copied temporary token for testing)
  • Opened Kinetix Messaging → Inbox → Settings → WhatsApp → API Setup
  • Filled in WABAID, Phone Number ID, Access Token, App Secret, Verify Token, Display Phone
  • Copied the Webhook URL from the plugin
  • Pasted Webhook URL + Verify Token into Meta → WhatsApp → Configuration → Webhooks and clicked Verify
  • Subscribed to webhook fields: messages, message_template_status_update, account_update, phone_number_quality_update
  • Sent a test message and confirmed it appeared in the inbox