Skip to main content

​
Visão Geral da API Pilot Status

O Pilot Status é uma plataforma para envio de mensagens de WhatsApp (transacionais e de marketing/em massa) com controle de templates, versionamento e visibilidade operacional via painel, API e webhooks.

​
Base URL

​
Autenticação

Toda requisição exige uma chave de API enviada no cabeçalho x-api-key (ou x-api-key-id com o ID da chave). As chaves usam o prefixo ps_.
A API não usa tokens Authorization: Bearer. Sempre autentique com o cabeçalho x-api-key: ps_... (ou x-api-key-id).
Página de API Keys do Pilot Status

Obtenha (ou regenere) sua chave na página API Keys do painel — uma chave padrão por número.

​
Escopos de chave

Consulte Autenticação da API para mais detalhes.

​
Conceitos principais

  • Template: um modelo de mensagem versionado referenciado por templateId nos envios via API. Para números Meta, os templates são submetidos à Meta para aprovação; para números não oficiais (Pilot Status web), eles são criados localmente sem etapa de aprovação.
  • Message: uma tentativa de envio criada por POST /v1/messages/send.
  • Webhooks: eventos de entrega (sent/delivered/read/failed) e mensagens recebidas (reply/received/group).
  • Confirmações de leitura: o status READ, o readAt e o webhook message.read só ocorrem quando o contato destinatário tem as confirmações de leitura do WhatsApp habilitadas.

​
Fluxo típico de integração

1

Criar templates

Crie templates no painel (/templates).
2

Conectar o WhatsApp

Configure seu número/instância de WhatsApp no painel (/profile e /numbers).
3

Criar uma chave de API

Crie uma chave de API na página /api-keys.
4

Enviar mensagens

Envie mensagens com POST /v1/messages/send.
5

Acompanhar a entrega

Consulte o status com GET /v1/messages/{messageId} e/ou consuma eventos via webhooks.

​
Erros HTTP comuns

​
Avisos (WhatsApp / antispam)

Envios em alto volume e não solicitados podem acionar os mecanismos antispam do WhatsApp (limites de taxa, bloqueios e banimentos). Você é responsável pelo opt-in/consentimento e pela conformidade com as leis aplicáveis e as políticas do WhatsApp.