> For the complete documentation index, see [llms.txt](https://dataqueue.gitbook.io/voicehub-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dataqueue.gitbook.io/voicehub-docs/integrations/connect-your-meta-business-account.md).

# Connect Your Meta Business Account

### Step 1: Meta Business Manager Setup <a href="#step-1-meta-business-manager-setup" id="step-1-meta-business-manager-setup"></a>

#### Meta Business Manager <a href="#meta-business-manager" id="meta-business-manager"></a>

**If you don't have a Meta Business Manager account:**

* Visit [business.facebook.com](https://business.facebook.com/) to create your account
* Complete business verification with required documentation
* Add business information and payment method

**If you already have a Meta Business Manager account:**

* Ensure you have Admin access to proceed with the integration

**For all users:**

* In Meta Business Manager, go to Business Settings > Business Info
* Note down your Facebook Business ID (needed for VoiceHub integration)

### Step 2: WhatsApp Business Account Setup <a href="#step-2-whatsapp-business-account-setup" id="step-2-whatsapp-business-account-setup"></a>

**If you don't have a WhatsApp Business Account:**

* In Meta Business Manager, go to Business Settings > Accounts > WhatsApp Business Accounts
* Click "Add" and select "Create a new WhatsApp Business Account"
* Enter your business phone number
* Verify phone number ownership through SMS or call
* Complete business verification process through Meta Business Manager

**If you already have a WhatsApp Business Account:**

* Ensure your WhatsApp Business Account is connected to Meta Business Manager

### Step 3: Create Developer App <a href="#step-3-create-developer-app" id="step-3-create-developer-app"></a>

* Go to [developers.facebook.com](https://developers.facebook.com/)
* Log in with your Meta Business Manager account
* Click "Create App" and select "Business" type
* Enter app name: `[Your Company] Dataqueue Integration`
* Enter your business contact email
* Select "Other" as the use case
* In the "Business portfolio" dropdown, select your correct Meta Business Manager
* Click "Create App"
* Once the app is created, find "WhatsApp" in the products list
* Click "Set up" next to WhatsApp to enable WhatsApp connection for your app
* Go to App Settings > Basic to find your App ID and App Secret
* Copy and save both App ID and App Secret securely (needed for VoiceHub integration)

### Step 4: System User & Access Token Setup <a href="#step-4-system-user--access-token-setup" id="step-4-system-user--access-token-setup"></a>

1. **Set Up System User**
   * In Meta Business Manager, go to Business Settings > Users > System Users
   * Click "Add" and create new system user
   * Set user type to "Admin"
   * Name: `Dataqueue VoiceHub Integration`
   * Assign your Developer App to the system user
   * Assign your WhatsApp Business Account to the system user
2. **Generate Access Token**
   * In System User settings, click "Generate New Token"
   * Select your Developer App
   * Set expiration to "Never"
   * Select permissions:
     * `business_management`
     * `whatsapp_business_messaging`
     * `whatsapp_business_management`
   * Save the access token securely

### Step 5: Connect to VoiceHub <a href="#step-5-connect-to-voicehub" id="step-5-connect-to-voicehub"></a>

1. **Gather Required Information**
   * Facebook Business ID (from Meta Business Manager)
   * App ID and App Secret (from Step 3)
   * System User Access Token (from Step 4.2)
2. **Complete Integration in VoiceHub**
   * Log into your VoiceHub dashboard
   * Navigate to Channels > Meta
   * Click "Add Meta Connection"
   * Enter your Facebook Business ID
   * Enter your App ID
   * Enter your App Secret
   * Enter your Access Token
   * Click "Connect Account"

### Next Steps

After successful integration, the system will automatically sync your WhatsApp business numbers. You can then:

* Access your WhatsApp numbers in VoiceHub
* Use these numbers when setting up your agents
* Configure agent-specific WhatsApp settings