Skip to main content

​
List Ticket Subjects

Returns all valid subjects for creating support tickets in WispHub, grouped by priority level. Ideal for bots or external interfaces that need to present the user with a list of options before opening a support request.

​
Endpoint

GET /api/v1/tickets/subjects
This endpoint requires JWT authentication. Include the Authorization: Bearer <token> header.

​
Request

No parameters or request body required.

​
Headers

HeaderValueRequired
AuthorizationBearer <access_token>✅ Yes

​
Response

​
200 OK

{
  "ok": true,
  "type": "success",
  "action": "SUBJECTS_LISTED",
  "data": {
    "by_priority": {
      "low": [
        "Cambio de Contraseña en Router Wifi",
        "Cambio de Domicilio",
        "Recolección De Equipos",
        "Cancelación",
        "Desconexión"
      ],
      "normal": [
        "Internet Lento",
        "Internet Intermitente",
        "Antena Desalineada",
        "Cables Mal Colocados",
        "Cableado Para Modem Extra"
      ],
      "high": [
        "No Tiene Internet",
        "Antena Dañada",
        "No Responde la Antena",
        "No Responde el Router Wifi",
        "Router Wifi Reseteado (Valores de Fabrica)",
        "Cambio de Router Wifi",
        "Cambio de Antena",
        "Cambio de Antena + Router Wifi",
        "Cable UTP Dañado",
        "PoE Dañado",
        "Conector Dañado",
        "Antena valores De Fabrica",
        "Eliminador Dañado",
        "RJ45 Dañado",
        "Alambres Rotos",
        "Reconexión",
        "Cable Fibra Dañado",
        "Jumper Dañado"
      ],
      "very_high": [
        "Troncal Dañado",
        "Caja Nap Dañada",
        "Cambio A Fibra Óptica"
      ]
    },
    "all": [
      "Cambio de Contraseña en Router Wifi",
      "Cambio de Domicilio",
      "...",
      "Cambio A Fibra Óptica"
    ]
  },
  "message": null,
  "meta": null
}
The subject strings are in Spanish because they map directly to WispHub Net ticket categories. They must be passed as-is when creating a ticket.

​
Response Fields

​
data.by_priority
object
Subjects grouped by priority level. Useful for building categorized dropdown menus.
​
data.all
string[]
Flat list of all valid subjects regardless of priority. Useful for validation or search.

​
Priority Reference Table

Priority LevelValueDescription
low1Administrative requests, no technical urgency
normal2Service degradation (slowness, intermittent connectivity)
high3Complete service loss or damaged equipment
very_high4Trunk infrastructure or fiber optic failure
The priority level determines how urgently WispHub dispatches a technician. Use very_high only for large-scale infrastructure failures.

​
Code Examples

curl -X GET http://localhost:8000/api/v1/tickets/subjects \
  -H "Authorization: Bearer <your_token>"

​
Error Responses

​
401 Unauthorized — Missing or Invalid Token

{
  "detail": "Could not validate credentials."
}

​
Use Case: Bot Integration

This endpoint is especially useful for WhatsApp bots or self-service interfaces:
  1. When starting a support flow, call GET /api/v1/tickets/subjects to fetch the up-to-date list.
  2. Present the options to the user grouped by urgency or as a flat list.
  3. When creating the ticket, pass the selected subject to POST /api/v1/tickets. WispHub will automatically assign the priority based on the subject.

Create Ticket

Create a ticket using one of these subjects

Check Zone Blocked

Check if a zone has capacity before creating a ticket