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

# WhatsApp

> Chat with the Vibewax agent over WhatsApp

Vibewax's WhatsApp connection lets you chat with the Vibewax agent from your phone. Send a message in WhatsApp, get a reply, keep working on your projects without opening the web app.

## What you can do

The WhatsApp agent works on the same projects you build in the web app. Anything you'd normally ask the agent to do, you can ask from WhatsApp:

- **Start a new project.** Describe what you want to build and the agent gets to work, just like in the web app.
- **Edit your existing projects.** Ask for changes, fixes, or new sections. If you have several projects and don't say which one, the agent will ask.
- **Publish and manage.** Publish a project, change its subdomain, or check what's live.
- **Ask quick questions.** Get help, ideas, or status updates without breaking your flow.

When the agent makes changes, its reply comes with an **Open preview** button, or **View live site** once the project is published, so you can check the result right away.

## What you can send

The agent works with whatever you send over WhatsApp:

- **Text messages.** Just type and send.
- **Voice messages.** Vibewax transcribes them and replies. Useful when typing isn't practical.
- **Images.** Send screenshots, mockups, or references the agent should look at.
- **Files.** PDFs and documents the agent can read and use.

Videos aren't supported.

## How to set it up

<Steps>
  <Step title="Open the Connections settings">
    In Vibewax, go to **Settings → Connections** and click **Connect** on the WhatsApp card.

    <img src="https://vibewax.be/docs/images/integrations_whatsapp_01.png" alt="Settings Connections WhatsApp card" width="1500" height="1000" />
  </Step>

  <Step title="Open WhatsApp">
    Vibewax shows a QR code and a connection link. Scan the QR code with your phone, or click **Open WhatsApp** to launch it on your computer or phone with the connection message pre-filled.
  </Step>

  <Step title="Send the connection message">
    Send the pre-filled `start [CODE]` message to Vibewax. If you scanned the QR code, type and send it from your phone.
  </Step>

  <Step title="Start chatting">
    Vibewax confirms the connection and shows the account it's linked to. You can now message the agent any time from WhatsApp.
  </Step>
</Steps>

The connection code is valid for 15 minutes. If it expires, generate a new one from the Connections settings.

## Bot commands

Send any of these in your WhatsApp chat with Vibewax:

| Command | What it does |
| ------- | ------------ |
| `/new` | Start a new conversation thread with the agent. |
| `/switch` | Switch to another connected workspace (shown when more than one is linked). |
| `/status` | Check the status of your connection and current chat. |
| `/unlink` | Disconnect a workspace from this chat. If several are connected, you pick which one. |
| `/help` | List the available commands. |

## Using several workspaces

You can connect the same WhatsApp number to up to 3 Vibewax workspaces. This is handy if you work across multiple workspaces and want to reach all of them from a single chat.

- **Connect another workspace.** Open **Settings → Connections** in the other workspace and connect it from the same WhatsApp number.
- **Switch the active workspace.** Send `/switch` and pick a workspace from the buttons. Your next message starts a fresh conversation there.
- **See which one is active.** Send `/status`. The reply leads with the active workspace's name.

Only one workspace is active at a time, so messages go to whichever workspace you last switched to. If you disconnect the active workspace, Vibewax automatically switches the chat to another connected workspace so it keeps working.

## Disconnecting

To disconnect, either send `/unlink` from WhatsApp, or open **Settings → Connections** in the app and remove the connected number.

If the chat is connected to just one workspace, it disconnects right away. If several are connected, `/unlink` asks which one to remove. Disconnecting a workspace you're not currently using leaves your conversation untouched, and disconnecting the active one switches the chat to another connected workspace.

## Good to know

- **No setup with Meta required.** You don't need a WhatsApp Business account or any API keys. Just connect from Settings and start chatting.
- **Credits work the same as in the web app.** The agent's work uses credits at the same rate as in the web app, plus a small extra amount when you send voice messages (for transcription).
- **Up to 3 workspaces per phone number.** You can link your WhatsApp number to several Vibewax workspaces (3 at most) and switch between them with `/switch`.
- **Voice message size limit.** Voice messages can be up to 10 MB. Longer recordings won't go through.


This page is part of the [Vibewax documentation](https://vibewax.be/docs/en/welcome/overview).