Evidence-led field guide
Connect your WhatsApp Business account
Prepare the Meta portfolio, WhatsApp Business Account, business number, profile, consent process, and authorized administrator before connection.
Do not begin with a live number until ownership, access, migration impact, and rollback are understood. The Connect WhatsApp control becomes available only after Balaawi completes Tech Provider approval and enables the tenant module.
Requirements before connecting
- Administrative access to the organization's Meta business portfolio.
- A WhatsApp Business Account, or authority to create one in the approved Meta flow.
- A stable business phone number controlled by the organization.
- Access to receive an SMS or voice verification code.
- The intended display name, square logo, business email, website, category, description, and address.
- A valid Meta payment method where Meta requires one.
- A documented customer opt-in and opt-out process.
- A Balaawi tenant owner or administrator with connection-management permission.
Connection steps after activation
- Sign in to Balaawi One as an authorized administrator.
- Open Settings, Integrations, then WhatsApp and select Connect WhatsApp.
- Sign in directly with Meta in the secure authorization window.
- Select the organization's correct Meta business portfolio.
- Select or create the correct WhatsApp Business Account.
- Add or select the controlled phone number and complete Meta verification.
- Review the display name and business profile information.
- Approve access only to the intended business assets.
- Run the Balaawi connection-health checks.
- Send a controlled test to an approved recipient before enabling wider use.
Before moving a live number
A number already used in the WhatsApp Business app or with another provider may need a Meta-supported migration or coexistence path. Confirm ownership, expected downtime, verification access, history expectations, dependencies, rollback, and the people authorized to approve the change.
Acceptance evidence
Retain the tenant identifier, masked number, Meta asset identifiers, administrator identity, authorization time, health-check result, test-recipient approval, test-message outcome, and the decision that enabled or rejected production use. Never place access tokens, passwords, verification codes, or customer message content in a support request.
Questions teams ask next
Why is Connect WhatsApp not visible?
The tenant module may still be disabled, Tech Provider approval may be incomplete, or the user may lack connection-management permission.
Does Balaawi receive the Facebook password?
No. Authentication takes place directly with Meta. Never send a password, access token, or verification code to Balaawi Support.
Can an existing WhatsApp Business app number be used?
It may be eligible for a Meta-supported migration or coexistence path. Review the current Meta rules and operational impact before changing a live number.
What should be tested first?
Validate authorization, number registration, webhook health, template visibility, permissions, tenant routing, and one controlled message to an approved recipient.
Source register
References used to bound this guide. External sources open in a new tab.
- Embedded SignupMeta for Developers
- Set up Webhooks for WhatsApp Business AccountsMeta for Developers
- WhatsApp message templatesMeta for Developers
- WhatsApp Business Platform pricingMeta for Developers
- Balaawi WhatsApp production-readiness recordBalaawi SystemsInternal record
Evidence standard: Source-governed educational record
Plan one bounded review