> ## Documentation Index
> Fetch the complete documentation index at: https://docs.callkaro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Connect

> Connect your Meta WhatsApp Business Account

## Overview

Callkaro provides 3 WhatsApp integrations:

1. **WhatsApp (Facebook)** - Direct Meta integration
2. **Heltar** - Third-party WhatsApp provider
3. **AI Sensy** - Third-party WhatsApp provider

This guide covers **WhatsApp (Facebook)** signup and connection.

***

## Signup Process

<Steps>
  <Step title="Navigate to Signup Page">
    Go to **Dashboard → WhatsApp → Signup**

    Or visit: `https://callkaro.ai/dashboard/whatsapp/signup`
  </Step>

  <Step title="Choose Signup Method">
    **Option 1:** Contact Callkaro Support to enable WhatsApp

    **Option 2:** Click **"Continue with Facebook"** to connect your Meta account
  </Step>

  <Step title="Set Up Business Information">
    In the Facebook popup:

    * Enter your **Business Name**
    * Fill in required business details
    * Confirm and proceed
  </Step>

  <Step title="Add Phone Number">
    Choose phone number method:

    **Option A: Use Your Own Number**

    * Must NOT be connected to WhatsApp yet
    * Will receive OTP via SMS/Call

    **Option B: Use Callkaro Phone Number**

    1. [Purchase a phone number](/phone-numbers/buy-phone-number)
    2. Create a new agent
    3. Set the purchased number as **inbound number** for that agent
    4. Use this number during signup
    5. Receive OTP via phone call to the agent
    6. Wait for call recording in Call Details
    7. Listen to call recording to get OTP
  </Step>

  <Step title="Enter OTP">
    * Enter the 6-digit OTP received
    * Complete verification
  </Step>

  <Step title="Complete Signup">
    Follow remaining setup steps in Facebook flow
  </Step>
</Steps>

<Warning>
  **Important:** The WhatsApp Business Account you connect must NOT be connected to any other Callkaro account. Each WABA can only link to one Callkaro account.
</Warning>

***

## Phone Number Options

### Option 1: Your Own Phone Number

**Requirements:**

* Phone number NOT registered on regular WhatsApp
* Active SIM with network
* Ability to receive SMS/calls

**When to Use:**

* Quick testing
* You have a spare number
* Don't want to purchase Callkaro number

***

### Option 2: Callkaro Phone Number

**Steps:**

1. Buy phone number from [Phone Numbers](/phone-numbers/buy-phone-number)
2. Create agent: **Agents → Create New Agent**
3. Configure agent's inbound number as the purchased number
4. Use this number during WhatsApp signup
5. OTP will call your agent
6. Check **Call History** for the recording
7. Listen to recording to hear the OTP
8. Enter OTP in signup form

**When to Use:**

* You don't have a spare personal number
* Need dedicated business number
* Want better control

<Tip>
  Call recordings typically appear within 4-5 minutes after the OTP call.
</Tip>

***

## Post-Signup Requirements

### To Send Messages

Your account must have:

* ✅ **Payment method added** (Card + GST details)
* ✅ **Business verification completed**

**How to Add:**

1. Go to [business.facebook.com](https://business.facebook.com)
2. Choose your App
3. Settings → Business Settings → WhatsApp Accounts
4. Select your WhatsApp Account
5. Scroll to **"Verify Business"** and complete

<Note>
  Payment method and business verification are required before you can create templates and send messages at scale.
</Note>

***

### To Receive Messages

Click the **"Subscribe"** button on the WhatsApp page to enable inbound messages.

**Steps:**

1. Go to **Dashboard → WhatsApp**
2. If connected, you'll see **"Subscribe"** button
3. Click to activate inbound message receiving
4. Status changes to ✅ **Subscribed**

***

## Verification Checklist

After signup, verify your setup:

<AccordionGroup>
  <Accordion title="Check Connection Status" icon="link">
    * ✅ WABA ID displayed on WhatsApp page
    * ✅ Account name showing correctly
    * ✅ WhatsApp enabled indicator
  </Accordion>

  <Accordion title="Verify Phone Number" icon="phone">
    Go to **Phone Numbers** page:

    * Check `provider_type` column
    * Should show **`CLOUD_API`**
    * If not, click **"Verify"** in Actions column
  </Accordion>

  <Accordion title="Subscribe for Inbound" icon="message">
    * Click **"Subscribe"** button
    * Confirm subscription status: ✅ Subscribed
  </Accordion>

  <Accordion title="Setup Payment & Verification" icon="credit-card">
    In Meta Business Manager:

    * Add payment method (Card + GST)
    * Complete business verification
    * Wait for approval
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Templates" icon="file-lines">
    Learn how to create WhatsApp message templates (Coming soon)
  </Card>

  <Card title="Phone Numbers" icon="hashtag">
    Manage your WhatsApp phone numbers (Coming soon)
  </Card>

  <Card title="Heltar Integration" icon="whatsapp" href="/integrations/heltar">
    Alternative WhatsApp provider
  </Card>

  <Card title="AI Sensy Integration" icon="whatsapp" href="/integrations/aisensy">
    Another WhatsApp provider option
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Popup blocked on Continue with Facebook" icon="window-maximize">
    **Solution:**

    * Allow popups in your browser
    * Refresh page and try again
  </Accordion>

  <Accordion title="OTP not received" icon="envelope">
    **Check:**

    * SIM has active network
    * Number not in regular WhatsApp
    * Wait 4-5 minutes and retry

    **For Callkaro numbers:**

    * Verify agent is set up correctly
    * Check inbound number configured
    * Look in Call History for recording
  </Accordion>

  <Accordion title="Phone number already in use" icon="ban">
    **Issue:** Number already connected to WhatsApp Business

    **Solution:**

    * Use a different number
    * Or migrate existing WhatsApp Business to Callkaro
  </Accordion>

  <Accordion title="Cannot create/send templates" icon="file-circle-xmark">
    **Cause:** Payment method or business verification not complete

    **Solution:**

    * Complete payment setup in Meta Business Manager
    * Finish business verification process
    * Wait for Meta approval
  </Accordion>

  <Accordion title="Number shows non-CLOUD_API" icon="triangle-exclamation">
    **Solution:**

    * Go to Phone Numbers page
    * Find your number
    * Click **"Verify"** in Actions column
    * Follow prompts to switch provider type
  </Accordion>

  <Accordion title="WABA already connected to another account" icon="link-slash">
    **Issue:** This WhatsApp Business Account is linked to another Callkaro account

    **Solution:**

    * Disconnect from other account first
    * Or use a different WABA
    * Contact Callkaro support if you own both accounts
  </Accordion>
</AccordionGroup>

***

## Important Notes

<Warning>
  **One WABA per Account:** Each WhatsApp Business Account can only be connected to ONE Callkaro account. Attempting to connect the same WABA to multiple accounts will fail.
</Warning>

<Note>
  **Call Recordings for OTP:** When using Callkaro phone numbers for OTP, call recordings typically appear within 1-2 minutes. Check the Call Details page under the inbound agent's call history.
</Note>

<Tip>
  **Business Verification:** Start the business verification process early. It can take several days for Meta to approve, and you'll need it to send messages at scale.
</Tip>

***

## Getting Help

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset">
    Get help with WhatsApp signup and configuration
  </Card>

  <Card title="Meta Business Help" icon="meta" href="https://business.facebook.com/help">
    Meta Business Manager support
  </Card>
</CardGroup>