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

# Add and Connect WhatsApp Numbers in Pilot Status Dashboard

> Add official or unofficial WhatsApp numbers to Pilot Status. Supports Meta Cloud API, Coexistence mode, and non-official connections with managed proxy.

Pilot Status supports two ways to connect a WhatsApp number to your project: an unofficial QR-code-based connection that takes seconds to set up, and an official Meta connection that uses the Cloud API or Coexistence mode for full policy compliance and higher throughput. You can mix both types within the same project.

<Tabs>
  <Tab title="Unofficial (QR Code)">
    The unofficial connection method authenticates your WhatsApp number by linking it as a device — the same flow as WhatsApp Web. Pilot Status handles the managed proxy automatically, so there's nothing extra to configure.

    <Steps>
      <Step title="Open the Numbers section">
        In your Pilot Status dashboard, navigate to **Dashboard → Numbers** and click **Add Number**.
      </Step>

      <Step title="Select Non-official">
        On the connection type screen, choose **Non-official (QR Code)**.
      </Step>

      <Step title="Scan the QR code">
        Open WhatsApp on your phone and tap **Linked Devices → Link a Device**. Point your camera at the QR code displayed in the dashboard.
      </Step>

      <Step title="Confirm the connection">
        Once WhatsApp recognizes the code, your number's status changes to **Connected** in the dashboard. You can now start sending and receiving messages via the API.
      </Step>
    </Steps>

    <Note>
      Unofficial connections include a managed proxy — no VPS or extra configuration needed. Pilot Status maintains the connection and re-routes it automatically if your IP changes.
    </Note>
  </Tab>

  <Tab title="Official (Meta)">
    The official connection uses Meta's WhatsApp Business API. Choose **Cloud API** for a fully hosted Meta integration, or **Coexistence mode** to run the API alongside your existing WhatsApp Business app without interrupting it.

    <Steps>
      <Step title="Open the Numbers section">
        In your Pilot Status dashboard, navigate to **Dashboard → Numbers** and click **Add Number**.
      </Step>

      <Step title="Select Official (Meta)">
        On the connection type screen, choose **Official (Meta)**.
      </Step>

      <Step title="Choose your mode">
        Select either **Cloud API** or **Coexistence** mode depending on your use case. See the note below for guidance on Coexistence.
      </Step>

      <Step title="Enter your Meta Business credentials">
        Provide your **Meta Business Account ID**, **WhatsApp Business Account ID**, and the **access token** generated in your Meta Developer App. Pilot Status uses these to authenticate requests on your behalf.
      </Step>

      <Step title="Authorize permissions">
        Follow the OAuth prompt to grant Pilot Status the required WhatsApp Business API permissions. You must be an admin of the Meta Business account to complete this step.
      </Step>

      <Step title="Confirm the connection">
        Once authorization succeeds, your number's status changes to **Connected**. Template messages, Cloud API webhooks, and high-volume sending are all available immediately.
      </Step>
    </Steps>

    <Note>
      Coexistence mode lets you use the official Meta API while keeping your existing WhatsApp Business app active on the same number. Your team can still use the app for manual conversations while your automations and integrations run through the API.
    </Note>
  </Tab>
</Tabs>

## Multi-number setup

Every Pilot Status plan supports multiple numbers in a single project. Add numbers up to the limit of your plan — from 1 number on the free tier up to 13 numbers (plus eSIM) on the Enterprise plan. Each number gets its own ID, API scope, and message log.

For SaaS products and multi-tenant applications, each of your customers can connect their own WhatsApp number under your project. This keeps message traffic fully isolated per tenant while letting you manage all numbers from one dashboard and one API integration. Pilot Status bills at the project level, so you don't need a separate account per customer.

## Reconnecting a number

Unofficial connections occasionally drop — for example, if the linked phone is offline for an extended period or WhatsApp revokes the session. Official connections are generally more stable, but network interruptions can still cause a temporary disconnect.

To reconnect a number, open **Dashboard → Numbers**, find the number showing a **Disconnected** status, and click **Reconnect**. For unofficial numbers, you'll scan a new QR code. For official numbers, Pilot Status will attempt to re-establish the session using your stored credentials automatically.

<Warning>
  WhatsApp's Terms of Service prohibit sending spam. Always obtain explicit user consent before sending messages to any contact. Violations can result in your number being banned by Meta.
</Warning>