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

# Início Rápido do Pilot Status: Envie Sua Primeira Mensagem no WhatsApp

> Crie sua conta no Pilot Status, conecte um número de WhatsApp e envie sua primeira mensagem pela API REST. Sem necessidade de configurar servidor ou proxy.

Este guia orienta você por tudo o que precisa para sair do zero e enviar sua primeira mensagem no WhatsApp pela API do Pilot Status. Você vai criar uma conta, conectar um número, pegar sua chave de API e fazer uma chamada de API ao vivo — sem necessidade de configurar servidor ou proxy.

<Steps>
  <Step title="Crie sua conta">
    Acesse [pilotstatus.com.br](https://pilotstatus.com.br) e cadastre-se para uma conta gratuita. O plano gratuito inclui um número de WhatsApp e até 200 mensagens — sem necessidade de cartão de crédito.
  </Step>

  <Step title="Conecte seu número">
    No painel, clique em **Conectar número** e escolha seu método de conexão:

    * **QR Code (não oficial):** Abra o WhatsApp no seu celular, toque em **Aparelhos conectados → Conectar um aparelho** e escaneie o QR code exibido no painel.
    * **Credenciais da Meta (oficial):** Selecione o modo Cloud API ou Coexistência, depois insira suas credenciais do Meta Business e o ID da sua Conta do WhatsApp Business.

    <Frame caption="Conectando um número — escaneie o QR code ou use o código de pareamento em letras no WhatsApp (Aparelhos conectados).">
      <img src="https://mintcdn.com/iaxp/67kV9q3n9SCt8FWI/images/dashboard/connect-qr.png?fit=max&auto=format&n=67kV9q3n9SCt8FWI&q=85&s=e1595097b9d02c57ef9644824c1e3358" alt="Conectando um número no painel do Pilot Status" width="1920" height="914" data-path="images/dashboard/connect-qr.png" />
    </Frame>

    Seu número aparecerá como **Conectado** assim que o handshake for concluído. Para um passo a passo completo de ambos os métodos, veja [Conectar um Número de WhatsApp](/pt-BR/connecting-numbers).
  </Step>

  <Step title="Obtenha sua chave de API">
    No painel, abra a página **API Keys** (`/api-keys`) e copie a chave do seu número conectado — ela começa com `ps_`. Mantenha esse valor em segredo — ele autentica cada requisição de API que você faz.
  </Step>

  <Step title="Envie sua primeira mensagem">
    Faça a requisição a seguir, substituindo `ps_your_key_here` pela sua chave e `destinationNumber` por um número de WhatsApp real no qual você possa verificar a entrega. A própria chave identifica qual dos seus números envia a mensagem.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST https://pilotstatus.com.br/v1/messages/send \
        -H "x-api-key: ps_your_key_here" \
        -H "Content-Type: application/json" \
        -d '{
          "destinationNumber": "+5511999999999",
          "text": "Hello from Pilot Status! 👋"
        }'
      ```
    </CodeGroup>

    Uma resposta bem-sucedida retorna `HTTP 202` com um `id` e um `status` igual a `QUEUED`. O Pilot Status entrega a mensagem e dispara seu webhook conforme os eventos de entrega e leitura chegam. O mesmo endpoint também envia templates (`templateId` + `variables`) e mídia (`media` + `mediaType`).

    <Tip>
      Os números de telefone devem estar no formato E.164 **com o `+` no início** — por exemplo, `+5511999999999` para um número brasileiro (+55), DDD 11.
    </Tip>
  </Step>

  <Step title="Receba eventos">
    Para receber confirmações de entrega em tempo real, notificações de leitura e mensagens recebidas, crie um webhook na página **Webhooks** do painel (ou via `POST /v1/webhooks`). O Pilot Status fará um POST com um payload JSON para sua URL em milissegundos após cada evento. Você pode usar um serviço como o [Webhook.site](https://webhook.site) para inspecionar os payloads durante o desenvolvimento.
  </Step>
</Steps>

## O que vem a seguir

Agora que você enviou sua primeira mensagem, explore o restante da plataforma.

<CardGroup cols={2}>
  <Card title="Conectar Números" icon="mobile" href="/pt-BR/connecting-numbers">
    Aprenda a adicionar números oficiais e não oficiais, configurar o modo Coexistência e gerenciar conexões multi-tenant.
  </Card>

  <Card title="Webhooks" icon="bolt" href="/pt-BR/concepts/webhooks">
    Entenda a estrutura do payload de webhook e como lidar com eventos de entrega, leitura e mensagens recebidas.
  </Card>

  <Card title="Enviar Mensagens" icon="paper-plane" href="/pt-BR/guides/send-messages">
    Envie texto, imagens, documentos, áudio, botões e mensagens de template com a API REST.
  </Card>

  <Card title="Referência da API" icon="code" href="/pt-BR/api/overview">
    Navegue pela referência completa de endpoints com esquemas de requisição, exemplos de resposta e códigos de erro.
  </Card>
</CardGroup>