> 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.

# Entorno de audio

## Resumen

El entorno de audio controla cómo suena para quien llama el audio saliente del agente. Se aplican dos ajustes:

* **Sonido de fondo** reproduce un sonido ambiental en bucle bajo la voz del agente.
* **Filtro de voz** aplica un filtro de estilo telefónico a la voz del agente antes de esa mezcla.

Quien llama escucha el resultado. El agente no escucha el sonido de fondo y este no se envía al reconocimiento de voz.

Esto es independiente de los [sonidos de llamadas a herramientas](/docs/es/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), que solo se reproducen mientras se ejecuta una herramienta.

## Sonido de fondo

El sonido de fondo mezcla un preajuste integrado bajo la voz del agente durante toda la conversación. El sonido sigue repitiéndose cuando el usuario interrumpe; no se detiene al terminar el turno del agente.

Los preajustes incluyen oficina, restaurante, ciudad, escritura y música de ascensor. En el panel, puedes previsualizar un preajuste antes de guardarlo.

Configura el sonido de fondo con `conversation_config.conversation.background_sound`.

### Configuración

#### Actualizar desde el panel

#### Abre Entorno de audio

Abre tu agente. En la página del agente, junto a **Voces**, haz clic en el botón
**Entorno de audio**.

#### Activa el sonido de fondo

Activa **Activar sonido de fondo**. Elige un preajuste en **Sonido de fondo**. Usa el control
de reproducción junto al menú desplegable para previsualizarlo.

#### Ajusta el volumen y el bucle

Ajusta el **Volumen**. Mantén activado **Bucle con fundido cruzado** para evitar un clic audible cuando el sonido
se repita. Guarda los cambios.

#### Actualizar mediante la CLI

#### Obtén la configuración del agente

```bash
elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### Edita \`agent_configs/\<agent-name>.json\`

Configura `conversation_config.conversation.background_sound`. Los valores válidos de `source_id` son
`office1`, `office2`, `restaurant`, `city`, `typing` y del `elevator1` al `elevator4`.

```json
{
  "conversation_config": {
    "conversation": {
      "background_sound": {
        "source_type": "preset",
        "source_id": "office2",
        "volume": 0.15,
        "crossfade_loop": true
      }
    }
  }
}
```

Para desactivar el sonido de fondo, configura `source_type` y `source_id` como `null`. No omitas
`background_sound` ni establezcas el objeto como `null`; una actualización conservará el ajuste existente.

#### Envía la configuración del agente

```bash
elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### Actualizar mediante la API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "conversation": {
            "background_sound": {
                "source_type": "preset",
                "source_id": "office2",
                "volume": 0.15,
                "crossfade_loop": True,
            }
        }
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    conversation: {
      backgroundSound: {
        sourceType: "preset",
        sourceId: "office2",
        volume: 0.15,
        crossfadeLoop: true,
      },
    },
  },
});
```

Para desactivarlo, configura `source_type` y `source_id` como `null`. Omitir `background_sound` al
actualizar no lo desactiva.

> **Warning**
>
> En conexiones WebSocket de muy baja calidad, mezclar sonido de fondo puede producir audio entrecortado.

### Parámetros

Los valores válidos de `source_id` son `office1`, `office2`, `restaurant`, `city`, `typing` y del `elevator1` al `elevator4`.

| Campo            | Tipo    | Predeterminado | Descripción                                                                                |
| ---------------- | ------- | -------------- | ------------------------------------------------------------------------------------------ |
| `source_type`    | string  | sin configurar | Debe ser `preset` cuando hay un sonido activado. Configúralo junto con `source_id`.        |
| `source_id`      | string  | sin configurar | Identificador de un preajuste integrado.                                                   |
| `volume`         | number  | `0.15`         | Nivel relativo a la voz del agente. Intervalo: `0.01`–`1.0`.                               |
| `crossfade_loop` | boolean | `true`         | Aplica un fundido cruzado al final del bucle para que el sonido no haga clic al repetirse. |

## Filtro de voz

El filtro de voz modifica la voz generada del agente. No ecualiza ni elimina el ruido del sonido de fondo. El filtro se aplica primero; el sonido de fondo se mezcla bajo la voz filtrada.

Configura el filtro de voz con `conversation_config.tts.audio_effects.filter_preset_id`. El panel ofrece los preajustes de teléfono; mediante la CLI o la API puedes configurar cualquier preajuste de filtro incluido en el [catálogo de efectos de audio](/docs/es/api-reference/audio-effects/get-catalog).

#### Actualizar desde el panel

En el mismo panel de **Entorno de audio**, configura **Filtro de voz** como **Desactivado** o como un preajuste de teléfono y, a continuación,
guarda los cambios.

#### Actualizar mediante la CLI

En `agent_configs/<agent-name>.json`, configura `conversation_config.tts.audio_effects` y, a continuación, envía la
configuración del agente:

```json
{
  "conversation_config": {
    "tts": {
      "audio_effects": {
        "filter_preset_id": "phone"
      }
    }
  }
}
```

Para quitar el filtro, configura `filter_preset_id` como `null`.

#### Actualizar mediante la API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "tts": {
            "audio_effects": {
                "filter_preset_id": "phone",
            }
        }
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    tts: {
      audioEffects: {
        filterPresetId: "phone",
      },
    },
  },
});
```

Para quitar el filtro, configura `filter_preset_id` como `null`.

> **Note**
>
> El audio del agente es mono. `pan` no tiene efecto en los agentes y la reverberación de un `environment_id` se mezcla
> en mono.

## Limitaciones

* Solo hay preajustes integrados. No puedes subir un archivo personalizado ni indicar una URL arbitraria.
* Los controles del entorno de audio están ocultos cuando el agente es **solo texto**.
* El sonido de fondo no se mezcla en las respuestas de mensajes de voz de [WhatsApp](/docs/es/eleven-agents/whatsapp). Las llamadas de WhatsApp sí lo incluyen.
* El sonido de fondo no se puede configurar por conversación mediante las [anulaciones](/docs/es/eleven-agents/customization/personalization/overrides) del cliente; `conversation_config_override` no incluye `background_sound`. Aun así, puedes cambiarlo en un nodo de [workflow](/docs/es/eleven-agents/customization/agent-workflows).

## Relacionado

#### [Sonidos de llamadas a herramientas](/docs/es/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)

Reproduce audio ambiental solo mientras se ejecuta una herramienta.

#### [Personalización de voz](/docs/es/eleven-agents/customization/voice)

Elige una voz, la velocidad y otros ajustes de voz para el agente.