Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

← Back to Channel Management

​
Time Required

15–20 minutes to complete all steps if you have Meta Business Manager access.

​
Why Choose BYON?

  • Keep your existing business phone number
  • No additional number costs
  • Full control over your WhatsApp Business Account
  • Direct integration with Meta’s platform

​
Prerequisites

Before starting, ensure you have:
  • Meta Business Manager Account - Create one at business.facebook.com.
  • Phone Number - A phone number that can receive SMS or voice calls for verification.
  • Admin Access - Admin or Developer role in Meta Business Manager.
  • Vobiz Account - Active account at console.vobiz.ai.
The phone number you use cannot be currently registered with WhatsApp or WhatsApp Business app.

​
Step 1: Set Up Meta Business Manager

  1. Access Meta Business Settings - Go to business.facebook.com and log in with your Facebook account.
  2. Create or Select Business - If you do not have a business, click Create Account and fill in your business details. Otherwise, select your existing business from the dropdown.

​
Step 2: Create a WhatsApp Business Account (WABA)

​
1. Navigate to WhatsApp Accounts

  • Click on the menu icon in the top-left corner.
  • Select Accounts → WhatsApp Accounts.
  • Click the Add button.

​
2. Create WhatsApp Business Account

Fill in the following information:
  • WhatsApp Business Account Name - Your business name.
  • Business Manager - Select your business.
  • Time Zone - Your business timezone.

​
3. Save WABA ID

After creation, you will see your WhatsApp Business Account ID (WABA ID). Copy it - you will need it later to connect to Vobiz. The WABA ID is a numeric value, typically 15–17 digits. Example: 102290129340398.

​
Step 3: Add and Verify Phone Number

​
1. Add Phone Number

  • In your WhatsApp Business Account, click Add phone number.
  • Enter your phone number in international format (e.g., +1 234 567 8900).
  • Select verification method: SMS or Voice call.

​
2. Verify Phone Number

Enter the 6-digit verification code you receive via SMS or voice call.
Once verified, your phone number will show a green checkmark.

​
3. Save Phone Number ID

Click on your phone number to view details. Copy the Phone Number ID - you will need it for Vobiz. The Phone Number ID is a numeric value. Example: 106540932419283.

​
Step 4: Generate System User Access Token

​
1. Create System User

  • Go to Business Settings → Users → System Users.
  • Click Add.
  • Enter a name (e.g., “Vobiz Integration”).
  • Set role to Admin.
  • Click Create System User.

​
2. Assign WhatsApp Account to System User

  • Click on your newly created system user.
  • Click Add Assets.
  • Select WhatsApp Accounts.
  • Select your WhatsApp Business Account.
  • Enable Full control permission.
  • Click Save Changes.

​
3. Generate Access Token

  • In the system user settings, click Generate New Token.
  • Select your app (or create a new one if needed).
  • Select the following permissions:
    • whatsapp_business_messaging
    • whatsapp_business_management
  • Click Generate Token.
Copy the access token immediately and store it securely. You will not be able to see it again. This token provides full access to your WhatsApp Business Account.

​
Step 5: Connect to Vobiz

​
1. Open Vobiz Console

  • Log in to console.vobiz.ai.
  • Go to Messaging → Channels.
  • Click Connect Channel.
  • Select Bring Your Own Number (BYON).

​
2. Enter Connection Details

Fill in the form with the information you collected from Meta:
  • WABA ID - Your WhatsApp Business Account ID from Step 2 (example: 102290129340398).
  • Phone Number ID - Your phone number ID from Step 3 (example: 106540932419283).
  • Access Token - System user access token from Step 4 (starts with EAA...).
  • Display Name - How your business name appears to customers (example: Acme Corp Support).

​
3. Verify and Connect

Click Connect Channel. Vobiz will verify your credentials and establish the connection.
If all credentials are correct, your channel will be connected and appear in your channels list with a “Connected” status.

​
Troubleshooting

​
”Invalid Access Token” Error

Possible causes:
  • Token expired or was regenerated.
  • Token does not have the required permissions.
  • System user does not have access to the WhatsApp account.
Solution:
  • Generate a new access token with correct permissions.
  • Verify system user has “Full control” on the WhatsApp account.
  • Ensure you copied the complete token without extra spaces.

​
”Phone Number Not Found” Error

Possible causes:
  • Incorrect Phone Number ID.
  • Phone number not verified in Meta.
  • Phone number not associated with the WABA.
Solution:
  • Double-check the Phone Number ID from Meta Business Manager.
  • Ensure phone number is verified (green checkmark).
  • Confirm phone number is under the correct WABA.

​
”WABA Not Accessible” Error

Possible causes:
  • Incorrect WABA ID.
  • WABA is suspended or restricted.
  • System user does not have access.
Solution:
  • Verify the WABA ID from Meta Business Settings.
  • Check WABA status in Meta Business Manager.
  • Ensure system user has been assigned to the WABA.

​
Can’t Generate Access Token

Possible causes:
  • No app created in Meta for Developers.
  • Insufficient permissions in Business Manager.
Solution:
  • Create a Meta app at developers.facebook.com.
  • Add WhatsApp product to your app.
  • Ensure you have Admin role in Business Manager.

​
Need More Help?

If you are still experiencing issues, our support team is here to help. Contact Support →