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

# Voicemaildetectie

## Overzicht

Met de tool **Voicemaildetectie** kan je ElevenLabs-agent automatisch herkennen wanneer een gesprek is beantwoord door een voicemailsysteem in plaats van een persoon. Met deze systeemtool kunnen agents geautomatiseerde voicemailsituaties goed afhandelen door een vooraf geconfigureerd bericht achter te laten of het gesprek onmiddellijk te beëindigen.

## Functionaliteit

* **Automatische detectie**: De LLM analyseert gesprekspatronen om voicemailsystemen te herkennen op basis van geautomatiseerde begroetingen en prompts
* **Configureerbare reactie**: Kies of je een aangepast voicemailbericht wilt achterlaten of het gesprek onmiddellijk wilt beëindigen wanneer voicemail wordt gedetecteerd
* **Gespreksbeëindiging**: Na detectie en eventuele berichtaflevering wordt het gesprek automatisch beëindigd
* **Statusregistratie**: Gebeurtenissen voor voicemaildetectie worden gelogd en kunnen worden bekeken in de gespreksgeschiedenis en resultaten van batchgesprekken

**Parameters**:

* `reason` (string, verplicht): De reden voor het detecteren van voicemail (bijvoorbeeld "geautomatiseerde begroeting gedetecteerd", "geen menselijke reactie")

**Indeling van functieaanroep**:

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

## Configuratieopties

De tool voor voicemaildetectie kan met de volgende opties worden geconfigureerd:

![Configuratie-
interface voor voicemaildetectie](/docs/_fern-img/f2f9a87e27ce0d5f631d2d294163e8df39e6dee5b3a98aaba692589c66364550.webp)

* **Voicemailbericht**: Je kunt een optioneel aangepast bericht configureren dat wordt afgespeeld wanneer voicemail wordt gedetecteerd. Dit bericht ondersteunt [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables), zodat je voicemailberichten kunt personaliseren met runtimewaarden zoals `{{user_name}}` of `{{appointment_time}}`

## API-implementatie

Wanneer je via de API een agent maakt, kun je de tool Voicemaildetectie aan de configuratie van je agent toevoegen. Deze moet worden gedefinieerd als systeemtool:

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