> 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, ElevenCreative y ElevenAPI

Estamos pasando de la percepción de un único producto («ElevenLabs») a una estructura basada en plataformas con familias de productos claramente definidas:

- ElevenAgents (antes Plataforma de Agents)
- ElevenCreative (antes Plataforma Creativa)
- ElevenAPI (nueva, la Plataforma para desarrolladores)

Ya verás estos cambios reflejados en la documentación y los readmes de los SDK.

### Servidores globales salen de beta

El enrutamiento global ahora es la opción predeterminada, en lugar de una opción voluntaria.

Antes, el servidor predeterminado de la API de ElevenLabs se encontraba en Estados Unidos, con una beta opcional para enrutar el tráfico a través de servidores ubicados en Países Bajos o Singapur. A partir de ahora, el enrutamiento global es la opción predeterminada, lo que significa que el servidor se elegirá automáticamente según la proximidad geográfica para optimizar la latencia.

La URL base opcional `api-global-preview.elevenlabs.io` ha quedado obsoleta; utiliza en su lugar la URL base predeterminada `api.elevenlabs.io`. Si utilizas los SDK, ya es la opción predeterminada.

### Texto a Voz

- **Normalizador TTS v3.1**: Se ha actualizado el normalizador de texto a la versión 3.1, que incluye mayor precisión y menor latencia para la conversión de texto a voz.

### Plataforma de Agents

