Complete Guide: WhatsApp Business API integration

WhatsApp Business API integration (officially the WhatsApp Business Platform / Cloud API) lets businesses send and receive messages at scale via Meta’s hosted API. It supports text, media, interactive messages (buttons, lists), templates, and more. The older on-premise API is deprecated; Cloud API is the standard path in 2026.

Key Components

  • WhatsApp Business Account (WABA): Container for phone numbers, templates, and assets.

  • Phone Number ID: The business number used for messaging.

  • Access Token: Authenticates API calls (temporary for testing; permanent system-user token for production).

  • Webhooks: Receive real-time inbound messages, delivery statuses, and events.

  • Message Templates: Required for initiating conversations outside the 24-hour customer care window (must be approved by Meta).

Prerequisites

  • Meta/Facebook Developer account + Meta Business portfolio (Business Manager).

  • Business verification (legal documents, often takes days).

  • A phone number not already registered on personal WhatsApp or the free WhatsApp Business app.

  • HTTPS endpoint for webhooks (with valid SSL).

  • Basic knowledge of REST APIs and JSON.

High-Level Setup Steps (Direct Cloud API)

Create a Meta App

  1. Go to developers.facebook.com → Create App → Choose the WhatsApp / “Connect with customers through WhatsApp” use case.

Add WhatsApp Product & Set Up Assets

  1. In the app dashboard, add the WhatsApp product. This creates a test WABA and phone number. Generate a temporary access token from the API Setup page.

Register a Production Phone Number

  1. Add and verify a real business phone number (via SMS/voice OTP). Set display name and profile.

Configure Webhooks

  1. Provide a public HTTPS URL. Subscribe to fields such as messages, message_status, etc. Handle Meta’s verification challenge (GET request with hub.challenge).

Create & Approve Templates

  1. Use WhatsApp Manager or the Business Management API to create templates (utility, marketing, authentication categories). Wait for Meta approval.

Send Messages

Use the Graph API endpoint:

POST https://graph.facebook.com/vXX.0/{PHONE_NUMBER_ID}/messages

  1. with a Bearer token and JSON body (e.g., text, template, interactive).
    Example (text message):
    JSON

{

  "messaging_product": "whatsapp",

  "recipient_type": "individual",

  "to": "15551234567",

  "type": "text",

  "text": { "body": "Hello from the Cloud API!" }

  1. }

Handle Inbound Messages & Statuses

  1. Process webhook payloads for replies, read receipts, failures, etc. Implement opt-in/opt-out logic (required by WhatsApp policy).

Alternative: Business Solution Providers (BSPs)

For most businesses, using a BSP (Twilio, 360dialog, MessageBird/Infobip, Gupshup, etc.) is easier. They handle hosting, compliance, analytics, CRM integrations, and often provide dashboards + SDKs. You still need Meta Business verification, but onboarding is faster and less technical.

Official Resources

Important Notes & Best Practices

  • Opt-in required: Users must explicitly consent to receive messages. Respect opt-outs.

  • Conversation windows & pricing: Free-form messages are limited to 24 hours after a user message; otherwise use approved templates. Pricing is conversation-based (varies by country and category).

  • Quality rating: High block/report rates can restrict or ban the number.

  • Rate limits & scaling: Start low; higher tiers unlock with good quality and verification.

  • Security: Store tokens securely, use system users for production, validate webhook signatures.

  • SDKs exist (official and community, e.g., Node/Python wrappers), but the core is the Graph API.

Comments

Post a Comment

Popular posts from this blog

How to Set Your Preferred Default Printer in Windows

To set your preferred default printer in Windows 10 and 11. Easy steps to choose a fixed printer and stop Windows from changing it automatically. On Windows 11 Open Settings (press Windows + I). Go to Bluetooth & devices → Printers & scanners . Under Printer preferences , turn Off the option “Let Windows manage my default printer” . Click on the printer you want to use as default. Click the Set as default button. The status will change to Default . On Windows 10 Open Settings (press Windows + I). Go to Devices → Printers & scanners . Uncheck the box “Let Windows manage my default printer” . Click the printer you want as default → click Manage . Click Set as default . Alternative Method (Both Windows 10 & 11) Press Windows + R, type control, and press Enter. Open Devices and Printers . Right-click your preferred printer. Select Set as default printer . Note : If “Let Windows manage my default printer” is turned On , Windows will automatically change the default to ...
Read more

Windows 11 Wi-Fi Not Working? Easy Ways to Fix It

Having trouble connecting to Wi-Fi on Windows 11 can be frustrating, especially when you need a stable internet connection for work, school, streaming, or browsing. Sometimes the problem is temporary, while other issues may be related to your Wi-Fi adapter, network settings, drivers, router, or internet service. The good news is that most Windows 11 Wi-Fi problems can be resolved with a few simple troubleshooting steps. This guide explains the common causes and easy ways to get your wireless connection working again. Why Is Wi-Fi Not Working on Windows 11? There can be several reasons why Wi-Fi is not working on Windows 11. Common causes include temporary network problems, outdated or faulty Wi-Fi drivers, incorrect network settings, saved Wi-Fi connection errors, router issues, or problems with your internet service. Before making major changes to your computer, try some basic checks: Make sure Wi-Fi is turned on. Check whether Airplane mode is disabled. Restart your Windows 11 PC. Re...
Read more

Affordable Health Insurance for Families: A Practical 2026 Guide

Finding affordable health insurance for a family can feel overwhelming, especially with rising premiums, deductibles, and the end of enhanced ACA subsidies after 2025. The good news is that options still exist through employer plans, the ACA Marketplace (with premium tax credits for many households), Medicaid, CHIP, and smart plan selection. Here’s a clear, actionable overview focused on the U.S. system in 2026. Main Options for Family Coverage 1. Employer-Sponsored Insurance  This is often the most affordable route when available. Employers typically cover a large share of the premium. Average total family premiums run around $2,000+ per month (with the employee share often several hundred dollars).   Key tip: Check the “family glitch” rules (fixed since 2023). Affordability for the *employee* is based on self-only coverage (under ~9.96% of household income for 2026). If family coverage exceeds that percentage, the spouse and children may still qualify for Marketplace su...
Read more