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

# WhatsApp

> Connect a WhatsApp Business channel to BoundBot and route customer conversations to your bot.

export const BrowserWrapper = ({src, alt, title, description, height = '280px', caption, imgStyle = {}, children, imagePadding = '0px'}) => {
  const legacyDocsImagePrefix = '/images/';
  const productionDocsImagePrefix = '/docs/images';
  const rawSrc = typeof src === 'string' ? src : src && (src.src || src.default) || '';
  const imageSrc = rawSrc.startsWith(legacyDocsImagePrefix) ? `${productionDocsImagePrefix}/${rawSrc.slice(legacyDocsImagePrefix.length)}` : rawSrc;
  return <Frame caption={caption || alt || title} width="100%">
      <div style={{
    border: '1px solid #e2e8f0',
    borderRadius: '12px',
    overflow: 'hidden',
    boxShadow: '0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05)',
    width: '100%'
  }}>
        <div style={{
    backgroundColor: '#f8fafc',
    padding: '10px 15px',
    borderBottom: '1px solid #e2e8f0',
    display: 'flex',
    gap: '6px'
  }}>
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#ff5f56'
  }} />
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#ffbd2e'
  }} />
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#27c93f'
  }} />
        </div>
        <div style={{
    overflow: 'hidden',
    background: '#ffffff',
    width: '100%',
    padding: imagePadding
  }}>
          {src ? <img src={imageSrc} alt={alt || ''} data-docs-screenshot style={{
    ...imgStyle,
    width: '100%',
    minWidth: '100%',
    height: 'auto',
    display: 'block',
    borderRadius: '0px'
  }} /> : children ? children : null}
        </div>
      </div>
    </Frame>;
};

WhatsApp is available on Starter and above. BoundBot supports both Embedded Signup and redirect OAuth so you can connect a WhatsApp Business setup to a bot.

<BrowserWrapper src="../images/whatsapp-connect.png" alt="WhatsApp connection modal." caption="The WhatsApp connection modal with bot selection and signup options." />

## Recommended setup path

Use **Embedded Signup** if it is available in your environment. It keeps you inside the dashboard and opens the Meta flow in a popup.

Use **Redirect OAuth** as a fallback if popup-based signup is not available or you prefer a full redirect.

## Connect WhatsApp

1. Open <a href="https://www.boundbot.com/dashboard/channels/whatsapp" target="_blank" rel="noopener noreferrer"><b>Channels</b> -> <b>WhatsApp</b></a>.
2. Click **Connect channel**.
3. Select the bot that should answer on WhatsApp.
4. Click **Continue with Embedded Signup** or **Continue with Redirect OAuth**.
5. Complete the Meta authorization flow.
6. Select the correct WhatsApp Business Account and phone number if prompted.

## After connection

Once the setup is complete:

* confirm the channel status is healthy
* send a test message from WhatsApp
* verify the thread appears in <a href="https://www.boundbot.com/dashboard/inbox" target="_blank" rel="noopener noreferrer"><b>Inbox</b></a>
* confirm replies come from the correct bot

<Warning>
  WhatsApp setup depends on Meta account permissions and business assets. If the channel does not connect cleanly, check Meta permissions first before debugging BoundBot.
</Warning>

## Related pages

<CardGroup cols={2}>
  <Card title="Channels overview" icon="messages-square" href="/channels/overview">
    Compare WhatsApp with WebChat, Messenger, Telegram, Slack, and Discord.
  </Card>

  <Card title="Inbox" icon="inbox" href="/guides/inbox">
    Confirm inbound WhatsApp threads land in the shared conversation queue.
  </Card>

  <Card title="Workflows" icon="workflow" href="/automation/workflows">
    Add routing, lead capture, and follow-up logic after the channel is connected.
  </Card>

  <Card title="Plans and limits" icon="badge-dollar-sign" href="/reference/plans-and-limits">
    Review WhatsApp availability and channel limits on your current tier.
  </Card>
</CardGroup>