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

# Camada de API: Migre para o Pilot Status sem alterar código

> A Camada de API do Pilot Status aceita requisições compatíveis com a Evolution API. Troque de provedor alterando apenas a sua base URL — sem reescrever código.

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

<CardGroup cols={2}>
  <Card title="Evolution GO" icon="bolt" href="/pt-BR/api/layer/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.
  </Card>

  <Card title="Evolution V2" icon="code" href="/pt-BR/api/layer/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.
  </Card>
</CardGroup>

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

```bash theme={null}
# Antes (servidor Evolution)
POST https://your-evolution-server.com/message/sendText/MyInstance
```

```bash theme={null}
# 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

<Note>
  A Camada de API é uma ponte de compatibilidade. Para novas integrações, use a API nativa do Pilot Status para acesso completo aos recursos.
</Note>