Endpoint unificado para obtener conversaciones. Funciona en dos modos que se
seleccionan de forma automática según los parámetros enviados.

Modo búsqueda

Se activa cuando se envía el parámetro query. Devuelve las conversaciones que
coinciden con el término buscado. El parámetro search_type define cómo se busca:

• contactName (valor por defecto): busca por nombre del contacto o por
  número de teléfono. Ideal para encontrar la conversación de una persona.
• all: busca por coincidencia dentro del contenido de los mensajes.
  Ideal para encontrar conversaciones donde se mencionó una palabra o frase.

Cuando se envía query, los parámetros de filtrado (status, phones, labels,
agents, dates, etc.) no se tienen en cuenta.

Modo filtros

Se usa cuando no se envía query. Devuelve el listado de conversaciones
aplicando los filtros indicados: estado, líneas de WhatsApp, etiquetas, agentes,
rango de fechas, entre otros. Si no se envía ningún filtro, se devuelven todas
las conversaciones.

Paginación por cursor

Ambos modos usan paginación por cursor, no por número de página. Cada
respuesta incluye un objeto pagination con:

• next_cursor: cursor de la página siguiente.
• prev_cursor: cursor de la página anterior.
• has_more: true si existen más resultados después de la página actual.

Para avanzar o retroceder, reenvíe el valor de next_cursor o prev_cursor en el
parámetro cursor de la siguiente petición. El cursor es un valor opaco: no
debe interpretarse ni modificarse, solo reenviarse tal cual. La primera página se
solicita sin enviar cursor. Un cursor en null indica que no hay más
páginas en esa dirección.