Connect WABA
To connect WhatsMark SaaS with Meta’s WhatsApp Cloud API, you’ll need two things from your Meta Developer account: your WhatsApp Business Account (WABA) ID and a permanent access token. The sections below walk you through creating the app, adding WhatsApp, verifying a phone number, and generating the token.
Create Meta App & Add WhatsApp
-
Create App & Add WhatsApp
: High-level onboarding through Meta Developer portal
- • Go to developers.facebook.com → My Apps → Create App
- • Choose App Type = Business, then continue
- • Fill basic details (display name, contact email, optional business account), then Create App
- • On Product list, find WhatsApp and click Set up
- • Payment method can be added now or later (optional)
Add Phone Number
-
Add Phone Number
: Register the number for WhatsApp Cloud API
- • Open API Setup and click Add phone number
- • Complete business profile: display name, timezone, category, optional description
- • Enter phone number and verify via SMS or call
- • Enable Live mode to start using the number
Collect Permanent Access Token
-
Generate Permanent Token
: Create a system user and issue a long-lived token
- • From API Setup → See the overview page → open Business Settings
- • Create a System User (role: admin or employee)
- • Assign assets: Apps → select your app → grant Full control
- • Generate new token: choose app and permissions (business_management, catalog_management, whatsapp_business_messaging, whatsapp_business_management)
- • Copy and store the token securely
-
Find WABA ID
: Copy the WhatsApp Business Account ID
- • Go to Business Settings → WhatsApp Accounts
- • Select the account and copy the WhatsApp Business Account ID
Connect WABA Screen
-
Connect WABA
: Enter credentials in WhatsMark SaaS
- • Open Tenant Dashboard → WhatsApp → Connect WhatsApp
- • Paste Access Token and WABA ID, then click Connect
- • Optionally use Debug Token to validate the token details
- • Click Configure to finalize setup
Connection Requirements
-
Prerequisites
: What you need ready
- • Registered mobile number on Meta
- • Meta Developer account with WhatsApp product added
- • WhatsApp Business Profile with Live mode on
- • System user with a permanent access token and proper permissions
- • Validate setup using Meta debug tools
WhatsApp Business API Integration - Overview
Use the camera icon on the panel to capture a screenshot of your configuration when needed.
1) Access Token Information
-
Access Token Details
: What the panel shows
- • Partially masked token with a Copy button
- • Scopes such as: catalog_management, business_management, whatsapp_business_management, public_profile
- • Issued at and Expiry timestamps (expiry may be N/A for permanent tokens)
- • Webhook URL provided for receiving events; copy for external integrations
2) Phone Information
-
Default Phone Details
: Registered number overview
- • Display phone number and verified business name
- • Phone Number ID used by WhatsApp Cloud API
- • Quality indicator (e.g., GREEN) and daily messaging limit
- • Number status (e.g., ACTIVE/EXPIRED) and Manage Numbers action
3) WABA Health & Status
-
WABA Health & Status
: Account capability snapshot
- • Overall health status with last-checked timestamp
- • WABA ID and per-identifier message-sending availability
- • Refresh button to re-check health indicators
4) Send Test Message
-
Send a Test Message
: Quick validation
- • Enter a phone number including country code
- • Click Send to dispatch a test template message
5) Verify Webhook
-
Verify Webhook
: Confirm events delivery
- • Use Verify button to ensure webhook challenge and delivery are OK
6) QR Code for WhatsApp Chat
-
QR & Deep Link
: Share your chat entry point
- • Scan QR to start a WhatsApp chat
- • Copy the WhatsApp URL or click the quick action button
Next Steps
After connecting your account, continue with System Settings to finish platform configuration.