CaseCommentModule

Sub-módulo para gestión de comentarios de casos en Shori.

Permite agregar notas y comentarios a un caso existente para registrar el historial de interacciones y observaciones. Se accede a través de client.caso().comment().

Uso

AddCommentRequest request = AddCommentRequest.builder()
    .casoId("caso-documentId")
    .comment("El cliente confirmó su disponibilidad para el 20/01/2024.")
    .build();

AddCommentResponse resultado = client.caso().comment().add(request);
System.out.println("Comentario ID: " + resultado.getId());

Metodos

add(AddCommentRequest request)

Agrega un comentario o nota a un caso existente.

Los comentarios quedan registrados en el historial del caso y son visibles para todos los usuarios con acceso al caso en la plataforma Shori.

AddCommentRequest request = AddCommentRequest.builder()
    .casoId("a1b2c3d4-e5f6-7890-abcd-ef1234567890")
    .comment("Llamada realizada al cliente. Confirmó recepción de documentos.")
    .build();

AddCommentResponse resultado = client.caso().comment().add(request);
System.out.println("Comentario registrado con ID: " + resultado.getId());

Parametros:

• request — Datos del comentario: ID del caso y texto del comentario

Retorna: AddCommentResponse con el ID del comentario creado

Lanza:

• ApiException — si el caso no existe o hay error en el servidor

---

search(CommentFilter filter)

Busca comentarios de un caso según los filtros especificados.

Usa CommentFilter para construir la consulta con soporte de filtrado por fecha, paginación y ordenamiento. El casoId es requerido.

// Búsqueda básica — últimos 20 comentarios del caso (orden DESC por defecto)
CommentSearchResult resultado = client.caso().comment().search(
    CommentFilter.builder()
        .casoId("caso-documentId")
        .pageSize(20)
        .build()
);
resultado.getComments().forEach(c ->
    System.out.println("[" + c.getCreatedAt() + "] " + c.getComment())
);

// Filtrado por rango de fechas (convierte a UTC automáticamente)
CommentSearchResult resultado = client.caso().comment().search(
    CommentFilter.builder()
        .casoId("caso-documentId")
        .pageSize(50)
        .build()
);

// Con ordenamiento ascendente (comentarios más antiguos primero)
CommentSearchResult resultado = client.caso().comment().search(
    CommentFilter.builder()
        .casoId("caso-documentId")
        .pageNumber(0)
        .pageSize(10)
        .sortDirection(SortDirection.ASC)
        .build()
);

Parametros:

• filter — CommentFilter construido con CommentFilter#build()

Retorna: CommentSearchResult con la lista de comentarios y el total

Lanza:

• ApiException — si hay error en el servidor al ejecutar la búsqueda

---