Skip to content

Bring Your Own Number (BYON) Setup Guide

Connect your existing WhatsApp Business number to Vobiz using the BYON (Bring Your Own Number) method. This comprehensive guide walks you through the entire setup process with detailed screenshots and instructions.

⏱️ 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

Note: The phone number you use cannot be currently registered with WhatsApp or WhatsApp Business app. If it is, you'll need to delete that account first.

Step 1Meta Business Manager Setup

  1. 1. Access Meta Business Settings

    Go to business.facebook.com and log in with your Facebook account

  2. 2. Create or Select Business

    If you don't have a business, click "Create Account" and fill in your business details. Otherwise, select your existing business from the dropdown.

Step 2Create WhatsApp Business Account

  1. 1. Navigate to WhatsApp Accounts

    • • Click on the menu icon (☰) in the top-left corner
    • • Select "Accounts""WhatsApp Accounts"
    • • Click "Add" button
  2. 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. 3. Save WABA ID

    After creation, you'll see your WhatsApp Business Account ID (WABA ID). Copy this - you'll need it later for Vobiz connection.

    The WABA ID is a numeric value, typically 15-17 digits long. Example: 102290129340398

Step 3Add and Verify Phone Number

  1. 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. 2. Verify Phone Number

    Enter the 6-digit verification code you receive via SMS or voice call

    ✓ Success: Once verified, your phone number will show a green checkmark.

  3. 3. Save Phone Number ID

    Click on your phone number to view details. Copy the Phone Number ID - you'll need this for Vobiz.

    The Phone Number ID is a numeric value. Example: 106540932419283

Step 4Create System User & Access Token

  1. 1. Create System User

    • • Go to Business SettingsUsersSystem Users
    • • Click "Add"
    • • Enter a name (e.g., "Vobiz Integration")
    • • Set role to "Admin"
    • • Click "Create System User"
  2. 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. 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"

    ⚠️ Important: Copy the access token immediately and store it securely. You won't be able to see it again! This token provides full access to your WhatsApp Business Account.

Step 5Connect to Vobiz

  1. 1. Open Vobiz Console

    • • Log in to console.vobiz.ai
    • • Go to MessagingChannels
    • • Click "Connect Channel"
    • • Select "Bring Your Own Number (BYON)"
  2. 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

    EAAxxxxxx... (starts with EAA)

    Display Name

    How your business name appears to customers

    Example: "Acme Corp Support"
  3. 3. Verify and Connect

    Click "Connect Channel". Vobiz will verify your credentials and establish the connection.

    ✓ Success: 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 doesn't have required permissions
  • • System user doesn't 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 doesn't 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're still experiencing issues, our support team is here to help.

Contact Support →