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

# Migre para o Pilot Status Sem Reescrever Seu Código

> Mude para o Pilot Status a partir da Evolution API (Evolution GO ou Evolution V2) alterando uma única base URL. Nenhuma mudança de código é necessária com a API Layer.

Se você já executa automação de WhatsApp na Evolution API — seja Evolution GO ou Evolution V2 — pode migrar para o Pilot Status sem tocar em uma única linha do código da sua aplicação. A **API Layer** do Pilot Status é uma camada de compatibilidade que aceita requisições no formato exato que sua integração existente já envia, as traduz internamente e as roteia pela infraestrutura do Pilot Status. Seus corpos de requisição, formatos de resposta, payloads de webhook e cabeçalhos de autenticação permanecem os mesmos. A única coisa que muda é o hostname na sua base URL.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

## Provedores suportados

<CardGroup cols={2}>
  <Card title="Evolution GO" icon="bolt">
    **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.
  </Card>

  <Card title="Evolution V2" icon="code">
    **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.
  </Card>
</CardGroup>

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

| O que                          | Antes                                             | Depois                                             |
| ------------------------------ | ------------------------------------------------- | -------------------------------------------------- |
| **Base URL**                   | Seu servidor auto-hospedado                       | `https://pilotstatus.com.br/api/layer/{provider}/` |
| **Cobrança**                   | Custos do seu servidor / VPS                      | Assinatura do Pilot Status                         |
| **Infraestrutura**             | Servidor, proxies e atualizações auto-gerenciados | Totalmente gerenciado pelo Pilot Status            |
| **Responsabilidade de uptime** | Sua                                               | SLA do Pilot Status                                |

<Note>
  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.
</Note>

Para a referência completa da API Layer — incluindo endpoints suportados, tratamento de erros e mapeamento de instâncias — consulte a [visão geral da API Layer](/pt-BR/api/layer/overview).