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:

{
  "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:

• 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, 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:

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.",
                        },
                    }
                }
            },
        ),
    ),
)