Skip to main content

WABA Onboarding

This guide walks you through the process of connecting your business phone number to the HK Reach platform via the Meta Cloud API.

🏢 Business Owner's Guide (Non-Technical)​

Follow these simple steps to get your WhatsApp automation started.

Prerequisites​

  • A Facebook Account with Admin access to your Business Manager.
  • A phone number that does not have an active WhatsApp/Business app account.
  • Access to receive SMS or a phone call on that number.

Step 1: Start Onboarding​

  1. Log in to your HK Reach Dashboard.
  2. Navigate to Channels or WhatsApp Settings.
  3. Click the "Connect WhatsApp" button.

Step 2: Meta Authorization​

  1. A Meta popup will appear. Log in to your Facebook account.
  2. Select the Meta Business Account you want to use.
  3. Follow the prompts to grant HK Reach permissions.

Step 3: Verify Your Phone Number​

  1. Once authorized, select your phone number from the list.
  2. Choose your verification method: SMS or Voice Call.
  3. Enter the 6-digit code in the HK Reach dashboard.

Step 4: Finalize​

  • Once the status changes to "Connected", you are ready!

🛠️ Technical Administrator's Guide (Deep-Dive)​

1. The OAuth Handshake​

The frontend utilizes the Meta Embedded Signup flow.

  • Endpoint: POST /api/MetaOnboard/callback
  • Action: Exchanges code for a Long-Lived Access Token.

2. Discovery Logic​

  • WABA ID: Retrieved via GET /me/whatsapp_business_accounts.
  • Phone Number ID: Retrieved via GET /{waba_id}/phone_numbers.

3. Verification & Registration Flow​

  1. Request OTP: POST /{phone_number_id}/request_code.
  2. Verify OTP: POST /{phone_number_id}/verify_code.
  3. Registration: POST /{phone_number_id}/register. Stores an encrypted 6-digit PIN.

4. Webhook Subscription​

  • API Call: POST /{waba_id}/subscribed_apps
  • Result: Subscribes the WABA to the Meta App for webhooks.

🎥 Video Tutorials​

Learn how to get started with these step-by-step video guides: