> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### ElevenAgents

- **La página de usuarios ya está disponible de forma general**: La página de [listar usuarios](/docs/es/api-reference/users/list), que agrupa conversaciones por identificador de usuario, ya está disponible para todos los espacios de trabajo. Te permite ver en una vista unificada todos los usuarios que han interactuado con tus agentes, su historial de conversaciones y sus datos de contacto.

- **Cabeceras SIP entrantes como variables dinámicas**: Las cabeceras SIP personalizadas `X-` de llamadas entrantes mediante trunking SIP ahora se exponen automáticamente como variables dinámicas en las conversaciones de ElevenAgents. Cualquier cabecera SIP personalizada (por ejemplo, `X-Contact-ID`, `X-Campaign-ID`) enviada por quien llama está disponible en el prompt del agente mediante `{{sip_contact_id}}`, `{{sip_campaign_id}}`, etc. Estas variables también son visibles en el historial de conversaciones, en la pestaña Llamada telefónica. Las cabeceras reservadas, como `X-Call-ID` y `X-Caller-ID`, siguen asignándose a `system__call_sid` y `system__caller_id` y no se sobrescriben.

- **Filtrado de conversaciones por resultado de herramienta**: Las rutas de API [listar conversaciones](/docs/es/api-reference/conversations/list) y [búsqueda de texto en conversaciones](/docs/es/api-reference/conversations/messages/text-search) ahora aceptan los parámetros de consulta `tool_names_successful` y `tool_names_errored` (matriz de cadenas) para filtrar conversaciones según las herramientas que se completaron correctamente o devolvieron errores durante la llamada.

- **Mejoras al listado de usuarios**: La ruta de API [listar usuarios](/docs/es/api-reference/users/list) ahora admite un parámetro de consulta `sort_by` que acepta `last_contact_unix_secs` (predeterminado) o `conversation_count`, y un parámetro de consulta `branch_id` para filtrar usuarios por rama de agente.

- **Eliminación forzada de herramientas**: La ruta de API [eliminar herramienta](/docs/es/api-reference/tools/delete) ahora acepta un parámetro de consulta `force` (booleano, `false` de forma predeterminada). Cuando se establece en `true`, la herramienta se elimina aunque la usen agentes, y se elimina automáticamente de todos los agentes y ramas dependientes.

- **Retención de embeddings de conversaciones**: La respuesta de [configuración de ElevenAgents](/docs/es/api-reference/workspace/get) ahora incluye `conversation_embedding_retention_days`, que controla durante cuánto tiempo se conservan los embeddings de conversaciones (máximo 365 días). Un valor `null` utiliza el valor predeterminado del sistema de 30 días.

- **Guardrail de umbral de contenido**: Se ha añadido el esquema `ContentThresholdGuardrail`, que proporciona un guardrail configurable basado en umbrales con una marca `is_enabled` y un valor `threshold` para la moderación de contenido.

### Espacios de trabajo

- **Obtener todos los grupos del espacio de trabajo**: La nueva ruta de API [GET /v1/workspace/groups](/docs/es/api-reference/workspace/groups/list) devuelve todos los grupos del espacio de trabajo, incluido el nombre, ID, miembros, permisos, límite de uso y recuento de caracteres de cada grupo.

- **Tipo de plaza en invitaciones masivas al espacio de trabajo**: La ruta de API [invitar a varios usuarios](/docs/es/api-reference/workspace/invites/create-batch) ahora acepta un campo opcional `seat_type` para especificar el tipo de plaza (por ejemplo, `workspace_member`, `workspace_admin`) para todos los usuarios invitados en una operación masiva.

- **Mejoras de fiabilidad del SSO móvil**: Se ha corregido una regresión por la que el inicio de sesión con SSO en dispositivos móviles se quedaba bloqueado en "Autenticando..." después de que un usuario cerrara sesión e intentara volver a iniciar sesión. También se ha corregido el cambio de espacio de trabajo para usuarios de SSO móvil que inician sesión mediante proveedores SAML u OIDC.

### Música

- **Control de duración de secciones**: La ruta de API [generar música detallada](/docs/es/api-reference/music/compose-detailed) ahora admite `respect_sections_durations` (booleano), que controla si el modelo respeta la duración especificada para cada sección del plan de composición.

### ElevenCreative Studio

- **Indicador de contenido visual del capítulo**: Los modelos de respuesta de capítulos ahora incluyen un campo booleano `has_visual_content` que indica si el capítulo contiene contenido visual.

- **Estilos de sombra y contorno de texto**: El estilo de texto de ElevenCreative Studio ahora admite las opciones `text_shadow` y `text_outline` mediante los nuevos esquemas `StudioTextStyleShadowModel` y `StudioTextStyleOutlineModel`, lo que permite una personalización visual del texto más completa en los proyectos de ElevenCreative Studio.

- **Tipo de tarea de clip de generación de contenido multimedia**: El enum `PendingClipTask.type` ahora incluye el valor `media_generation`, ampliando la categorización de tareas de clips para cubrir workflows de generación de contenido multimedia.

### Lanzamientos de SDK

#### SDK de Python

- [v2.39.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.0) - Se ha añadido compatibilidad con el tipo de evento WebSocket `multimodal_message` en las conversaciones en tiempo real de ElevenAgents.
- [v2.39.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.1) - Regeneración de Fern para ajustarse al esquema de API más reciente.

#### SDK de JavaScript

- [v2.39.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.39.0) - Regeneración de Fern para ajustarse al esquema de API más reciente.

