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

# WhatsApp

> Connect your UltraClaw AI assistant to WhatsApp. QR scan pairing from your dashboard.

# WhatsApp

Connect your UltraClaw AI agent to WhatsApp and chat from the messaging app used by over 2 billion people worldwide. If WhatsApp is your go-to messenger, this channel lets you talk to your agent without switching apps.

## How It Works

WhatsApp connects via QR code pairing from your UltraClaw dashboard. Once paired, your agent appears as a WhatsApp contact that you can message directly.

<Steps>
  <Step title="Open your dashboard">
    Go to [ultraclaw.ai/dashboard](https://ultraclaw.ai/dashboard) and navigate to **Channels**.
  </Step>

  <Step title="Click Connect WhatsApp">
    A QR code will appear on screen.
  </Step>

  <Step title="Scan the QR code">
    Open WhatsApp on your phone → **Settings** → **Linked Devices** → **Link a Device** → scan the QR code displayed on your dashboard.
  </Step>

  <Step title="Start chatting">
    Once paired, your agent will send a confirmation message in WhatsApp. You're all set.
  </Step>
</Steps>

## Configuration

### Allowlists

Control who can message your agent on WhatsApp. By default, only your phone number is allowed. Add additional numbers from the dashboard if you want family members or colleagues to have access.

### Group Policies

Similar to Telegram, you can configure how your agent behaves in WhatsApp group chats:

* **Respond to all messages** — replies to everything in the group
* **Respond when mentioned** — replies only when tagged
* **Disabled** — ignores group messages

## Features

* **Text messages** — full conversational AI, same as all other channels
* **Images and photos** — share pictures for your agent to analyze
* **Documents** — send PDFs, spreadsheets, and other files
* **Voice notes** — send audio messages for transcription and response
* **Location sharing** — share your location for context-aware responses

## Limitations

<AccordionGroup>
  <Accordion title="Session re-pairing">
    WhatsApp linked device sessions can occasionally disconnect, especially after WhatsApp app updates or extended periods without use. If this happens, simply re-scan the QR code from your dashboard to reconnect.
  </Accordion>

  <Accordion title="Session duration">
    WhatsApp linked device sessions remain active as long as your phone has an internet connection and the WhatsApp app is running. If your phone is off for an extended period, re-pairing may be required.
  </Accordion>

  <Accordion title="Rich formatting">
    WhatsApp supports basic formatting (bold, italic, strikethrough, monospace) but not full markdown. Complex tables and code blocks render better in [Web Chat](/channels/webchat).
  </Accordion>
</AccordionGroup>

<Tip>
  For maximum reliability, pair WhatsApp with [Telegram](/channels/telegram) as a backup. Telegram's connection is more resilient and doesn't require re-pairing.
</Tip>

## Best For

WhatsApp is the ideal primary channel if:

* WhatsApp is your most-used messaging app
* You communicate primarily with people who use WhatsApp
* You want your AI agent alongside your existing WhatsApp conversations
* You need a channel that works great on both Android and iPhone

## Next Steps

<CardGroup cols={2}>
  <Card title="Add Telegram as Backup" icon="paper-plane" href="/channels/telegram">
    Add Telegram for a more resilient backup channel.
  </Card>

  <Card title="Compare Channels" icon="table-columns" href="/channels/comparison">
    See how WhatsApp compares to other channels.
  </Card>
</CardGroup>