EVO API · conhecimento para a operação

O que a API do EVO (W12/ABC) permite além do que já usamos — mapeado pra destravar vendas, retenção, cobrança e dados. Base evo-integracao-api.w12app.com.br · Basic Auth · doc canônica api.abcevo.com.

⚡ Top 10 oportunidades (o que dá pra destravar JÁ)

1. Push no app EVO (grátis, segmentado) esforço baixo

POST /members/push · /members/multiple-push

Campanha de retenção, lembrete de aula experimental e aviso de vencimento direto no app, sem custo de WhatsApp. Os idMembers já estão no cache.

retençãovendas

2. Grade de aulas + ocupação em tempo real esforço médio

GET /activities/schedule · POST /activities/booking

Mostrar "sala cheia/vaga" no Cockpit e na Mari, e a Mari agendar a aula direto (incl. experimental de prospect) em vez de pedir pra ligar.

vendasretenção

3. Converter prospect → membro via API esforço médio

POST /prospects/convert → retorna idMember

Fechar matrícula programaticamente quando o lead paga no checkout, sem operação manual no painel EVO.

vendas

4. Vouchers de campanha automáticos baixo-médio

POST /voucher · POST /voucher/voucher-verify

Cupom único pro Indica Espaço, desconto pré-validado na matrícula, voucher de retorno pra ex-aluno. Suporta % ou R$, recorrente por N meses, por plano.

vendasretenção

5. Cobrar o cartão do inadimplente esforço baixo

POST /receivables/charge (idCreditCard)

Retry automático no cartão cadastrado quando o PIX não foi pago, sem logar no painel. (Checar /members/{id}/creditcard antes.)

cobrança

6. Conciliação financeira por NSU/TID esforço baixo

GET /receivables/receivables-conciliation

Confirmar se a venda aprovada na maquininha entrou mesmo no EVO e pegar chargeback. Hoje a conciliação é manual.

dadoscobrança

7. Frequência em AULAS por aluno esforço médio

GET /activities/member/sessions

Sinal de engajamento mais fino que a catraca — alimenta a régua de reativação com quem parou de ir nas coletivas.

retenção

8. Catálogo de planos com preço + link esforço baixo

GET /membership (value, urlSale)

A Mari puxa preço e link de matrícula corretos por plano/unidade dinamicamente, em vez de hardcoded no prompt. Cachear 1×/dia.

vendas

9. Tag de interesse do prospect esforço baixo

GET /prospects/interests · PATCH /prospects

Mari classifica o interesse (musculação / coletivas / personal) no EVO durante a conversa — enriquece o CRM.

vendasdados

10. Notificação in-app pro prospect muito baixo

POST /notifications/prospect

Lembrete da aula experimental no app pra quem baixou o EVO e não apareceu — complementa o WhatsApp sem custo.

vendas

📚 Inventário por categoria (endpoints-chave)

CategoriaEndpoints-chave
ActivitiesGET /activities/schedule (grade+ocupação) · POST /activities/booking · POST /activities/schedule/experimental-class · GET /activities/member/sessions
AppointmentsGET /appointment/availability · POST /appointment/enroll · PATCH /appointment/enroll/change-status (check-in)
MembersGET /members · GET /members/{id} · GET /members/basic (lookup email/CPF/fone) · PUT /members/block-unblock · POST /members/transfer · POST /members/push · fitcoins
MemberMembershipGET /membermembership (contratos) · POST /membermembership/cancellation (c/ ou s/ multa) · revert agendado
MembershipGET /membership (planos: valor, urlSale, regras) · /membership/category
ProspectsGET/POST/PATCH /prospects · POST /prospects/convert · /prospects/interests
SalesGET/POST /sales · GET /sales/sales-items (planos venda online + checkoutUrl) · /sales/by-session-id
ReceivablesGET /receivables · /receivables/debtors · POST /receivables/charge · charge-attempts/batch (PIX) · PUT /mark-received · /receivables-conciliation
VoucherPOST /voucher (cria cupom) · /voucher/voucher-verify · códigos por voucher
CartsGET/POST /carts (checkoutLink + voucher) · PATCH /carts/forfeit
NotificationsPOST /notifications (membro) · /notifications/prospect
Management/management/activeclients (XLSX) · /management/not-renewed · /aggregators/checkins (Gympass)
OutrosAccessControl (entryAuthorize) · Employees · Invoices (NF) · Payables (contas a pagar/DRE) · Partnership (Gympass) · Product (loja/estoque) · Workout · BankAccounts · Parking

⚠️ Pegadinhas & limites (ler antes de automatizar)

Filtros que falham em silêncio: /receivables ignora idMember na query (filtrar no client) · /prospects ignora registerDate (usar conversionDate) — nenhum levanta erro HTTP.
Rate limit & custo: /receivables = 40 req/min. Custo real R$3.884/182k req → todo cron com backoff e sem varredura completa da base.
XLSX, não JSON: /management/activeclients e /members/active-members voltam XLSX zipado — precisa parser (não dá pra usar direto numa edge function).
Plano da API: /management/not-renewed retorna HTTP 406 no plano atual (exige API Plus). Confirmar com a W12 antes de depender dele.
crm.automation precisa ativar no painel: eventos no_access_days e first_workout não chegam até a automação ser ligada no EVO web — por isso ENGAJA 1/2/3 e ONBOARD-2 seguem em shadow_mode.
Pré-requisitos: charge exige idCreditCard (consultar /members/{id}/creditcard antes) · POST /sales exige schema memberData não exposto no Swagger (testar na doc).
Espaço Fitness · Estudo da EVO API · 10/06/2026 · fonte: spec OpenAPI (Apidog) + api.abcevo.com. Operador responsável: plataforma.