Distribuidor - Tickets

Métodos relacionados con los tickets.

Lista de datos para generar ticket - getdataticket
Listado de tickets - gettickets
Crear ticket - createticket
Subir imagenes para ticket - uploadimageticket
Responder ticket - createticketdetalle
Obtener detalle del ticket - getTicketAnswer

Lista de datos para generar ticket - getdataticket

POST https://api.service24gps.com/api/v1/getdataticket

Obtiene los datos de plataforma, clasificación, tipo y acción.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getdataticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": {
        "plataforma": {
            "1": "Backoffice",
            "2": "OnTracking",
            "3": "Backoffice",
            "4": "OnReports",
            "5": "Aplicaciones M&oacute;viles",
            "6": "OnBus",
            "8": "Alertas",
            "10": "OnDriving",
            "11": "OnTool",
            "12": "OnRouting",
            "13": "OnRoad",
            "15": "OnWall",
            "16": "OnAlert",
            "17": "OnPatrol",
            "18": "OnDocs",
            "19": "OnDelivery",
            "22": "OnNavigate",
            "67": "OnDash",
            "70": "OnStatus",
            "80": "OnMobile"
        },
        "clasificacionTicket": {
            "1": "facturacin",
            "2": "baja-de-activo",
            "3": "alta-de-activo",
            "4": "siniestrosreposiciones",
            "5": "calidadfuncionamiento-del-servicio",
            "6": "comunicacin-con-operadorrepresentante",
            "7": "ventas",
            "8": "soporte",
            "9": "desarrollo"
        },
        "TipoTicket": {
            "1": "pedido",
            "2": "reclamo",
            "3": "consulta",
            "4": "sugerencia",
            "0": "urgencia"
        },
        "AccionTicket": {
            "1": "asignar",
            "2": "comentar",
            "4": "cancelar",
            "3": "cerrar",
            "0": "en-espera-de-respuesta"
        },
        "StatusTicket": {
            "1": "Pendiente",
            "2": "En resolución",
            "3": "Cerrado",
            "4": "Cancelado",
            "0": "En espera de respuesta",
            "5": "Reabierto"
        }
    }
}

Ver campos de respuesta:

Campo	Descripción	Formato
plataforma	listado de plataformas.	JSON
clasificacionTicket	Listado de clasificaciones.	JSON
TipoTicket	Listado de tipos.	JSON
AccionTicket	Listado de acciones.	JSON
StatusTicket	Listado de status ticket.	JSON

Listado de tickets - gettickets

POST https://api.service24gps.com/api/v1/gettickets

Obtiene el listado total de tickets o los tickets de un cliente en especifico.

Nota: El método gettickets solo muestra los tickets de clientes que están habilitados, si están eliminados no se mostrará la información en la respuesta.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idCliente	(Opcional) Identificador único del cliente. -Consultar el id de los clientes en el método getClients.	16572

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/gettickets' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
--form 'idCliente="16572"'

Respuesta de ejemplo:

{
   "status":200,
   "data":{
      "909081":[
          {
             "idTicket":"12313",
             "cliente":"Luis",
             "nombre":"Ticket de prueba1",
             "telefonoContacto":"2222123453",
             "emailContacto":"usuario1@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"desarrollo",
             "tipo":"consulta",
             "descripcion":"Solicitud de activos",
             "status":"En resolución",
             "fecha":"2024-03-07",
             "hora":"13:30:19"
          },
          {
             "idTicket":"12314",
             "cliente":"Enrique",
             "nombre":"Ticket de prueba2",
             "telefonoContacto":"2222123454",
             "emailContacto":"usuario2@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"desarrollo",
             "tipo":"sugerencia",
             "descripcion":"Equipo : dvr J03554455",
             "status":"Cerrado",
             "fecha":"2022-04-22",
             "hora":"17:34:28"
          },
      ],
      "909082":[
          {
             "idTicket":"12315",
             "cliente":"Julio",
             "nombre":"Ticket de prueba3",
             "telefonoContacto":"2222123455",
             "emailContacto":"usuario3@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"alta-de-activo",
             "tipo":"pedido",
             "descripcion":"instalcion hora tecnico",
             "status":"Cerrado",
             "fecha":"2021-10-01",
             "hora":"11:13:59"
          }
      ],
      "909083":[
          {
             "idTicket":"12316",
             "cliente":"Eduardo",
             "nombre":"Ticket de prueba4",
             "telefonoContacto":"2222123455",
             "emailContacto":"usuario4@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"alta-de-activo",
             "tipo":"pedido",
             "descripcion":"instalcion hora tecnico",
             "status":"Cerrado",
             "fecha":"2021-10-01",
             "hora":"11:13:59"
          }
      ]
   }
}

Ver campos de respuesta:

Campo	Descripción	Formato
idTicket	Identificador único del ticket en el sistema.	Entero
cliente	Nombre del cliente.	Cadena de Texto
nombre	Nombre asignado al ticket.	Cadena de Texto
telefonoContacto	Número telefónico del contacto.	Cadena de Texto
emailContacto	Correo electrónico del contacto.	Cadena de Texto
plataforma	Nombre de la plataforma.	Cadena de Texto
clasificacion	Nombre de la clasificación.	Cadena de Texto
tipo	Nombre del tipo del ticket.	Cadena de Texto
descripcion	Descripción sobre el ticket.	Cadena de Texto
status	Estatus del ticket.	Cadena de Texto
fecha	Fecha del ticket.	Cadena de Texto
hora	Hora del ticket.	Cadena de Texto

