VitrinaAPI

SLAs

Los objetivos de primera respuesta y resolución que un ticket debe cumplir, y qué canales/prioridades los disparan.

Beta
Puede cambiar en cualquier momento, con una entrada en el changelog y aviso a quienes la llamaron recientemente — ver versionado.

Descarga la proyección completa de la API pública: openapi.json.

Fijar SLAs y automatizar acciones explica este recurso en prosa, con ejemplos ejecutables.

MétodoRutaQué hace
GET/slasList SLA policies
POST/slasCreate an SLA policy
DELETE/slas/{id}Delete an SLA policy
GET/slas/{id}Fetch one SLA policy
PUT/slas/{id}Update an SLA policy

GET /slas

List SLA policies

Every policy in the workspace. Unfiltered and unpaginated — a workspace configures a handful of policies, not thousands.

curl https://api.vitrinadev.com/api/v1/slas \
  -H "Authorization: Bearer $VITRINA_KEY"

Ejemplo de respuesta (200)

{
  "data": [
    {
      "id": "d7d7d7d7-0000-4000-8000-000000000001",
      "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
      "name": "Soporte estándar",
      "description": "Primera respuesta en media hora hábil, resolución en un día.",
      "target_first_response_minutes": 30,
      "target_resolution_minutes": 1440,
      "business_hours_only": true,
      "applies_to": {
        "channel": "whatsapp"
      },
      "active": true,
      "created_at": "2026-01-10T13:00:00.000Z",
      "updated_at": "2026-09-10T13:00:00.000Z"
    }
  ],
  "meta": {
    "total": 1
  }
}

Responde: 200 · 400 · 401 · 403 · 404 · 409 · 429

POST /slas

Create an SLA policy

Both targets are optional and independent: a policy can set only a first-response target, only a resolution target, or both. name is unique per workspace (a collision is a 409).

Cuerpo

CampoTipoObligatorioRestricciones
namestringsímín. 1, máx. 200
descriptionstring | null—máx. 2000
target_first_response_minutesinteger | null—> 0
target_resolution_minutesinteger | null—> 0
business_hours_onlyboolean—
applies_toobject—
activeboolean—
curl -X POST https://api.vitrinadev.com/api/v1/slas \
  -H "Authorization: Bearer $VITRINA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Soporte estándar",
    "target_first_response_minutes": 30,
    "target_resolution_minutes": 1440,
    "business_hours_only": true,
    "applies_to": {
      "channel": "whatsapp"
    }
  }'

Ejemplo de respuesta (201)

{
  "data": {
    "id": "d7d7d7d7-0000-4000-8000-000000000001",
    "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
    "name": "Soporte estándar",
    "description": "Primera respuesta en media hora hábil, resolución en un día.",
    "target_first_response_minutes": 30,
    "target_resolution_minutes": 1440,
    "business_hours_only": true,
    "applies_to": {
      "channel": "whatsapp"
    },
    "active": true,
    "created_at": "2026-01-10T13:00:00.000Z",
    "updated_at": "2026-09-10T13:00:00.000Z"
  }
}

Responde: 201 · 400 · 401 · 403 · 404 · 409 · 429

DELETE /slas/{id}

Delete an SLA policy

Removes the policy. Conversations and tickets it applied to keep whatever coverage state they already reached; nothing is recomputed against a policy that no longer exists.

ParámetroEnTipoObligatorioRestricciones
idpathuuidsí
curl -X DELETE https://api.vitrinadev.com/api/v1/slas/<id> \
  -H "Authorization: Bearer $VITRINA_KEY"

Responde: 204 · 400 · 401 · 403 · 404 · 409 · 429

GET /slas/{id}

Fetch one SLA policy

The policy — both targets, applies_to and business_hours_only.

ParámetroEnTipoObligatorioRestricciones
idpathuuidsí
curl https://api.vitrinadev.com/api/v1/slas/<id> \
  -H "Authorization: Bearer $VITRINA_KEY"

Ejemplo de respuesta (200)

{
  "data": {
    "id": "d7d7d7d7-0000-4000-8000-000000000001",
    "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
    "name": "Soporte estándar",
    "description": "Primera respuesta en media hora hábil, resolución en un día.",
    "target_first_response_minutes": 30,
    "target_resolution_minutes": 1440,
    "business_hours_only": true,
    "applies_to": {
      "channel": "whatsapp"
    },
    "active": true,
    "created_at": "2026-01-10T13:00:00.000Z",
    "updated_at": "2026-09-10T13:00:00.000Z"
  }
}

Responde: 200 · 400 · 401 · 403 · 404 · 409 · 429

PUT /slas/{id}

Update an SLA policy

A PUT that behaves as a PATCH: only the fields present are applied and at least one is required.

ParámetroEnTipoObligatorioRestricciones
idpathuuidsí

Cuerpo

CampoTipoObligatorioRestricciones
namestring—mín. 1, máx. 200
descriptionstring | null—máx. 2000
target_first_response_minutesinteger | null—> 0
target_resolution_minutesinteger | null—> 0
business_hours_onlyboolean—
applies_toobject—
activeboolean—
curl -X PUT https://api.vitrinadev.com/api/v1/slas/<id> \
  -H "Authorization: Bearer $VITRINA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_first_response_minutes": 20
  }'

Ejemplo de respuesta (200)

{
  "data": {
    "id": "d7d7d7d7-0000-4000-8000-000000000001",
    "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
    "name": "Soporte estándar",
    "description": "Primera respuesta en media hora hábil, resolución en un día.",
    "target_first_response_minutes": 20,
    "target_resolution_minutes": 1440,
    "business_hours_only": true,
    "applies_to": {
      "channel": "whatsapp"
    },
    "active": true,
    "created_at": "2026-01-10T13:00:00.000Z",
    "updated_at": "2026-09-10T13:00:00.000Z"
  }
}

Responde: 200 · 400 · 401 · 403 · 404 · 409 · 429

Roles personalizados

El catálogo de scopes y visibilidad por rol — acceso efectivo, no una etiqueta.

Notas de venta

El documento que vende el auto: emitir, aprobar (lo que lo hace legalmente válido y marca la unidad vendida) y anular.

En esta página

GET /slasPOST /slasDELETE /slas/{id}GET /slas/{id}PUT /slas/{id}