Get Started
Integrate Channel Providers

WhatsApp Business Cloud API Integration

Connect Meta WhatsApp Business Cloud API for transactional HSM template messages and session messages. HubNest supports Meta Embedded Signup (recommended) and manual token setup.

1

1. Select WhatsApp Provider in Integrations Console

Log in to HubNest Console → Integrations at https://app.hubnest.io/developer/integrations. Filter by WhatsApp channel. Find Meta WhatsApp Cloud API or Gupshup WhatsApp, then click CONNECT.

Step 1: Select WhatsApp Provider in Integrations Console
Click CONNECT button under Meta WhatsApp Cloud API
Credential Security
All Meta Access Tokens and WABA secret keys are AES-256 encrypted before being stored in the database.
2

2. Select Routing Mode (Master Account vs Custom API Key)

Choose your billing & routing preference in the popup modal:

Step 2: Select Integration Routing Mode
Select Use HubNest Master Account OR Manual Integration
  • Use HubNest Master Account: Route instantly via HubNest central Meta WABA contracts with prepaid wallet billing.
  • Manual Integration (Custom API Key): Directly connect your own Meta System User Access Token and Phone Number ID.
4

4. Manual Token Setup (Alternative Fallback)

If configuring manually: Fill in your Meta Permanent System User Access Token, Phone Number ID (numeric), and WhatsApp Business Account ID (WABA ID). Click Test Connection then Save Config.

Step 4: Manual Token Setup (Alternative Fallback)
Fill Permanent Access Token, Phone Number ID & WABA ID
Numeric Format Required
Both Phone Number ID and WABA ID must contain only digits. Non-numeric values will fail validation.
5

5. Monitor Live WhatsApp Telemetry, Limits & Click Rates

Open Channels → WhatsApp Gateway to view live dispatch metrics, Delivery Success Rate (100.0%), Interactive Click Rate (28.4%), telemetry line charts, and interactive delivery donut share.

Step 5: Live WhatsApp Telemetry, Limits & Click Rates
Monitor WhatsApp Telemetry, Delivery SLA (100%), and Click Rate (28.4%)
  • Tracks Total WhatsApp Sent, Successful Delivery, and Delivery Failures.
  • Interactive Click Rate target >= 25%.
  • Connected to Live Gateway status badge.
6

6. WhatsApp Message Composer & Live Chat Bubble Preview

Click "Individual Send" tab. Fill Target Contact phone number, select WhatsApp Template or Freeform Custom Mode, attach Media Header (image/video/document URL), add up to 3 Quick Reply Buttons (e.g. Unsubscribe), and type your message body. View the live green chat bubble preview on the right sidebar.

Step 6: WhatsApp Message Composer & Live Chat Bubble Preview
Fill Target Phone, Select Template, Add Quick Reply Buttons & preview Chat Bubble
WhatsApp Session Pricing
Template Messages outside 24h cost ₹0.35/msg; Session Messages within 24h cost ₹0.05/msg.
7

7. Schedule Execution Timing & Dispatch Message

Select execution timing mode ("Send Now" vs "Schedule Send") and click "Send Message" to dispatch your WhatsApp notification immediately.

Step 7: Schedule Execution Timing & Dispatch Message
Select Send Now & click Send Message button
8

8. Bulk WhatsApp Campaigns Dashboard & Dispatched History

Go to Channels → WhatsApp → Bulk Campaigns tab. Review past dispatched campaigns (e.g. July Product Catalog Launch, Security Access Recall Test) with delivered/failed counts (442 Delivered / 8 Failed), Read Rate (88%), Click Rate (40%), and VIEW REPORT actions. Click "+ Create Bulk WhatsApp Campaign" to launch the campaign wizard.

Step 8: Bulk WhatsApp Campaigns Dashboard & Dispatched History
View Dispatched Campaigns table, Read Rate (88%) & click + Create Bulk WhatsApp Campaign button
9

9. Campaign Wizard Step 1: Upload Recipient CSV & Campaign Name

In Step 1 of the Campaign Wizard: Enter your campaign name (e.g. whatapp_test) and drag-and-drop your recipient CSV file. The preview table auto-detects contact list data (e.g. 5 Contacts: Test User 1, 2, 3, 4).

Step 9: Campaign Wizard Step 1 - Upload Recipient CSV & Campaign Name
Enter Campaign Name & drag-and-drop recipient CSV file
10

10. Campaign Wizard Step 2: Select Message Template

In Step 2 of the Campaign Wizard: Select your registered WhatsApp message template card (e.g. __product_launch__feature_announcement - TRANSACTIONAL). Click Next > to proceed.

Step 10: Campaign Wizard Step 2 - Select Message Template
Select registered message template & click Next >
12

12. Campaign Wizard Step 4: Schedule Dispatch

In Step 4 of the Campaign Wizard: Choose execution timing mode — "Send Now" for instant broadcast queueing or "Schedule for Later" for automated future dispatch.

Step 12: Campaign Wizard Step 4 - Schedule Dispatch
Choose Send Now OR Schedule for Later & click Next >
13

13. Campaign Wizard Step 5: Review Dispatch & Send to Full List

In Step 5 of the Campaign Wizard: Review campaign settings (Outbound Queue: 5 Recipients, Template Chosen: __product_launch__feature_announcement, Est. Cost: ₹1.75, Available Wallet: ₹49.95). Click "Send to Full List" or "Send to Test Batch (First 50 only)" to launch live broadcast.

Step 13: Campaign Wizard Step 5 - Review Dispatch & Send to Full List
Review Testing Safeguards, Cost Estimates, and click Send to Full List
Was this guide helpful?