> ## 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.

# Adicionar e Conectar Números de WhatsApp no Painel do Pilot Status

> Adicione números de WhatsApp oficiais ou não oficiais ao Pilot Status. Suporta Meta Cloud API, modo de Coexistência e conexões não oficiais com proxy gerenciado.

O Pilot Status oferece duas formas de conectar um número de WhatsApp ao seu projeto: uma conexão não oficial baseada em QR code que leva segundos para configurar, e uma conexão oficial da Meta que usa a Cloud API ou o modo de Coexistência para total conformidade com as políticas e maior capacidade de envio. Você pode combinar os dois tipos dentro do mesmo projeto.

<Frame caption="A página de Números — números conectados com selos de provedor (Não oficial / Embedded Signup) e o botão Conectar número.">
  <img src="https://mintcdn.com/iaxp/dhbvOyhDeyNhT4ix/images/dashboard/numbers.png?fit=max&auto=format&n=dhbvOyhDeyNhT4ix&q=85&s=31cc3ff783ddcf4e63a6759447af1673" alt="Página de Números do Pilot Status" width="1920" height="896" data-path="images/dashboard/numbers.png" />
</Frame>

<Frame caption="Conectando um número — escolha entre Meta Cloud API, Coexistência Meta, a API não oficial do Pilot Status (QR code) ou migração de outro provedor.">
  <img src="https://mintcdn.com/iaxp/rUJldLTcmZfigk-O/images/dashboard/connect-api-choice.png?fit=max&auto=format&n=rUJldLTcmZfigk-O&q=85&s=36c093d384852c6f851bfaf4cd82d463" alt="Modal &#x22;Qual API você quer usar?&#x22; com os quatro cards de tipo de conexão" width="1916" height="903" data-path="images/dashboard/connect-api-choice.png" />
</Frame>

<Tabs>
  <Tab title="Não oficial (QR Code)">
    O método de conexão não oficial autentica o seu número de WhatsApp vinculando-o como um dispositivo — o mesmo fluxo do WhatsApp Web. O Pilot Status cuida do proxy gerenciado automaticamente, então não há nada extra para configurar.

    <Steps>
      <Step title="Abra a seção Números">
        No seu painel do Pilot Status, navegue até **Dashboard → Números** e clique em **Adicionar Número**.
      </Step>

      <Step title="Selecione o card API não oficial">
        Na tela de tipo de conexão, escolha o card **API não oficial** (Pilot Status / QR Code).
      </Step>

      <Step title="Escaneie o QR code">
        Abra o WhatsApp no seu celular e toque em **Dispositivos conectados → Conectar um dispositivo**. Aponte a câmera para o QR code exibido no painel.

        <Frame caption="O modal Conectar número — escaneie o QR code ou digite o código de pareamento em letras no WhatsApp (Aparelhos conectados); os códigos expiram e são regenerados automaticamente.">
          <img src="https://mintcdn.com/iaxp/67kV9q3n9SCt8FWI/images/dashboard/connect-qr.png?fit=max&auto=format&n=67kV9q3n9SCt8FWI&q=85&s=e1595097b9d02c57ef9644824c1e3358" alt="Modal Conectar número com QR code e código de pareamento em letras" width="1920" height="914" data-path="images/dashboard/connect-qr.png" />
        </Frame>
      </Step>

      <Step title="Confirme a conexão">
        Assim que o WhatsApp reconhecer o código, o status do seu número muda para **Conectado** no painel. Agora você pode começar a enviar e receber mensagens pela API.
      </Step>
    </Steps>

    <Note>
      As conexões não oficiais incluem um proxy gerenciado — nenhuma VPS ou configuração extra é necessária. O Pilot Status mantém a conexão e a redireciona automaticamente se o seu IP mudar.
    </Note>
  </Tab>

  <Tab title="Oficial (Meta)">
    A conexão oficial usa a WhatsApp Business API da Meta. Escolha **Cloud API** para uma integração totalmente hospedada pela Meta, ou o modo **Coexistência** para executar a API junto com o seu aplicativo WhatsApp Business existente sem interrompê-lo.

    <Steps>
      <Step title="Abra a seção Números">
        No seu painel do Pilot Status, navegue até **Dashboard → Números** e clique em **Adicionar Número**.
      </Step>

      <Step title="Selecione Oficial (Meta)">
        Na tela de tipo de conexão, escolha **Oficial (Meta)**.
      </Step>

      <Step title="Escolha o seu modo">
        Selecione o modo **Cloud API** ou **Coexistência** dependendo do seu caso de uso. Veja a nota abaixo para orientações sobre a Coexistência.
      </Step>

      <Step title="Insira as credenciais da sua Meta Business">
        Forneça o **ID da sua Meta Business Account**, o **ID da WhatsApp Business Account** e o **token de acesso** gerado no seu Meta Developer App. O Pilot Status os utiliza para autenticar requisições em seu nome.
      </Step>

      <Step title="Autorize as permissões">
        Siga o prompt de OAuth para conceder ao Pilot Status as permissões necessárias da WhatsApp Business API. Você deve ser um administrador da conta Meta Business para concluir esta etapa.
      </Step>

      <Step title="Confirme a conexão">
        Assim que a autorização for bem-sucedida, o status do seu número muda para **Conectado**. Mensagens de template, webhooks da Cloud API e envio em alto volume ficam todos disponíveis imediatamente.
      </Step>
    </Steps>

    <Note>
      O modo de Coexistência permite usar a API oficial da Meta enquanto mantém o seu aplicativo WhatsApp Business existente ativo no mesmo número. Sua equipe ainda pode usar o aplicativo para conversas manuais enquanto suas automações e integrações rodam pela API.
    </Note>
  </Tab>
</Tabs>

## Configuração de múltiplos números

Todos os planos do Pilot Status suportam múltiplos números em um único projeto. Adicione números até o limite do seu plano — de 1 número no plano gratuito até 13 números (mais eSIM) no plano Enterprise. Cada número recebe seu próprio ID, escopo de API e log de mensagens.

Para produtos SaaS e aplicações multi-tenant, cada um dos seus clientes pode conectar o próprio número de WhatsApp dentro do seu projeto. Isso mantém o tráfego de mensagens totalmente isolado por tenant, ao mesmo tempo em que permite gerenciar todos os números a partir de um único painel e uma única integração de API. O Pilot Status cobra no nível do projeto, então você não precisa de uma conta separada por cliente.

## Reconectando um número

Conexões não oficiais ocasionalmente caem — por exemplo, se o telefone vinculado ficar offline por um período prolongado ou se o WhatsApp revogar a sessão. As conexões oficiais são geralmente mais estáveis, mas interrupções de rede ainda podem causar uma desconexão temporária.

Para reconectar um número, abra **Dashboard → Números**, encontre o número com status **Desconectado** e clique em **Reconectar**. Para números não oficiais, você escaneará um novo QR code. Para números oficiais, o Pilot Status tentará restabelecer a sessão usando suas credenciais armazenadas automaticamente.

<Warning>
  Os Termos de Serviço do WhatsApp proíbem o envio de spam. Sempre obtenha o consentimento explícito do usuário antes de enviar mensagens para qualquer contato. Violações podem resultar no banimento do seu número pela Meta.
</Warning>