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

# Wykrywanie poczty głosowej

## Omówienie

Narzędzie **Wykrywanie poczty głosowej** pozwala agentowi ElevenLabs automatycznie rozpoznać, że połączenie odebrał system poczty głosowej, a nie człowiek. To narzędzie systemowe pozwala agentom płynnie obsługiwać automatyczną pocztę głosową, zostawiając wcześniej skonfigurowaną wiadomość lub od razu kończąc połączenie.

## Funkcje

* **Automatyczne wykrywanie**: LLM analizuje wzorce rozmowy, aby rozpoznać systemy poczty głosowej na podstawie automatycznych powitań i komunikatów
* **Konfigurowalna reakcja**: Wybierz, czy po wykryciu poczty głosowej zostawić własną wiadomość, czy od razu zakończyć połączenie
* **Zakończenie połączenia**: Po wykryciu i opcjonalnym przekazaniu wiadomości połączenie jest automatycznie kończone
* **Śledzenie statusu**: Zdarzenia wykrycia poczty głosowej są rejestrowane i widoczne w historii rozmów oraz wynikach połączeń wsadowych

**Parametry**:

* `reason` (string, wymagany): Powód wykrycia poczty głosowej (np. „wykryto automatyczne powitanie”, „brak odpowiedzi człowieka”)

**Format wywołania funkcji**:

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

## Opcje konfiguracji

Narzędzie wykrywania poczty głosowej można skonfigurować za pomocą poniższych opcji:

![Interfejs konfiguracji wykrywania
poczty głosowej](/docs/_fern-img/f2f9a87e27ce0d5f631d2d294163e8df39e6dee5b3a98aaba692589c66364550.webp)

* **Wiadomość poczty głosowej**: Możesz skonfigurować opcjonalną własną wiadomość odtwarzaną po wykryciu poczty głosowej. Ta wiadomość obsługuje [zmienne dynamiczne](/docs/pl/eleven-agents/customization/personalization/dynamic-variables), dzięki czemu możesz personalizować wiadomości poczty głosowej wartościami środowiska uruchomieniowego, takimi jak `{{user_name}}` lub `{{appointment_time}}`

## Implementacja API

Podczas tworzenia agenta przez API możesz dodać narzędzie Wykrywanie poczty głosowej do konfiguracji agenta. Powinno być zdefiniowane jako narzędzie systemowe:

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