Pular para o conteúdo principal
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.
1

Crie sua conta

Acesse 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.
2

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.
Conectando um número no painel do Pilot Status
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.
3

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

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.
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! 👋"
  }'
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).
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.
5

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 para inspecionar os payloads durante o desenvolvimento.

​
O que vem a seguir

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

Conectar Números

Aprenda a adicionar números oficiais e não oficiais, configurar o modo Coexistência e gerenciar conexões multi-tenant.

Webhooks

Entenda a estrutura do payload de webhook e como lidar com eventos de entrega, leitura e mensagens recebidas.

Enviar Mensagens

Envie texto, imagens, documentos, áudio, botões e mensagens de template com a API REST.

Referência da API

Navegue pela referência completa de endpoints com esquemas de requisição, exemplos de resposta e códigos de erro.