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

# Connect your first channel

> Set up WhatsApp, Instagram, Webchat, or Messenger to start receiving customer messages in Vambe.

## 🌐 What you'll build

You'll connect at least one communication channel to Vambe so customers can reach you through their preferred platform.

<Tip>
  Channels are where your customers will interact with your AI assistants and
  human agents. You can connect multiple channels to the same pipeline.
</Tip>

***

## Why Connect Channels?

Without connected channels, your AI assistants and pipelines can't receive real customer messages. Channels are the entry points where customers start conversations that flow through your sales funnels.

### Supported Channels

<CardGroup cols={2}>
  <Card title="WhatsApp" icon="whatsapp" color="#25D366">
    **Most popular for direct communication**

    * Personal, instant messaging
    * High engagement rates
    * Support for media, documents
    * Business API integration
  </Card>

  <Card title="Instagram" icon="instagram" color="#E4405F">
    **Perfect for social media engagement**

    * Comments and direct messages
    * Visual content support
    * Young demographic reach
    * Business profile integration
  </Card>

  <Card title="Webchat" icon="messages" color="#3B82F6">
    **Essential for website visitors**

    * Embedded on your website
    * Real-time visitor support
    * No app installation required
    * Professional appearance
  </Card>

  <Card title="Messenger" icon="facebook" color="#1877F2">
    **Great for Facebook users**

    * Facebook ecosystem integration
    * Automated responses
    * Rich media support
    * Business page connection
  </Card>
</CardGroup>

***

## Prerequisites

Before connecting channels, ensure you have:

* ✅ Completed the [Quickstart guide](/docs/quickstart)
* ✅ A Vambe account with **Owner** role
* ✅ Business accounts for the platforms you want to connect

<Warning>
  **Important:** You'll need business/professional accounts for WhatsApp
  Business API and Instagram Business. Personal accounts have limited
  functionality.
</Warning>

***

## Channel Setup Guides

Choose the channel that best fits your business needs and follow the detailed setup guide:

<AccordionGroup>
  <Accordion title="Platform Settings & Account Management" icon="gear">
    **Start here** - Learn how to manage your account and basic platform settings before connecting specific channels.

    <Card title="Account Setup Guide" icon="user-gear" href="https://www.skool.com/vambe/classroom/c8a9223e?md=4275437de7cd49e695abcb0fa1805e81">
      Comprehensive guide for managing your Vambe account, user permissions, and platform configuration.
    </Card>

    **What you'll learn:**

    * Account and user management
    * Permission and role configuration
    * Basic platform navigation
    * Security settings
  </Accordion>

  <Accordion title="WhatsApp Business API (Dual Numbers)" icon="whatsapp">
    **Advanced WhatsApp setup** - Connect multiple WhatsApp numbers to the same Vambe account for larger operations.

    <Card title="Dual WhatsApp API Setup" icon="phone-plus" href="https://www.skool.com/vambe/classroom/b9d85b56?md=8c0cf6cff5304cc2867752346ad661a6">
      Step-by-step guide for connecting two WhatsApp Business numbers to increase capacity and coverage.
    </Card>

    **Best for:**

    * Large businesses with high message volume
    * Multiple departments or regions
    * Redundancy and load distribution
    * A/B testing different approaches
  </Accordion>

  <Accordion title="WhatsApp Business API (Single Number)" icon="whatsapp">
    **Standard WhatsApp setup** - Connect one WhatsApp Business number for most businesses.

    <Card title="Single WhatsApp API Setup" icon="phone" href="https://www.skool.com/vambe/classroom/b9d85b56?md=78852de8849b4e039fe88411db8a2571">
      Complete guide for connecting your WhatsApp Business API to Vambe with full automation features.
    </Card>

    **Best for:**

    * Small to medium businesses
    * Single customer service team
    * Straightforward messaging needs
    * Getting started with WhatsApp automation
  </Accordion>

  <Accordion title="Instagram Business Integration" icon="instagram">
    **Social media engagement** - Connect Instagram to capture leads from comments and direct messages.

    <Card title="Instagram Connection Guide" icon="heart" href="https://www.skool.com/vambe/classroom/b9d85b56?md=2a6c6a138faa4082ba7cbf3d0b7d5266">
      Learn how to link your Instagram Business account for automated comment responses and DM management.
    </Card>

    **Features:**

    * Automatic comment responses
    * Direct message automation
    * Lead capture from social posts
    * Integration with your sales pipeline
  </Accordion>

  <Accordion title="WhatsApp QR Code (Quick Setup)" icon="qrcode">
    **Fastest setup option** - Get started immediately by scanning a QR code with your WhatsApp.

    <Card title="QR Code Setup Guide" icon="scan-line" href="https://www.skool.com/vambe/classroom/b9d85b56?md=49ca73a0cb8143a3a681e0dd59f4f8af">
      Quick setup method using QR code scanning - perfect for testing and small-scale operations.
    </Card>

    **Best for:**

    * Quick testing and setup
    * Small businesses
    * Personal WhatsApp numbers
    * Temporary or trial setups

    <Note>
      QR code setup has some limitations compared to Business API. For production use, consider the Business API options.
    </Note>
  </Accordion>
</AccordionGroup>

***

## Setup Process Overview

Regardless of which channel you choose, the general process follows these steps:

<Steps>
  <Step title="Prepare Your Accounts">
    * Ensure you have business accounts for your chosen platforms
    * Gather necessary credentials and permissions
    * Verify account ownership and admin access
  </Step>

  <Step title="Access Channel Settings">
    Navigate to your Vambe dashboard and find the channel configuration section.
  </Step>

  <Step title="Follow Platform-Specific Guide">
    Use the detailed guides above for your chosen channel. Each platform has
    unique requirements and steps.
  </Step>

  <Step title="Test Your Connection">
    * Send a test message to verify the connection works - Confirm messages appear
      in your Vambe dashboard - Test basic AI responses if you have a pipeline
      configured
  </Step>

  <Step title="Configure Channel Settings">
    * Set up welcome messages
    * Configure business hours
    * Customize automatic responses
    * Connect to your pipeline (if created)
  </Step>
