Connect Meta (WhatsApp)

Link your Meta Business account to Voxvaani to enable WhatsApp messaging. The platform uses Meta’s OAuth 2.0 flow for secure authentication, giving Voxvaani the permissions it needs to sync templates, send messages, and manage conversations on your behalf.

Overview

The connection process automatically discovers your Meta Business Manager, WhatsApp Business Account (WABA), and registered phone numbers. If your account has exactly one of each, Voxvaani configures everything automatically. If you manage multiple businesses or have more than one WABA, the system presents a selection interface so you can choose the correct configuration.

Detailed Prerequisites

Before connecting, ensure the following are complete in your Meta account:

1. Business Manager Account Created and Verified

   • Navigate to business.facebook.com  and sign in.
   • Complete business verification if not already done. Meta requires legal business name, address, and supporting documents (e.g., business license, tax ID).
   • Verification typically takes 2–7 business days.

2. WhatsApp Business Account (WABA) Created

   • Inside your Business Manager, go to Accounts → WhatsApp Accounts and click Add.
   • Follow Meta’s steps to create a WABA. You will need to provide a display name that matches your business.
   • Meta reviews WABA display names for compliance. Ensure your display name uses your registered business name.

3. Phone Number Registered with Your WABA

   • The phone number must not be registered with WhatsApp Messenger or another WhatsApp Business account.
   • You will receive a verification code via SMS or voice call. Have access to the phone during setup.
   • Once verified, the number is associated with your WABA and ready for API use.

4. Two-Factor Authentication Enabled

   • Meta may require two-factor authentication on the Facebook account used to manage the Business Manager.
   • Enable 2FA under Facebook → Settings → Security and Login before initiating the OAuth flow.

Connection Process

Step-by-Step

1. Navigate to WhatsApp Suite → WhatsApp Settings in the sidebar.
2. Click Connect with Meta.
3. You will be redirected to Meta’s OAuth consent screen at facebook.com/dialog/oauth.
4. Log in to your Meta/Facebook account if not already authenticated.
5. Review the permissions that Voxvaani requests (see “What Permissions Voxvaani Accesses” below).
6. Click Continue or Allow to grant access.
7. You will be redirected back to Voxvaani where the system processes the authorization.

Automatic Configuration

After successful OAuth, Voxvaani inspects your Meta account:

• Exactly 1 Business Manager + 1 WABA + 1 Phone Number → Voxvaani auto-configures instantly. No further action is needed.
• The system saves the config and enables WhatsApp features immediately. Templates must be synced manually from the Templates page.

Manual Selection

If multiple businesses, WABAs, or phone numbers are found, the manual selection flow appears:

1. Select the Business Manager from the dropdown. If you see multiple entries, choose the one that contains your WhatsApp assets.
2. Select the WhatsApp Business Account. All WABAs under the chosen Business Manager are listed.
3. Select the Phone Number. Only numbers registered under the selected WABA appear.
4. Click Save Configuration to complete the setup.

Decision Flow

The following diagram illustrates the logic:

What Permissions Voxvaani Accesses

When you authenticate via OAuth, Voxvaani requests the following permissions from Meta:

Voxvaani does not access your Facebook pages, ad accounts, Instagram, or any data beyond what is necessary for WhatsApp messaging.

Verification: How to Confirm Connection

After completing the connection, verify that everything is configured correctly:

1. Check Connection Status — Navigate to WhatsApp Suite → WhatsApp Settings. The page should show “Connected” with your WABA name and phone number displayed.
2. Template Sync — Go to WhatsApp → Templates and click Sync Templates to manually sync your approved templates. Templates are not automatically synced after connecting.
3. Send a Test Message — Use a campaign or the inbox to send a test message to a verified phone number. Confirm the message is delivered and appears in the analytics.
4. Check Inbox — Send a message from a test WhatsApp number to your connected business number. Confirm it appears in the Voxvaani inbox within a few seconds.

If any of these verification steps fail, refer to the troubleshooting section below.

Disconnecting and Reconnecting

Disconnecting

To disconnect your Meta account from Voxvaani:

1. Navigate to WhatsApp Suite → WhatsApp Settings.
2. Click Disconnect.
3. Confirm the action in the prompt.

