How do I set up my WhatsApp Business API (WABA) account with Heyo?

How do I set up my WhatsApp Business API (WABA) account with Heyo?

⚡Quick answer -

You must

(a) hold an active Heyo Lite or Pro subscription,

(b) own a verified Facebook Business Manager (FBM) with an active Facebook Page, and

(c) use a Heyo-issued virtual number (personal mobile numbers do not work). Launch the WABA wizard inside the Heyo app, connect FBM, fill in business details, wait for Meta’s 24 h–3 day review, then enable multi-agent chat.



1. Prerequisites checklist

• Active Heyo Lite or Pro plan

• Facebook Business Manager account

• Verified, active Facebook Page linked to FBM

• Live public business website or social handle

• Official business info (name, address, website, brief description)

• Heyo virtual number (the only number type accepted for WABA)


2. Why a personal mobile number can’t be used

Meta’s onboarding requires several pre-configured settings for API traffic. Heyo virtual numbers meet those specs; personal SIM numbers do not.

Regular WhatsApp (personal or Business app) cannot run on a Heyo number, and non-Heyo numbers cannot be added to the Heyo WABA platform.



3. Step-by-step WABA setup

  1. Log in to the Heyo app → WhatsApp tab.
  2. Click Connect with Facebook.
  3. Log in to FBM and choose the correct Business Manager & Page.
  4. Fill Meta form: Business Name, Website, Description, Industry.
  5. Submit → status shows Pending Meta Review in Heyo.


4. Meta’s verification review & timeline

• Typical review: < 24 hours

• Manual review: up to 3 business days

• Heyo dashboard and e-mail display Approved or Rejected



5. Activate multi-agent chat

After approval:

  1. Heyo auto-links WABA to your business number.
  2. Go to Team Settings → Agents.
  3. Add staff and assign roles for the shared WhatsApp inbox. 


6. Expected outcome & success confirmation

• “WABA Activated” badge appears in Heyo.

• You can send templated or session messages.

• Calls + WhatsApp handled from one dashboard.



7. Common pitfalls

• New/inactive Facebook Pages are often rejected.

• Mismatched business names across docs, website, and Page.

• Trying to use a number already registered on WhatsApp.



8. Troubleshooting & support

• Rejected? Re-check Page activity & business data, then re-apply.

• FBM connection error? Log out/in, clear cache, or try Incognito.

• Need help? In-app chat or join the live demo (Mon–Fri, 2 PM IST).