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

# Connect WhatsApp

> Link a WhatsApp Business number to a property so guest WhatsApp messages arrive in your Chats tab.

export const RoleNote = ({children}) => <Note>
    What you can see and do depends on your role on the property. If a button or
    screen described here isn't visible to you, ask a property Manager to check
    your role. See <a href="/team/roles-and-permissions">Roles & permissions</a>.
  </Note>;

Connect a WhatsApp Business number to a property and guest WhatsApp messages
land in the **Chats** tab, alongside your other guest conversations.

<RoleNote />

You set this up from the property's **Integrations** settings: open the
property's **Settings**, then tap **Integrations**. WhatsApp is the first card
under the **Messaging** section.

## Before you start

* You need a WhatsApp Business account (a Meta business) and a phone number you
  can use for WhatsApp. The number must not already be in use on a personal
  WhatsApp or WhatsApp Business app.
* The connection is set up through Meta's official sign-up flow, which opens in
  your device browser. Have your Meta login handy.

## Connect a number

<Steps>
  <Step title="Open Integrations">
    From the property's **Settings**, tap **Integrations**. The **WhatsApp**
    card sits under **Messaging** and shows its current status.
  </Step>

  <Step title="Start the connection">
    Tap **Connect WhatsApp**. Superhost opens Meta's sign-up flow in your
    device browser.
  </Step>

  <Step title="Sign up with Meta">
    In the browser, sign in to Meta and follow the steps to choose your
    WhatsApp Business account and the number you want to use. This part runs on
    Meta's pages, not in Superhost.
  </Step>

  <Step title="Return to the app">
    When you finish, the browser tells you you're done and you come back to the
    app. Open **Integrations** and the WhatsApp card takes it from there.
  </Step>

  <Step title="Let it finish">
    WhatsApp takes a few minutes to set the number up. The card shows a
    **setting up** badge and the **Connecting number** while that happens.

    You don't have to wait on this screen. Setup finishes whether the app is
    open or not, and the card shows an **active** status once the number is
    live.
  </Step>
</Steps>

<Note>
  The sign-up runs in your device browser because Meta's flow can't run inside
  the app. If you close the browser or cancel partway through, no number is
  linked — just tap **Connect WhatsApp** again to restart.
</Note>

## If WhatsApp asks for a code

WhatsApp sometimes wants proof you control the number before it will finish. It
sends a code to that number, either by text or by an automated call, and the
WhatsApp card asks you for it:

<Steps>
  <Step title="Find the code">
    Check the number you're connecting for a text or a call from WhatsApp. It
    can take a couple of minutes to arrive.
  </Step>

  <Step title="Enter it on the card">
    On the property's **Integrations** screen, the WhatsApp card shows **Enter
    the code sent to** your number. Type the code and tap **Submit**.
  </Step>

  <Step title="Wait for active">
    The card confirms the code was accepted and finishes the connection. It
    switches to an **active** status shortly after.
  </Step>
</Steps>

<Tip>
  If the code doesn't work, check it and try again — WhatsApp's codes expire, so
  request a fresh connection with **Reconnect** if yours has gone stale.
</Tip>

## What "connected" looks like

When a number is linked, the WhatsApp card shows:

* An **active** status badge.
* The **Connected number** in international format.
* A **Manage on WhatsApp Business** link that opens Meta's WhatsApp Manager,
  where the display name, profile photo, and quality rating live.

## Where guest messages go

Once WhatsApp is connected, messages guests send to that number arrive in the
**Chats** tab as guest conversations, so you can reply from the same place as
the rest of your guest messaging.

<CardGroup cols={2}>
  <Card title="Guest conversations" icon="comments" href="/messaging/conversations">
    See and reply to guest WhatsApp messages in the Chats tab.
  </Card>

  <Card title="Connect a phone number" icon="phone" href="/channels/connect-a-phone-number">
    Add a number for calls and SMS on this property.
  </Card>
</CardGroup>

## Reconnecting or fixing a connection

If the number ever needs re-linking, the card's button changes:

* **Reconnect** repeats the sign-up flow for an already-linked number.
* **Retry connection** appears if the last attempt ended in an error. The card
  shows what went wrong next to it, starting with **Couldn't connect** — for
  example when WhatsApp rejected the display name, or the number is already in
  use somewhere else. Fix that first, then retry.

<Tip>
  Use **Manage on WhatsApp Business** to update the display name, profile
  photo, or check the number's quality rating — those are managed by Meta, not
  in Superhost.
</Tip>