Détection de messagerie vocale

Vue d’ensemble

L’outil Détection de messagerie vocale permet à votre agent ElevenLabs d’identifier automatiquement lorsqu’un appel a été pris par un système de messagerie vocale plutôt que par une personne. Cet outil système permet aux agents de gérer les scénarios de messagerie vocale automatisée en laissant un message préconfiguré ou en mettant immédiatement fin à l’appel.

Fonctionnalités

• Détection automatique : le LLM analyse les schémas de conversation afin d’identifier les systèmes de messagerie vocale à partir des messages d’accueil et invites automatisés
• Réponse configurable : choisissez de laisser un message vocal personnalisé ou de mettre immédiatement fin à l’appel lorsqu’une messagerie vocale est détectée
• Fin d’appel : après la détection et l’éventuelle diffusion d’un message, l’appel se termine automatiquement
• Suivi des statuts : les événements de détection de messagerie vocale sont consignés et peuvent être consultés dans l’historique des conversations et les résultats des appels par lot

Paramètres :

• reason (chaîne, obligatoire) : raison de la détection de messagerie vocale (par exemple, « message d’accueil automatisé détecté », « aucune réponse humaine »)

Format d’appel de fonction :

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

Options de configuration

L’outil de détection de messagerie vocale peut être configuré avec les options suivantes :

• Message vocal : vous pouvez configurer un message personnalisé facultatif à diffuser lorsqu’une messagerie vocale est détectée. Ce message prend en charge les variables dynamiques, ce qui vous permet de personnaliser les messages vocaux avec des valeurs d’exécution telles que {{user_name}} ou {{appointment_time}}

Implémentation via l’API

Lors de la création d’un agent via l’API, vous pouvez ajouter l’outil Détection de messagerie vocale à la configuration de votre agent. Il doit être défini comme outil système :

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