- **Medidas de seguridad personalizadas**: Se ha añadido compatibilidad con medidas de seguridad de salida definidas por usuarios que te permiten crear reglas personalizadas de filtrado de contenido más allá de la moderación estándar. Configura las medidas de seguridad con un nombre, una instrucción de prompt (hasta 10.000 caracteres) y el modelo de evaluación (`gemini-2.5-flash-lite` o `gemini-2.0-flash`). Cuando se activa, la medida de seguridad finaliza la conversación. Consulta la [referencia de la API Crear agente](/docs/es/api-reference/agents/create#request.body.conversation_config.safety.guardrails.custom) para ver los detalles de configuración.
- **Mensajería saliente de WhatsApp**: Se ha añadido la ruta [Enviar mensaje saliente](/docs/es/api-reference/whats-app/outbound-message) (`POST /v1/convai/whatsapp/outbound-message`) para iniciar conversaciones por WhatsApp mediante plantillas de mensajes. Los campos obligatorios incluyen `whatsapp_phone_number_id`, `whatsapp_user_id`, `template_name`, `template_language_code`, `template_params` y `agent_id`.
- **Modelo conversacional Eleven v3**: Se ha añadido `eleven_v3_conversational` a los modelos TTS disponibles para agentes, lo que proporciona mejor calidad de voz y expresividad en las conversaciones de agentes.
- **Etiquetas de audio sugeridas**: Se ha añadido el campo `suggested_audio_tags` a la configuración TTS para agentes que usan modelos v3. Define hasta 20 etiquetas (por ejemplo, "happy", "excited") para guiar la generación de voz expresiva, con descripciones opcionales que indican cuándo debe usarse cada etiqueta.
- **Gestión de errores de herramientas**: Se ha añadido el campo `tool_error_handling_mode` a las configuraciones de herramientas de webhook con las opciones: `auto` (predeterminado; determina la gestión según el tipo de herramienta), `summarized` (envía un resumen generado por LLM), `passthrough` (envía el error sin procesar) u `hide` (no comparte el error con el agente).
- **Saneamiento de variables dinámicas**: Se ha añadido el campo `sanitize` (booleano, valor predeterminado `false`) a `DynamicVariableAssignment`. Cuando está activado, el valor asignado se elimina de las respuestas de herramientas y las transcripciones, aunque sigue procesándose para la asignación de variables.
- **Selección de modelo de turnos**: Se ha añadido el enum `TurnModel` con las opciones `turn_v2` y `turn_v3` para seleccionar la versión del modelo de detección de turnos.
- **Transferencias de nodos de workflow**: Se ha añadido el campo `is_workflow_node_transfer` (booleano, valor predeterminado `false`) al esquema `AgentTransfer` para identificar transferencias dentro de nodos de workflow.
- **Metadatos de ramas de transferencia**: Se han añadido los esquemas `TransferBranchInfoTrafficSplit` y `TransferBranchInfoDefaultingToMain` para realizar el seguimiento de la información de enrutamiento de ramas en las transferencias de agentes.
- **Pruebas de transiciones de nodos de workflow**: Se ha añadido el tipo de aserción `workflow_node_transition` para pruebas unitarias con el esquema `UnitTestWorkflowNodeTransitionEvaluationNodeId` para validar transiciones de workflow de agentes.

### Studio de ElevenCreative

- **Ruta de pistas silenciadas**: Se ha añadido la ruta [Obtener pistas silenciadas del proyecto](/docs/es/api-reference/studio/get-muted-tracks) (`GET /v1/studio/projects/{project_id}/muted-tracks`), que devuelve una lista de ID de capítulos con pistas silenciadas en un proyecto.

### Espacios de trabajo

- **Tipo de puesto de miembro Lite**: Se ha añadido `workspace_lite_member` al enum `SeatType` para espacios de trabajo con permisos de acceso limitados.
- **Recurso de plantillas de contenido**: Se ha añadido `content_templates` al enum `WorkspaceResourceType` para compartir plantillas de contenido en espacios de trabajo.

### Interfaz de usuario

- **Desplazamiento en colecciones de voces**: Se ha corregido un problema que impedía el desplazamiento con la rueda del ratón y el táctil en el selector de iconos de colecciones de voces en macOS.

### Lanzamientos de SDK

#### SDK de Python

- [v2.35.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.35.0) - Se han añadido medidas de seguridad personalizadas, mensajería saliente de WhatsApp, modo de gestión de errores de herramientas, saneamiento de variables dinámicas, selección de modelo de turnos y compatibilidad con el modelo conversacional Eleven v3

#### SDK de JavaScript

- [v2.35.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.35.0) - Se han añadido medidas de seguridad personalizadas, mensajería saliente de WhatsApp, modo de gestión de errores de herramientas, saneamiento de variables dinámicas, selección de modelo de turnos y compatibilidad con el modelo conversacional Eleven v3

#### SDK de React y Client

- [@elevenlabs/react-native@0.5.10](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@0.5.10) - Se ha corregido el establecimiento de conversaciones solo de texto
- [@elevenlabs/react@0.14.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.0) - Se ha reducido la duración de los fragmentos de audio de 250 ms a 100 ms para reducir la latencia en las conversaciones de agentes
- [@elevenlabs/client@0.14.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.14.0) - Se ha reducido la duración de los fragmentos de audio de 250 ms a 100 ms para reducir la latencia y se ha normalizado la gestión de la opción `textOnly` entre el nivel superior y el objeto de anulaciones
- [@elevenlabs/types@0.5.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.5.0) - Se han añadido tipos para compatibilidad con datos de alineación de audio

### API

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

## Nuevas rutas

- [Enviar mensaje saliente por WhatsApp](/docs/es/api-reference/whats-app/outbound-message) - `POST /v1/convai/whatsapp/outbound-message` - Envía un mensaje saliente por WhatsApp mediante plantillas de mensajes
- [Obtener pistas silenciadas del proyecto](/docs/es/api-reference/studio/get-muted-tracks) - `GET /v1/studio/projects/{project_id}/muted-tracks` - Devuelve ID de capítulos con pistas silenciadas

## Rutas actualizadas

### Plataforma de Agents

- [Crear agente](/docs/es/api-reference/agents/create), [Actualizar agente](/docs/es/api-reference/agents/update), [Obtener agente](/docs/es/api-reference/agents/get)
  - Se ha añadido el campo `custom` al esquema `GuardrailsV1` para la configuración de medidas de seguridad personalizadas
  - Se ha añadido el campo `alignment` al esquema `GuardrailsV1` para las medidas de seguridad de alineación
  - Se ha añadido el campo `suggested_audio_tags` a la configuración conversacional de TTS (array de `SuggestedAudioTag`, máximo 20 elementos)
  - Se ha añadido `eleven_v3_conversational` al enum `TTSConversationalModel`
- [Crear herramienta](/docs/es/api-reference/tools/create), [Actualizar herramienta](/docs/es/api-reference/tools/update)
  - Se ha añadido el campo `tool_error_handling_mode` a `ApiIntegrationWebhookToolConfig` (enum: `auto`, `summarized`, `passthrough`, `hide`; valor predeterminado `auto`)
  - Se ha añadido el campo `sanitize` a `DynamicVariableAssignment` (booleano, valor predeterminado `false`)

### Espacios de trabajo

- [Obtener recurso](/docs/es/api-reference/workspace/resources/get)
  - Se ha añadido `content_templates` al enum `WorkspaceResourceType`
- [Añadir invitación al espacio de trabajo](/docs/es/api-reference/workspace/invites/create), [Añadir miembro al espacio de trabajo](/docs/es/api-reference/workspace/invites/create)
  - Se ha añadido `workspace_lite_member` al enum `SeatType`

## Cambios en esquemas

### Nuevos esquemas

- `CustomGuardrail-Input`, `CustomGuardrail-Output` - Contenedor para la configuración de medidas de seguridad personalizadas
- `CustomGuardrailsConfig` - Contenedor de configuración para la lista de medidas de seguridad personalizadas
- `CustomGuardrailConfig` - Medida de seguridad personalizada individual con `name` (cadena, obligatorio), `prompt` (cadena, obligatorio, máximo 10.000 caracteres), `model` (enum: `gemini-2.5-flash-lite`, `gemini-2.0-flash`, obligatorio) e `is_enabled` (booleano, valor predeterminado `false`)
- `ToolErrorHandlingMode` - Enum para la gestión de errores de herramientas: `auto`, `summarized`, `passthrough`, `hide`
- `TurnModel` - Enum para la versión del modelo de detección de turnos: `turn_v2`, `turn_v3`
- `SuggestedAudioTag` - Configuración de etiqueta de audio con `tag` (cadena, obligatorio, máximo 30 caracteres) y `description` (cadena, opcional, máximo 200 caracteres)
- `TransferBranchInfoTrafficSplit` - Información de rama para transferencias con división de tráfico, con `branch_id` y `traffic_percentage`
- `TransferBranchInfoDefaultingToMain` - Información de rama para transferencias predeterminadas a la principal, con `branch_id`
- `UnitTestWorkflowNodeTransitionEvaluationNodeId` - Configuración de prueba de transición de nodos de workflow con `agent_id` y `target_node_id`
- `ProjectMutedTracksResponseModel` - Modelo de respuesta con el array `chapter_ids`
- `WhatsAppOutboundMessageResponse` - Respuesta para la ruta de mensajes salientes de WhatsApp
- `WhatsAppTemplateHeaderComponentParams`, `WhatsAppTemplateBodyComponentParams`, `WhatsAppTemplateButtonComponentParams` - Esquemas de parámetros de plantilla para mensajes de WhatsApp
- `ConversationHistoryTranscriptSystemToolResultCommonModel-Input`, `ConversationHistoryTranscriptSystemToolResultCommonModel-Output` - Modelos de resultado de herramienta de sistema divididos para variantes de entrada y salida

### Esquemas modificados

- `GuardrailsV1-Input`, `GuardrailsV1-Output` - Se han añadido los campos `custom` (CustomGuardrail) y `alignment` (AlignmentGuardrail)
- `TTSConversationalConfig-Input`, `TTSConversationalConfig-Output` - Se ha añadido el campo `suggested_audio_tags`
- `TTSConversationalModel` - Se ha añadido el valor de enum `eleven_v3_conversational`
- `ApiIntegrationWebhookToolConfig-Input`, `ApiIntegrationWebhookToolConfig-Output` - Se ha añadido el campo `tool_error_handling_mode` (obligatorio)
- `DynamicVariableAssignment` - Se ha añadido el campo `sanitize` (booleano, valor predeterminado `false`)
- `AgentTransfer` - Se ha añadido el campo `is_workflow_node_transfer` (booleano, valor predeterminado `false`)
- `SeatType` - Se ha añadido el valor de enum `workspace_lite_member`
- `WorkspaceResourceType` - Se ha añadido el valor de enum `content_templates`

### Esquemas eliminados

- `AgentBan` - Se ha eliminado el esquema sin usar
- `BanReasonType` - Se ha eliminado el enum sin usar
- `DubbingReleaseChannel` - Se ha eliminado el enum sin usar

</Accordion>