Crear ticket - createticket

POST https://api.service24gps.com/api/v1/createticket

Este método permite crear un ticket.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
nombre	Nombre con el que se identificará el ticket dentro de la plataforma.	cliente
telefono	Número telefónico de contacto	123456789
email	Correo electrónico de contacto	test@test.com
idPlataforma	Identificador único de plataforma	1
idClasificacion	Identificador único de clasificación	1
idTipo	Identificador único de tipo	1
idCliente	Identificador único de cliente	1
activos	Lista de activos separados por coma	activo 1. activo2, activo 3
fechaInicio	Fecha inicio	2022-01-01
fechaFin	Fecha fin	2022-01-21
descripcion	Descripción sobre el ticket.	Buena tarde, Se solicita apoyo

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/createticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'nombre="cliente"' \
--form 'tipo_cerca="1"' \
--form 'telefono="123456789"' \
--form 'email="test@test.com"' \
--form 'idPlataforma="1"' \
--form 'idClasificacion="1"' \
--form 'idTipo="1"' \
--form 'idCliente="1"' \
--form 'activos="activo1, activo 2, activo 3"' \
--form 'fechaInicio="2022-01-01"' \
--form 'fechaFin="2022-01-21"' \
--form 'descripcion="Buena tarde, Se solicita apoyo"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": {
        "idticket": 1
    }
}

Ver campos de respuesta:

idticket

Identificador único del ticket

Entero

Subir imagenes para ticket - uploadimageticket

POST https://api.service24gps.com/api/v1/uploadimageticket

Este método permite subir imágenes para adjuntar la url en la descripción del ticket

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
file[]	Arreglo de archivos	file[]=@"/home/Usuario/Escritorio/prueba.jpg" file[]=@"/home/Usuario/Escritorio/cliente.jpg"

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/uploadimageticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'file[]=@"/home/Usuario/Escritorio/prueba.jpg"' \
--form 'file[]=@"/home/Usuario/Escritorio/cliente.jpg"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        "https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642610073_prueba.png",
        "https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642610074_cliente.png"
    ]
}

Ver campos de respuesta:

Url imagenes

Url de las imagenes

JSON

Responder ticket - createticketdetalle

POST https://api.service24gps.com/api/v1/createticketdetalle

Este método permite responder un ticket.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	(Requerido) Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	(Requerido) Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
IdTicket	(Requerido) Identificador único de ticket a responder.	288282
IdAccionticket	(Requerido) Identificador único de acción.	3
descripcion	(Requerido) Descripción sobre el detalle del ticket.	Buena tarde, Se solicita apoyo
alertamail	(Requerido) Bandera para enviar alerta por mail (true) o no (false).	true
alertasms	(Requerido) Bandera para enviar alerta por sms (true) o no (false).	false
alertasoporte	(Requerido) Bandera para enviar a soporte (true) o no (false).	false
mostraralusuario	(Requerido) Bandera para mostrar al usuario (true) o no (false).	false
imageurl	(Opcional) Array de url de imágenes devuelto por el método uploadimageticket.	['https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png imageurl', 'https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png' ]
idstatus_ticket	(Opcional) Identificador único de status del ticket. El catálogo de status ticket se puede obtener en el método getDataTicket.	3

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/createticketdetalle' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'IdTicket="288282"' \
--form 'IdAccionticket="3"' \
--form 'descripcion="Buenas tarde, Se solicita apoyo"' \
--form 'alertamail="true"' \
--form 'alertasms="false"' \
--form 'alertasoporte="false"' \
--form 'mostraralusuario="false"' \
--form 'imageurl="['https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png',
		'https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png']"'\
--form 'idstatus_ticket="3"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": {
        "idticket": 12871287
    }
}

Ver campos de respuesta:

idticket

Identificador único del detalle del ticket.

Entero

Obtener detalle del ticket - getTicketAnswer

POST https://api.service24gps.com/api/v1/getTicketAnswer

Obtiene el detalle del ticket.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	(Requerido) Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	(Requerido) Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
Idticket	(Requerido) Identificador único del ticket.	898915

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getTicketAnswer' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'\
--form 'Idticket="898915"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": {
        "Id": "898915",
        "Descripcion": "<p>Estimados, solicito el apoyo para obtener la información de mi equipo.</p>\n",
        "Detalle": [
            {
                "Idticket_detalle": "33547,
                "Usuario": "cliente1",
                "Fecha": "2023-07-10",
                "Hora": "09:01:52",
                "Respuesta": "Hola buenos días:\n\nle daremos seguimiento al tema.",
                "Leido": "No"
            },
            {
                "Idticket_detalle": "33546
                "Usuario": "cliente1",
                "Fecha": "2023-07-05",
                "Hora": "15:49:34",
                "Respuesta": "Hola buenos dias, pueden enviar el número del equipo.",
                "Leido": "Sí"
            },
            {
                "Idticket_detalle": "33545,
                "Usuario": "cliente1",
                "Fecha": "2023-07-05",
                "Hora": "09:27:42",
                "Respuesta": "Buenos días, se envió la información. \n\nsaludos",
                "Leido": "Sí"
            }
        ]
    }
}

Ver campos de respuesta:

Campo	Descripción	Formato
Id	Identificador único del ticket.	Entero
Descripcion	Descripción del ticket.	Texto
Detalle	Detalle del ticket.	JSON