Pular para o conteúdo principal
A Camada de API do Pilot Status permite migrar sua integração existente do WhatsApp para o Pilot Status sem tocar no código da sua aplicação. Em vez de reescrever suas chamadas de API, você aponta sua base URL para o endpoint da camada do Pilot Status referente ao seu provedor — e o Pilot Status cuida da tradução de forma transparente a partir daí.

​
Como a Camada de API funciona

Quando sua aplicação envia uma requisição para https://pilotstatus.com.br/api/layer/{provider}/, o Pilot Status a recebe, traduz a requisição para o formato nativo da API do Pilot Status, executa a operação e retorna uma resposta no formato que seu código já espera. Seus corpos de requisição, cabeçalhos, tokens de autenticação e payloads de webhook permanecem inalterados. Essa tradução acontece no servidor em tempo real. Do ponto de vista da sua aplicação, ela continua conversando com uma Evolution API compatível — apenas a infraestrutura que a alimenta mudou.

​
Provedores suportados

Evolution GO

Base URL: https://pilotstatus.com.br/api/layer/evolution-go/Use esta camada se sua integração existente utiliza o formato da API Evolution GO.

Evolution V2

Base URL: https://pilotstatus.com.br/api/layer/evolution-v2/Use esta camada se sua integração existente utiliza o formato da Evolution API V2.

​
Passos da migração

Siga estes quatro passos para migrar sua integração para o Pilot Status:
  1. Encontre sua base URL atual no código da sua aplicação ou na configuração de variáveis de ambiente — é a URL raiz que seu cliente HTTP usa para todas as requisições à Evolution API.
  2. Substitua-a por https://pilotstatus.com.br/api/layer/evolution-v2/ ou https://pilotstatus.com.br/api/layer/evolution-go/, dependendo de qual formato de provedor seu código utiliza.
  3. Conecte seu número pelo painel do Pilot Status para que a camada tenha um número ativo por onde rotear as mensagens.
  4. Teste com um envio de mensagem — use o mesmo corpo de requisição e cabeçalhos que você já tem e confirme que recebe o mesmo formato de resposta.
O exemplo abaixo mostra como uma única mudança de variável de ambiente é tudo o que separa sua configuração atual do Pilot Status: 
# Antes (servidor Evolution)
POST https://your-evolution-server.com/message/sendText/MyInstance

# Depois (Camada Pilot Status)
POST https://pilotstatus.com.br/api/layer/evolution-v2/message/sendText/MyInstance
Tudo depois da base URL — o caminho, o corpo da requisição e os cabeçalhos — permanece exatamente igual.

​
O que é preservado

Ao usar a Camada de API, o Pilot Status preserva o seguinte para que sua integração continue funcionando sem modificações:
  • Formato do corpo da requisição — os mesmos campos JSON que seu código envia hoje
  • Formato da resposta — a mesma estrutura JSON que seu código interpreta hoje
  • Estrutura do payload de webhook — os eventos chegam no formato que seus handlers já esperam
  • Eventos de webhook — os eventos são encaminhados ao seu webhook no formato de evento nativo do seu provedor; cada página de camada de provedor lista os eventos exatos que ela emite
  • Cabeçalhos de autenticação — passe sua chave de API do Pilot Status usando o mesmo cabeçalho que seu código já define (apikey ou Authorization: Bearer)
  • Integrações existentes — ferramentas como n8n, Make e outras plataformas low-code que se conectam à Evolution API continuam funcionando apenas atualizando a base URL na configuração do nó HTTP
A Camada de API é uma ponte de compatibilidade. Para novas integrações, use a API nativa do Pilot Status para acesso completo aos recursos.