#### SDK de iOS

- [v3.1.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.0) - Varias mejoras en el SDK de Swift de ElevenAgents:
  - Los errores del servidor ahora se muestran mediante el callback `onError`, lo que hace que la gestión de errores sea más coherente.
  - Se ha añadido la gestión del estado del agente basada en eventos para una observación del estado más clara.
  - Ahora se admite el silenciamiento por software junto con la detección de voz, lo que permite un control del audio más granular.
  - Se ha mejorado la base de código para usar Swift Concurrency en todo momento.
  - Se ha corregido un bloqueo que se producía durante el inicio en las compilaciones de lanzamiento de iOS.
  - Se ha actualizado la marca para reflejar el cambio de marca de ElevenAgents.

#### Paquetes

- [@elevenlabs/client@0.15.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.1) - Se ha añadido remuestreo de audio para el audio de salida cuando no se puede obtener la frecuencia de muestreo requerida del sistema, lo que mejora la compatibilidad entre dispositivos.
- [@elevenlabs/react@0.14.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.2) - Se ha actualizado para depender de `@elevenlabs/client@0.15.1`.
- [@elevenlabs/convai-widget-core@0.10.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.3) - Se ha actualizado para depender de `@elevenlabs/client@0.15.1`.

### API

<Accordion title="Ver cambios de la API">

## Nuevas rutas de API

- [Obtener todos los grupos del espacio de trabajo](/docs/es/api-reference/workspace/groups/list) - `GET /v1/workspace/groups` - Devuelve todos los grupos del espacio de trabajo con sus miembros, permisos y límites de uso.

## Rutas de API actualizadas

### ElevenAgents

- [Listar conversaciones](/docs/es/api-reference/conversations/list)

  - Se ha añadido el parámetro de consulta `tool_names_successful` (matriz de cadenas, opcional) para filtrar conversaciones en las que las herramientas especificadas tuvieron llamadas correctas
  - Se ha añadido el parámetro de consulta `tool_names_errored` (matriz de cadenas, opcional) para filtrar conversaciones en las que las herramientas especificadas devolvieron errores

- [Búsqueda de texto en conversaciones](/docs/es/api-reference/conversations/messages/text-search)

  - Se ha añadido el parámetro de consulta `tool_names_successful` (matriz de cadenas, opcional)
  - Se ha añadido el parámetro de consulta `tool_names_errored` (matriz de cadenas, opcional)

- [Listar usuarios](/docs/es/api-reference/users/list)

  - Se ha añadido el parámetro de consulta `sort_by` (cadena, opcional) que acepta `last_contact_unix_secs` (predeterminado) o `conversation_count`
  - Se ha añadido el parámetro de consulta `branch_id` (cadena, opcional) para filtrar usuarios por rama de agente

- [Eliminar herramienta](/docs/es/api-reference/tools/delete)

  - Se ha añadido el parámetro de consulta `force` (booleano, opcional, `false` de forma predeterminada) para eliminar una herramienta independientemente de las dependencias de agentes y eliminarla automáticamente de todos los agentes y ramas dependientes

- [Obtener configuración de ElevenAgents](/docs/es/api-reference/workspace/get), [Actualizar configuración de ElevenAgents](/docs/es/api-reference/workspace/update)

  - Se ha añadido el campo `conversation_embedding_retention_days` (entero, opcional, máximo 365) para configurar durante cuánto tiempo se conservan los embeddings de conversaciones

### Espacios de trabajo

- [Invitar a varios usuarios](/docs/es/api-reference/workspace/invites/create-batch)

  - Se ha añadido el campo `seat_type` (cadena, opcional) para especificar el tipo de plaza de todos los usuarios invitados

### Música

- [Generar música detallada](/docs/es/api-reference/music/compose-detailed)

  - Se ha añadido el campo `respect_sections_durations` (booleano, opcional) para controlar si el modelo respeta las duraciones por sección en el plan de composición

### ElevenCreative Studio

- [Obtener capítulo](/docs/es/api-reference/studio/get-chapter), [Añadir capítulo](/docs/es/api-reference/studio/add-chapter), [Actualizar capítulo](/docs/es/api-reference/studio/update-chapter)

  - Se ha añadido el campo `has_visual_content` (booleano) a los modelos de respuesta de capítulos

## Cambios en los esquemas

### Nuevos esquemas

- `ContentThresholdGuardrail` - Guardrail de contenido basado en umbrales con los campos `is_enabled` (booleano) y `threshold` (número, `0.3` de forma predeterminada)
- `AgentPromptChangeToolConfig` - Configuración de herramientas del sistema para cambios dinámicos en el prompt del agente
- `StudioTextStyleShadowModel` - Estilo de sombra de texto para ElevenCreative Studio
- `StudioTextStyleOutlineModel` - Estilo de contorno de texto para ElevenCreative Studio
- `UsersSortBy` - Enum para las opciones de ordenación del listado de usuarios: `last_contact_unix_secs`, `conversation_count`
- `VideoAnalysis`, `VideoAnalysisResult`, `VideoKeyMoment`, `VideoSegment`, `VideoSubject`, `VideoTranscription`, `VideoTranscriptionWord` - Esquemas de resultados de análisis de vídeo para el procesamiento de clips

### Esquemas modificados

- `ConversationHistorySIPTrunkingPhoneCallModel` - Se ha añadido el campo `sip_header_dynamic_variables` para cabeceras X personalizadas de SIP entrantes
- `PendingClipTask` - Se ha añadido `media_generation` al enum `type`

</Accordion>