Detecção de correio de voz

Visão geral

A ferramenta Detecção de correio de voz permite que seu agente da ElevenLabs identifique automaticamente quando uma chamada foi atendida por um sistema de correio de voz, em vez de uma pessoa. Essa ferramenta do sistema permite que os agentes lidem com cenários de correio de voz automatizado de forma adequada, deixando uma mensagem pré-configurada ou encerrando a chamada imediatamente.

Funcionalidades

• Detecção automática: O LLM analisa os padrões da conversa para identificar sistemas de correio de voz com base em saudações e instruções automatizadas
• Resposta configurável: Escolha deixar uma mensagem personalizada no correio de voz ou encerrar a chamada imediatamente quando o correio de voz for detectado
• Encerramento da chamada: Após a detecção e a entrega opcional da mensagem, a chamada é encerrada automaticamente
• Acompanhamento de status: Os eventos de detecção de correio de voz são registrados e podem ser visualizados no histórico da conversa e nos resultados de chamadas em lote

Parâmetros:

• reason (string, obrigatório): o motivo para detectar a caixa postal (por exemplo, “saudação automática detectada”, “nenhuma resposta humana”)

Formato de chamada da função:

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

Opções de configuração

A ferramenta de detecção de correio de voz pode ser configurada com as seguintes opções:

• Mensagem de correio de voz: Você pode configurar uma mensagem personalizada opcional para ser reproduzida quando o correio de voz for detectado. Essa mensagem é compatível com variáveis dinâmicas, permitindo personalizar mensagens de correio de voz com valores em tempo de execução, como {{user_name}} ou {{appointment_time}}

Implementação da API

Ao criar um agente pela API, você pode adicionar a ferramenta de Detecção de correio de voz à configuração do agente. Ela deve ser definida como uma ferramenta do 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.",
                        },
                    }
                }
            },
        ),
    ),
)