Pular para o conteúdo principal
A Camada de API Evolution GO do Pilot Status oferece um substituto direto para o seu servidor Evolution GO. Você mantém cada corpo de requisição, cabeçalho e caminho exatamente como estão hoje — a única mudança que você faz é trocar a sua base URL. O Pilot Status traduz suas requisições compatíveis com o Evolution GO para sua API nativa e retorna as respostas no formato que seu código já manipula.

​
Base URL

Aponte seu cliente HTTP ou variável de ambiente para a seguinte base URL para começar a usar a camada Evolution GO: 
https://pilotstatus.com.br/api/layer/evolution-go/
Todos os caminhos que você usa atualmente com seu servidor Evolution GO são anexados diretamente a esta URL. Nenhuma outra alteração é necessária.

​
Autenticação

Passe sua chave de API do Pilot Status usando o mesmo cabeçalho que seu código Evolution GO existente já envia. Se o seu código usa o cabeçalho apikey, continue usando-o: 
apikey: YOUR_API_KEY
Se o seu código usa um cabeçalho com token Bearer, esse formato também é aceito: 
Authorization: Bearer YOUR_API_KEY
Use o formato que corresponder à sua implementação existente — você não precisa alterar seu código de autenticação.

​
Operações suportadas

Cada requisição é uma chamada para <MÉTODO> https://pilotstatus.com.br/api/layer/evolution-go<CAMINHO>. A instância é resolvida a partir da sua chave de API, então os caminhos do Evolution GO que normalmente carregam um segmento de instância não precisam dele aqui. As operações de envio são automaticamente balanceadas entre as instâncias conectadas do seu número.
Qualquer caminho não listado abaixo retorna 404. Caminhos globais ou exclusivos de administrador retornam 403 — eles nunca são expostos pela camada (veja Caminhos bloqueados).

​
Instância (sessão)

MétodoCaminho
POST/instance/connect
GET/instance/status
GET/instance/qr
POST/instance/pair
POST/instance/disconnect
POST/instance/reconnect
DELETE/instance/logout
GET/instance/{id}/advanced-settings
PUT/instance/{id}/advanced-settings

​
Envio (balanceado)

MétodoCaminho
POST/send/text
POST/send/link
POST/send/media
POST/send/poll
POST/send/sticker
POST/send/location
POST/send/contact
POST/send/button
POST/send/list
POST/send/carousel

​
Usuário / Contatos

MétodoCaminho
POST/user/info
POST/user/check
POST/user/avatar
GET/user/contacts
GET/user/privacy
POST/user/privacy
POST/user/block
POST/user/unblock
GET/user/blocklist
POST/user/profilePicture
POST/user/profileName
POST/user/profileStatus

​
Mensagem

MétodoCaminho
POST/message/react
POST/message/presence
POST/message/markread
POST/message/downloadmedia
POST/message/status
POST/message/delete
POST/message/edit

​
Chat

MétodoCaminho
POST/chat/pin
POST/chat/unpin
POST/chat/archive
POST/chat/unarchive
POST/chat/mute
POST/chat/unmute
POST/chat/history-sync

​
Grupo

MétodoCaminho
GET/group/list
POST/group/info
POST/group/invitelink
POST/group/photo
POST/group/name
POST/group/description
POST/group/create
POST/group/participant
GET/group/myall
POST/group/join
POST/group/leave

​
Chamada (voz)

MétodoCaminho
POST/call/start
GET/call/list
POST/call/get
POST/call/answer
POST/call/reject
POST/call/reject/by-id
POST/call/reject/latest
POST/call/hangup
POST/call/media/play
POST/call/media/realtime/session

​
Comunidade

MétodoCaminho
POST/community/create
POST/community/add
POST/community/remove

​
Etiqueta (label)

MétodoCaminho
POST/label/chat
POST/label/message
POST/label/edit
GET/label/list
POST/unlabel/chat
POST/unlabel/message

​
Newsletter / Canais

MétodoCaminho
POST/newsletter/create
GET/newsletter/list
POST/newsletter/info
POST/newsletter/link
POST/newsletter/subscribe
POST/newsletter/messages

​
Bloqueados (admin/global)

Estes caminhos globais e exclusivos de administrador do Evolution GO não são expostos pela camada e retornam 403: GET /server/ok · /swagger/* · POST /instance/create · GET /instance/all · GET /instance/info/{id} · DELETE /instance/delete/{id} · POST /instance/proxy/{id} · DELETE /instance/proxy/{id} · POST /instance/forcereconnect/{id} · GET /instance/logs/{id}

​
Eventos

A camada encaminha eventos para o seu webhook configurado no formato nativo (PascalCase) do próprio Evolution GO, para que seus manipuladores de eventos existentes continuem funcionando sem alterações: Message · SendMessage · Receipt · Presence · ChatPresence · Archive · CallOffer · CallAccept · CallTerminate · Connected · PairSuccess · TemporaryBan · LoggedOut · ConnectFailure · Disconnected · LabelEdit · LabelAssociationChat · LabelAssociationMessage · Contact · PushName · GroupInfo · JoinedGroup · NewsletterJoin · NewsletterLeave · QRCode · QRSuccess Os aliases modernos em UPPER_SNAKE também são aceitos: MESSAGES_UPSERT · SEND_MESSAGE · CONNECTION_UPDATE · QRCODE_UPDATED · PRESENCE_UPDATE · CHATS_UPSERT · CHATS_UPDATE · CHATS_DELETE · GROUPS_UPSERT · GROUPS_UPDATE · GROUP_PARTICIPANTS_UPDATE · CALL · CONTACTS_UPSERT · CONTACTS_UPDATE · NEWSLETTER_UPDATE · LABEL_EDIT · LABEL_ASSOCIATION Além disso, o Pilot Status pode entregar seus próprios eventos normalizados junto com os nativos:
  • Ciclo de vida da chamada: call.ringing, call.connected, call.ended, call.missed
  • Ciclo de vida do número: number.created, number.connected, number.disconnected, number.removed

​
Exemplo: enviar texto via camada Evolution GO

A requisição abaixo é uma chamada padrão de envio de texto do Evolution GO — apenas a base URL foi alterada para rotear através do Pilot Status. 
curl -X POST 'https://pilotstatus.com.br/api/layer/evolution-go/message/sendText/MyInstance' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "number": "5511999999999",
    "options": { "delay": 1200, "presence": "composing" },
    "textMessage": { "text": "Hello from Pilot Status! 👋" }
  }'
Substitua MyInstance pelo nome de exibição que você atribuiu ao seu número no painel do Pilot Status. O corpo da requisição e o formato da resposta são idênticos ao que seu código existente produz e consome.
Se alguma operação do Evolution GO não for suportada pela camada, use a API nativa do Pilot Status. Para dúvidas específicas de compatibilidade, fale com o suporte no WhatsApp: +55 11 96743-5133.