O que é a API Layer
A API Layer fica na frente da plataforma Pilot Status e fala o mesmo dialeto HTTP dos provedores de WhatsApp que sua equipe já conhece. Quando sua aplicação envia uma requisição ao endpoint da API Layer, o Pilot Status a interpreta usando o schema específico do provedor, executa a operação em sua infraestrutura gerenciada e retorna uma resposta no formato que seu código espera. Isso significa que você obtém todos os benefícios do Pilot Status — proxies gerenciados, sem servidores auto-hospedados, integrações oficiais com a Meta, escalonamento automático e SLAs de uptime — sem um sprint de migração, uma reescrita ou um ciclo de QA para validar novos formatos de requisição.Como migrar
1
Conecte seu número
No painel, clique em Conectar número e escolha o card Migração (API Não Oficial → Migração). Conecte o número por QR code, como de costume.
2
Obtenha sua chave de API do Pilot Status
Cada número tem uma chave padrão na página API Keys — essa chave substitui o valor do
apikey da sua Evolution antiga (mantenha o mesmo cabeçalho apikey).3
Troque a base URL
Aponte sua integração para
https://pilotstatus.com.br/api/layer/evolution-go/ ou .../evolution-v2/ — os corpos de requisição, os caminhos (a v2 mantém o último segmento {instance} = o nome de exibição do número) e os handlers de webhook permanecem os mesmos.4
Reaponte os webhooks e teste
Configure seu webhook na página Webhooks (os eventos chegam no formato nativo do seu provedor — veja as páginas da camada) e, em seguida, envie uma mensagem de teste e confirme a entrega em Logs.
Provedores suportados
Evolution GO
Endpoint:
/api/layer/evolution-go/Compatibilidade drop-in para aplicações construídas sobre a API Evolution GO. Todos os caminhos de envio de mensagens, gerenciamento de instâncias e webhooks são suportados.Evolution V2
Endpoint:
/api/layer/evolution-v2/Compatibilidade drop-in para aplicações construídas sobre a Evolution API v2. Suporta toda a superfície da API v2 de mensagens, grupos e eventos.O que permanece igual
Quando você migra via API Layer, o seguinte permanece completamente inalterado na sua aplicação:- Formato do corpo da requisição — os payloads JSON que você envia hoje funcionam sem modificação.
- Formato da resposta — nomes de campos, tipos e estrutura são idênticos ao que você já processa.
- Formato do payload de webhook — nomes de eventos e schemas de payload correspondem aos seus handlers existentes.
- Cabeçalhos de autenticação — continue usando o mesmo nome e formato de cabeçalho que seu provedor exige (o Pilot Status o mapeia internamente).
- Caminhos e métodos — todo caminho de endpoint e método HTTP que você chama atualmente é suportado no mesmo caminho relativo sob a nova base URL.
O que muda
A API Layer está disponível em todos os planos pagos do Pilot Status. Você pode testar sua migração no plano gratuito com seu primeiro número conectado antes de assinar.