Para devs

Para devs: API, SDKs, MCP y webhooks

El panel usa la misma API que vos. Reservá desde cualquier sistema, recibí eventos firmados y dejá que agentes de IA operen el negocio.

Quickstart en cuatro pasos

  1. 1

    Creá una clave

    En el panel, en Configuración, Desarrolladores: creá una clave de producción con los scopes slots:read y bookings:write. Se muestra una sola vez.

  2. 2

    Buscá horarios

    GET /slots devuelve solo horarios reales que cruzan todos los recursos del servicio.

  3. 3

    Reservá en dos pasos

    POST /holds retiene 10 minutos y POST /holds/id/confirm confirma. Usá Idempotency-Key en todo POST.

  4. 4

    Escuchá los eventos

    Registrá un endpoint en /webhook-endpoints y verificá la firma de cada entrega.

Ejemplos

export WAGEND_KEY="wg_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx"

# 1. Real slots for the service
curl -s "https://api.wagend.app/v1/slots?service_id=svc_corte&from=2026-10-15T09:00:00-03:00&to=2026-10-15T18:00:00-03:00" \
  -H "Authorization: Bearer $WAGEND_KEY"

# 2. 10-minute hold
curl -X POST https://api.wagend.app/v1/holds \
  -H "Authorization: Bearer $WAGEND_KEY" \
  -H "Idempotency-Key: 8c1f2a9e-4b7d-4e0a-9d51-3a6f0c2b7e11" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "svc_corte",
    "start": "2026-10-15T09:45:00-03:00",
    "customer": { "name": "Carlos", "phone": "+5521999990000" }
  }'

# 3. Confirm (use the id returned by step 2)
curl -X POST https://api.wagend.app/v1/holds/HOLD_ID/confirm \
  -H "Authorization: Bearer $WAGEND_KEY" \
  -H "Idempotency-Key: 5d0e7a31-91c4-4f6b-8a2e-7c1b9e4d2f60" \
  -H "Content-Type: application/json" \
  -d '{}'

Las claves de los ejemplos son ficticias. Los SDKs todavía no están publicados en npm ni PyPI: mirá la documentación para usarlos desde el repositorio.

Servidor MCP

El servidor MCP usa la misma clave de API y nunca da más permisos que ella. Hoy lo ejecutás desde el repositorio; la versión alojada en mcp.wagend.app llega próximamente.

Seguí en la documentación

¿Preferís darle la documentación a una IA? Usá llms.txt y llms-full.txt. llms.txt · llms-full.txt