Disconnecting removes the stored access token and stops all WhatsApp features (campaigns, inbox, automation). Your Voxvaani data (campaign logs, conversation history, analytics) is preserved and will be available if you reconnect.

Reconnecting

You can reconnect at any time using the same Connect with Meta button. The OAuth flow works identically whether it is a first-time connection or a reconnection. After reconnecting:

• Previously synced templates will be refreshed.
• The inbox will resume receiving new incoming messages.
• Campaigns and automation rules can be re-enabled manually.

Switching to a Different Business or WABA

If you need to switch to a different Business Manager or WABA:

1. Disconnect the current configuration.
2. Click Connect with Meta again.
3. During OAuth, ensure you are logged into the Meta account that has access to the desired Business Manager.
4. Use the manual selection flow to choose the correct Business, WABA, and phone number.

Troubleshooting

OAuth Window Does Not Open

Symptom: Clicking “Connect with Meta” produces no response or the redirect page fails to load.

Possible Causes and Solutions:

• Pop-up Blocker Active: Disable your browser’s pop-up blocker for the Voxvaani domain. Most browsers let you allow pop-ups per-site via the address bar icon.
• Ad Blocker Interference: Temporarily disable ad/tracker blocking browser extensions and try again.
• Network Restrictions: Some corporate networks block Meta domains. Try connecting from an unrestricted network or ask your IT administrator to whitelist facebook.com and *.facebook.com.

No Businesses or WABAs Found After OAuth

Symptom: OAuth succeeds but Voxvaani shows “No businesses found” or the dropdown is empty.

Possible Causes and Solutions:

• Meta Account Not Set Up: Your Facebook account may not have a Business Manager or WABA. Create these in Meta Business Suite  first.
• Wrong Facebook Account: You may have authenticated with a personal Facebook account that is not associated with your Business Manager. Log out and reconnect, ensuring you choose the correct account.
• Insufficient Permissions: Your Facebook account may not have access to the Business Manager. Ask the Business Manager admin to add you under Settings → People with at least “Employee” access.
• Newly Created Assets: If you just created your WABA or phone number, Meta may take a few minutes to propagate the changes. Wait 5–10 minutes and try again.

Configuration Fails After OAuth

Symptom: OAuth succeeds and businesses are listed, but saving the configuration produces an error.

Possible Causes and Solutions:

• Missing Admin Access: You may have viewer or employee access but not admin access. Voxvaani requires admin permissions to manage messaging. Upgrade your role in Meta Business Suite → Settings → People.
• Phone Number Not Verified: The selected phone number may still be pending verification in Meta. Complete phone number verification in your WABA settings before attempting to configure it in Voxvaani.
• Expired or Invalid Token: The OAuth token may have been issued but immediately invalidated. Try the connection again from scratch.

Templates Not Syncing After Connection

Symptom: Connection is successful but no templates appear in Voxvaani, or the sync fails.

Possible Causes and Solutions:

• No Templates in WABA: Your WABA may have no approved templates. Create templates in Meta Business Manager under WhatsApp → Template Manager and submit them for review.
• All Templates Pending or Rejected: Only Meta-approved templates are synced. Check the status of your templates in Meta. Pending or rejected templates will not appear in Voxvaani.
• Sync Delay: The initial sync after connection can take up to 60 seconds. Wait a moment and refresh the templates page.
• Manual Sync Needed: Click Sync Templates on the templates page to trigger a manual refresh.

Connection Works Initially but Stops Later

Symptom: WhatsApp features work for a period, then fail with authentication errors.

Possible Causes and Solutions:

• Token Expired: Meta access tokens have a limited lifespan. If the token expires, Voxvaani may not be able to refresh it automatically. Disconnect and reconnect to obtain a new token.
• Token Revoked: You or another admin may have removed Voxvaani’s access from the Meta side (under Settings → Business Integrations → Voxvaani). Reauthorize by reconnecting.
• Password Changed: Changing your Facebook password invalidates all existing tokens. Reconnect to obtain a fresh token.
• Meta Policy Violation: If your WABA is restricted by Meta due to policy violations, Voxvaani’s API calls will fail. Check your account health in Meta Business Manager → WhatsApp → Account Health.

Related Articles

• WhatsApp Campaigns
• Message Templates
• WhatsApp Analytics