</Steps>

***

## Multi-Channel Strategy

<Info>
  **Pro Tip:** You can connect multiple channels to the same pipeline, allowing
  customers to reach you through their preferred platform while maintaining
  consistent service.
</Info>

### Channel Selection Guide

| Business Type       | Recommended Channels           | Priority Order                      |
| ------------------- | ------------------------------ | ----------------------------------- |
| **E-commerce**      | WhatsApp + Webchat + Instagram | 1. Webchat 2. WhatsApp 3. Instagram |
| **B2B Services**    | WhatsApp + Webchat             | 1. WhatsApp 2. Webchat              |
| **Local Business**  | WhatsApp + Facebook Messenger  | 1. WhatsApp 2. Messenger            |
| **Content Creator** | Instagram + WhatsApp           | 1. Instagram 2. WhatsApp            |
| **SaaS/Tech**       | Webchat + WhatsApp             | 1. Webchat 2. WhatsApp              |

### Best Practices

<CardGroup cols={2}>
  <Card title="Consistent Messaging" icon="comments">
    * Use the same AI assistant across all channels
    * Maintain consistent tone and responses
    * Ensure brand voice is uniform
    * Train assistants with the same knowledge base
  </Card>

  <Card title="Channel-Specific Optimization" icon="gear">
    * Customize welcome messages per channel - Adjust response timing for platform
      norms - Use platform-specific features (e.g., Instagram Stories) - Respect
      platform communication styles
  </Card>

  <Card title="Performance Monitoring" icon="chart-line">
    * Track engagement rates per channel - Monitor response times and quality -
      Analyze conversion rates by source - Optimize based on channel performance
  </Card>

  <Card title="Customer Experience" icon="users">
    * Allow customers to choose their preferred channel
    * Provide consistent service quality everywhere
    * Maintain conversation history across sessions
    * Offer seamless handoffs between channels
  </Card>
</CardGroup>

***

## Troubleshooting Common Issues

<AccordionGroup>
  <Accordion title="Connection Failed" icon="alert-triangle">
    **If your channel won't connect:**

    * Verify you have admin/owner permissions on the platform account
    * Check that business verification is complete (for WhatsApp/Instagram Business)
    * Ensure you're using the correct credentials
    * Try disconnecting and reconnecting
    * Contact support if issues persist
  </Accordion>

  <Accordion title="Messages Not Appearing" icon="message-x">
    **If messages aren't showing in Vambe:**

    * Confirm the channel connection is active (green status)
    * Check webhook configurations are correct
    * Verify message permissions are granted
    * Test with a simple text message first
    * Review platform API status pages
  </Accordion>

  <Accordion title="AI Not Responding" icon="bot-off">
    **If your AI assistant isn't replying:**

    * Ensure you have a pipeline configured and connected
    * Check that your AI assistant has training data
    * Verify API key permissions are sufficient
    * Test with simple, clear messages
    * Review your pipeline trigger conditions
  </Accordion>
</AccordionGroup>

***

## Get Your Channel IDs

Once your channels are connected, you can retrieve their IDs using the Vambe API. This is useful for integrations, webhooks, and analytics tracking.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    -H "x-api-key: YOUR_API_KEY" \
    https://api.vambe.me/api/public/channels/{channelType}
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.vambe.me/api/public/channels/whatsapp',
    {
      headers: { 'x-api-key': process.env.VAMBE_API_KEY },
    },
  );
  const channel = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
    'https://api.vambe.me/api/public/channels/whatsapp',
    headers={'x-api-key': os.environ['VAMBE_API_KEY']}
  )
  channel = response.json()
  ```
</CodeGroup>

### Available Channel Types

| Channel Type | Description                 | API Parameter  |
| ------------ | --------------------------- | -------------- |
| WhatsApp     | WhatsApp Business API or QR | `whatsapp`     |
| Instagram    | Instagram Business          | `instagram`    |
| Webchat      | Website embedded chat       | `web-whatsapp` |
| Messenger    | Facebook Messenger          | `playground`   |

### Expected Response

```json theme={null}
{
  "id": "channel_abc123",
  "type": "whatsapp",
  "name": "WhatsApp Business",
  "status": "connected",
  "created_at": "2025-01-01T12:00:00Z",
  "settings": {
    "phone_number": "+1234567890",
    "business_verified": true
  }
}
```

<Tip>
  Save your channel IDs - you'll need them for webhook configurations, analytics
  tracking, and API integrations.
</Tip>

***

## Next Steps

<Check>
  Congratulations! Your channel is now connected and ready to receive customer
  messages.
</Check>

Now you can:

<CardGroup cols={2}>
  <Card title="Create Your First Pipeline" icon="sitemap" href="/docs/create-pipeline">
    Build AI-powered sales funnels to automatically handle customer conversations
  </Card>

  <Card title="Configure AI Assistants" icon="brain" href="/docs/create-pipeline">
    Train your AI with company knowledge and sales processes
  </Card>

  <Card title="Set Up Webhooks" icon="webhook" href="/docs/webhooks">
    Get real-time notifications when customers message you
  </Card>

  <Card title="Monitor Analytics" icon="chart-line" href="/docs/analytics">
    Track performance and optimize your customer interactions
  </Card>
</CardGroup>

<Info>
  **Need help?** Each platform guide includes troubleshooting steps and common
  solutions. For additional support, contact our team or check the community
  forums.
</Info>