Consulta de Registros de Cambios

A través de la API de Sagicc, puedes consultar el registro de cambios de los distintos recursos de la plataforma. Esta funcionalidad permite integrar Sagicc fácilmente con otros sistemas, proporcionando trazabilidad sobre cambios realizados en recursos importantes como casos, clientes, campañas, usuarios, etc. Esto no solo mejora la transparencia, sino que también facilita el control interno, el cumplimiento de políticas y la toma de decisiones basada en datos confiables.

Para consultar la información del registros de cambios, realiza una petición de tipo GET al siguiente endpoint:

https://{{sagicc_instance_url}}/api/audits?modelo={model}&id={id}

Asegúrate de modificar los siguientes parámetros de acuerdo a tus necesidades:

model: Nombre del modelo sobre el cual se realizará la consulta.
id: Identificador del recurso del modelo sobre el cual se realizará la consulta.

Si la petición se ejecuta exitosamente, la información se obtendrá en formato JSON, organizada de forma ascendente por su fecha de creación, y la respuesta devolverá un código 200 junto con un mensaje de éxito. En caso de que la solicitud falle, la respuesta incluirá un código 400 acompañado de un mensaje que detallará la causa del error.

La respuesta exitosa obtenida tendrá la siguiente estructura:

{
    "status": "OK",
    "code": "ADS001",
    "message": "El registro de cambios ha sido obtenido exitosamente.",
    "fullMessage": "ADS001 - El registro de cambios ha sido obtenido exitosamente.",
    "statusResult": true,
    "result": {
        "data": [
            {
                "audit_id": "18648",
                "audit_table": "Caso",
                "audit_event": "updated",
                "audit_field": "Estado",
                "audit_old_value": 0,
                "audit_new_value": 1,
                "audit_user": "John Wick",
                "audit_ip_address": "186.86.27.206",
                "audit_created_at": "2025-07-04 15:18:53"
            },
            {...},
            {...},
            {...}
        ]
    }
}

La respuesta puede contener uno o varios objetos, cada uno detallando una acción específica realizada sobre un recurso. La información incluida en cada objeto es la siguiente:

audit_id: Identificador único del registro de auditoría.
audit_table: Indica la entidad o módulo sobre el cual se realizó la acción.
audit_event: Tipo de evento registrado. Puede ser uno de los siguientes:
- created: creación del recurso,
- updated: modificación del recurso,
- deleted: eliminación del recurso.
audit_field: Campo específico del recurso que fue modificado.
audit_old_value: Valor que tenía el campo antes del cambio.
audit_new_value: Valor asignado al campo después del cambio.
audit_user: Nombre del usuario que realizó la acción.
audit_ip_address: Dirección IP desde la cual se ejecutó la acción.
audit_created_at: Fecha y hora exactas en que se registró el evento.