Agendamento de Atividades para Prospect

Objetivo

Permitir que prospects consultem as atividades disponíveis e realizem o agendamento de uma atividade através do site ou aplicativo da academia, integrando com a API.

Sumário

  1. Consulta e Exibição da Grade de Atividades
  2. Cadastramento e Venda do Serviço para o Prospect
  3. Agendamento da Atividade

Fluxo 1: Consulta e Exibição da Grade de Atividades

Endpoints

1️⃣ Buscar atividades

GET https://evo-integracao-api.w12app.com.br/api/v1/activities

2️⃣ Buscar agenda da atividade
GET https://evo-integracao-api.w12app.com.br/api/v1/activities/schedule

Passo a Passo

1º passo: Filtrar atividades
Utilize o endpoint GET /api/v1/activities, com o campo de busca opcional (exemplo: "locação").
🔸 No retorno, guarde o campo idActivities.

2º passo: Obter grade de horários da atividade
Utilize o endpoint GET /api/v1/activities/schedule preenchendo:

  • idActivities (obtido no passo anterior)
  • showFullWeek = true
  • idMember = 0
  • idBranch (opcional)

🔸 No retorno, salve o idConfiguration e a agenda (datas e horários), que será exibida no site ou aplicativo para o prospect escolher.

Fluxo 2: Cadastramento e Venda do Serviço para o Prospect

Endpoints

1️⃣ Cadastrar prospect
POST https://evo-integracao-api.w12app.com.br/api/v1/prospects

2️⃣ Criar venda para o prospect
POST https://evo-integracao-api.w12app.com.br/api/v2/sales

Passo a Passo

1º passo: Cadastrar prospect
Use POST /api/v1/prospects preenchendo os dados do prospect (nome, email, telefone, etc).
🔸 No retorno, guarde o idProspect.

2º passo: Realizar a venda do serviço
Utilize POST /api/v2/sales, informando:

  • idProspect
  • idBranch
  • idMember = 0
  • payment = 5 (caso o pagamento ocorra pela plataforma)
  • idService

Fluxo 3: Agendamento da Atividade

Endpoint

1️⃣ Agendar atividade
POST https://evo-integracao-api.w12app.com.br/api/v1/activities/schedule/enroll

Passo a Passo

1º passo: Inscrição do prospect na atividade
Utilize o endpoint POST /api/v1/activities/schedule/enroll, preenchendo:

  • idProspect (obtido no fluxo 2)
  • idConfiguration (obtido no fluxo 1)
  • activityDate (data da atividade escolhida pelo prospect, vinda da agenda do fluxo 1)

Exemplo de Requisição

{
  "idConfiguration": 12345,
  "idProspect": 0,
  "activityDate": "2025-03-19",
}