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

# Mailboxerkennung

## Überblick

Mit dem Tool **Mailboxerkennung** kann Ihr ElevenLabs-Agent automatisch erkennen, ob ein Anruf von einem Mailboxsystem statt von einer Person angenommen wurde. Dieses Systemtool ermöglicht es Agents, automatisierte Mailbox-Szenarien zuverlässig zu verarbeiten, indem sie entweder eine vorkonfigurierte Nachricht hinterlassen oder den Anruf sofort beenden.

## Funktionen

* **Automatische Erkennung**: Das LLM analysiert Gesprächsmuster, um Mailboxsysteme anhand automatisierter Begrüßungen und Aufforderungen zu erkennen
* **Konfigurierbare Reaktion**: Wählen Sie aus, ob bei erkannter Mailbox eine benutzerdefinierte Mailboxnachricht hinterlassen oder der Anruf sofort beendet werden soll
* **Anrufbeendigung**: Nach der Erkennung und optionalen Nachrichtenübermittlung wird der Anruf automatisch beendet
* **Statusverfolgung**: Ereignisse zur Mailboxerkennung werden protokolliert und können im Gesprächsverlauf sowie in den Ergebnissen von Batch-Anrufen angezeigt werden

**Parameter**:

* `reason` (string, erforderlich): Der Grund für die Erkennung einer Mailbox (z. B. „automatische Begrüßung erkannt“, „keine menschliche Antwort“)

**Format des Funktionsaufrufs**:

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

## Konfigurationsoptionen

Das Tool zur Mailboxerkennung kann mit den folgenden Optionen konfiguriert werden:

![Konfigurationsoberfläche für die
Mailboxerkennung](/docs/_fern-img/f2f9a87e27ce0d5f631d2d294163e8df39e6dee5b3a98aaba692589c66364550.webp)

* **Mailboxnachricht**: Sie können eine optionale benutzerdefinierte Nachricht konfigurieren, die bei erkannter Mailbox abgespielt wird. Diese Nachricht unterstützt [dynamische Variablen](/docs/de/eleven-agents/customization/personalization/dynamic-variables), sodass Sie Mailboxnachrichten mit Laufzeitwerten wie `{{user_name}}` oder `{{appointment_time}}` personalisieren können

## API-Implementierung

Wenn Sie einen Agent über die API erstellen, können Sie das Tool Mailboxerkennung zu Ihrer Agent-Konfiguration hinzufügen. Es sollte als Systemtool definiert werden:

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