---
title: "Conversaciones agrupadas por fase"
method: GET
path: "/v1/conversations/by-phase"
tags: ["Conversations"]
---

# Conversaciones agrupadas por fase

`GET /v1/conversations/by-phase`

Agrupa las conversaciones por fase del pipeline. Soporta los mismos filtros que el listado de conversaciones.

## Query parameters

- `status` 'opened' | 'closed' | 'inactive'
- `tags` string
- `fromDate` string, date-time
- `toDate` string, date-time
- `channel` string
- `phase` string
- `agent` string
- `preAssigned` string
- `condition` string
- `utmSource` string
- `utmMedium` string
- `utmCampaign` string
- `search` string
- `limit` integer
- `offset` integer
- `page` integer
- `sort` string

## Response `200`

Conversaciones agrupadas por fase

- object
  - `phases` object[]
    - `phase` Phase — Fase del pipeline (etapa de inbox). El listado de conversaciones referencia su fase por `phaseId`; resolvé el nombre con `GET /v1/phases`.
      - `id` string — ID de la fase.
      - `name` string — Nombre legible de la fase.
      - `order` integer — Posición de la fase en el pipeline (0-based).
    - `conversations` ConversationListResponse — Respuesta del listado de conversaciones. **Atención:** `data` NO es un arreglo, es un **objeto (mapa) indexado por el id de la conversación** — cada clave es el `id` y su valor es la conversación. Para recorrerlo usá los valores del objeto (ej. `Object.values(respuesta.data)`), no un índice numérico.
      - `pagination` Pagination — Metadatos de paginación que acompañan a las respuestas de listado. Usá `page`/`limit` o `offset`/`limit` para recorrer todas las páginas mientras `hasNext` sea `true`.
        - `page` integer — Número de página actual (1-based).
        - `limit` integer — Cantidad de resultados por página. Máximo: 100.
        - `total` integer — Total de resultados que matchean la consulta.
        - `totalPages` integer — Cantidad total de páginas.
        - `hasNext` boolean — Indica si hay una página siguiente.
        - `hasPrev` boolean — Indica si hay una página anterior.
      - `data` object — Mapa de conversaciones indexado por el id de cada conversación (la clave es el `conversationId` y el valor es el objeto `Conversation`).

---

[API](https://skmtc.net/cliengo/apis/cliengo-public-api.md) · [All operations](https://skmtc.net/cliengo/apis/cliengo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliengo/cliengo-public-api/revisions/94c7ba7d6a11/schema)