Endpoints · Wagend

Todos os endpoints da v1 num relance, com os formatos mais comuns de requisição e resposta.

O contrato legível por máquina fica no repositório em packages/openapi/openapi.yaml (OpenAPI 3.1).

Agenda

Método	Path	Escopo	Descrição
GET	`/slots`	`slots:read`	Horários disponíveis para um serviço
POST	`/holds`	`bookings:write`	Criar pré-reserva de 10 minutos
POST	`/holds/{id}/confirm`	`bookings:write`	Confirmar (ou `pending_payment` se exigir sinal)
DELETE	`/holds/{id}`	`bookings:write`	Liberar pré-reserva
GET	`/bookings`	`bookings:read`	Listar (filtros: `from`, `to`, `status`, `resource_id`, `customer_id`)
POST	`/bookings`	`bookings:write`	Pré-reserva + confirmação numa chamada
GET / PATCH	`/bookings/{id}`	`bookings:read` / `write`	Ler, atualizar notas ou dados de cadastro
POST	`/bookings/{id}/cancel`	`bookings:write`	Cancelar
POST	`/bookings/{id}/reschedule`	`bookings:write`	Mudar para um novo início
POST	`/bookings/{id}/check-in`	`bookings:write`	Marcar chegada
POST	`/bookings/{id}/no-show`	`bookings:write`	Marcar falta

Catálogo

Método	Path	Escopo
GET / POST	`/services`	`config:read` / `config:write`
GET / POST	`/resources`	`config:read` / `config:write`
GET	`/resource-groups`	`config:read`
POST	`/schedules/{id}/overrides`	`config:write`

Clientes e conversas

Método	Path	Escopo
GET	`/customers`	`customers:read`
DELETE	`/customers/{id}`	`customers:read` + papel owner (anonimiza, LGPD)
GET	`/conversations`	`messages:read`
GET / POST	`/conversations/{id}/messages`	`messages:read` / `messages:write`
POST	`/conversations/{id}/handoff`	`messages:write`

Plataforma

Método	Path	Escopo
GET	`/me`	qualquer
GET / POST	`/webhook-endpoints`	`webhooks:manage`
GET	`/events`	`bookings:read`

Exemplo: slots

GET /v1/slots?service_id=svc_laser&from=2026-10-20T09:00:00-03:00&to=2026-10-20T20:00:00-03:00&around=2026-10-20T18:00:00-03:00

{
  "data": [
    { "start": "2026-10-20T17:45:00-03:00", "end": "2026-10-20T18:30:00-03:00", "resource_ids": ["res_ana", "res_laser1", "res_room2"] },
    { "start": "2026-10-20T18:45:00-03:00", "end": "2026-10-20T19:30:00-03:00", "resource_ids": ["res_carla", "res_laser1", "res_room1"] }
  ],
  "unavailable_reason": null
}

Exemplo: objeto de agendamento

{
  "id": "bkg_7Qx1",
  "status": "confirmed",
  "service_id": "svc_laser",
  "start": "2026-10-20T17:45:00-03:00",
  "end": "2026-10-20T18:30:00-03:00",
  "party_size": 1,
  "customer": { "id": "cus_31", "name": "Marina", "phone": "+5521988887777", "locale": "pt" },
  "allocations": [
    { "resource_id": "res_ana", "start": "2026-10-20T17:45:00-03:00", "end": "2026-10-20T18:40:00-03:00", "units": 1 },
    { "resource_id": "res_laser1", "start": "2026-10-20T17:45:00-03:00", "end": "2026-10-20T18:40:00-03:00", "units": 1 },
    { "resource_id": "res_room2", "start": "2026-10-20T17:45:00-03:00", "end": "2026-10-20T18:40:00-03:00", "units": 1 }
  ],
  "payment": { "status": "paid", "amount_cents": 5000 },
  "source": "whatsapp",
  "created_at": "2026-10-19T11:02:13-03:00"
}

As alocações incluem o buffer (aqui 10 minutos depois do serviço).