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

# Detección de buzón de voz

## Resumen

La herramienta **Detección de buzón de voz** permite a tu agente de ElevenLabs identificar automáticamente cuándo una llamada ha sido respondida por un sistema de buzón de voz en lugar de por una persona. Esta herramienta del sistema permite a los agentes gestionar con fluidez situaciones de buzón de voz automatizado, ya sea dejando un mensaje preconfigurado o finalizando la llamada de inmediato.

## Funcionalidad

* **Detección automática**: El LLM analiza los patrones de conversación para identificar sistemas de buzón de voz a partir de saludos y mensajes automatizados
* **Respuesta configurable**: Elige entre dejar un mensaje personalizado en el buzón de voz o finalizar la llamada de inmediato cuando se detecte un buzón de voz
* **Finalización de llamadas**: Tras la detección y la entrega opcional del mensaje, la llamada finaliza automáticamente
* **Seguimiento del estado**: Los eventos de detección de buzón de voz se registran y pueden consultarse en el historial de conversaciones y en los resultados de llamadas por lotes

**Parámetros**:

* `reason` (cadena, obligatorio): El motivo para detectar el buzón de voz (por ejemplo, «se ha detectado un saludo automatizado», «no hay respuesta humana»)

**Formato de llamada de función**:

```json
{
  "type": "function",
  "function": {
    "name": "voicemail_detection",
    "arguments": "{\"reason\": \"Automated greeting detected with request to leave message\"}"
  }
}
```

## Opciones de configuración

La herramienta de detección de buzón de voz se puede configurar con las siguientes opciones:

![Interfaz de configuración de la detección de buzón de voz](/docs/_fern-img/f2f9a87e27ce0d5f631d2d294163e8df39e6dee5b3a98aaba692589c66364550.webp)

* **Mensaje de buzón de voz**: Puedes configurar un mensaje personalizado opcional para que se reproduzca cuando se detecte un buzón de voz. Este mensaje admite [variables dinámicas](/docs/es/eleven-agents/customization/personalization/dynamic-variables), lo que te permite personalizar los mensajes del buzón de voz con valores de tiempo de ejecución, como `{{user_name}}` o `{{appointment_time}}`

## Implementación de la API

Al crear un agente mediante la API, puedes añadir la herramienta Detección de buzón de voz a la configuración de tu agente. Debe definirse como una herramienta del sistema:

```python
from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs

elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")

response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            prompt={
                "built_in_tools": {
                    "voicemail_detection": {
                        "type": "system",
                        "name": "voicemail_detection",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {
                            "system_tool_type": "voicemail_detection",
                            # Optional: message left when voicemail is detected
                            "voicemail_message": "Sorry I missed you. I'll call back later.",
                        },
                    }
                }
            },
        ),
    ),
)
```

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

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      prompt: {
        builtInTools: {
          voicemailDetection: {
            type: "system",
            name: "voicemail_detection",
            description: "", // Optional: Customize when the tool should be triggered
            params: {
              systemToolType: "voicemail_detection",
              // Optional: message left when voicemail is detected
              voicemailMessage: "Sorry I missed you. I'll call back later.",
            },
          },
        },
      },
    },
  },
});
```