> ## Documentation Index
> Fetch the complete documentation index at: https://aipro.placetel.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Anruf Einstellungen

> Konfiguration von automatischen Timeouts und Anrufbeendigungen für Voice-Agenten.

## Was sind Call Settings?

**Call Settings (Anruf Einstellungen)** ermöglichen die Konfiguration von automatischen Timeouts und Anrufbeendigungen für Voice-Agenten. Diese Einstellungen helfen dabei, Ressourcen zu optimieren, ungenutzte Anrufe zu beenden und ein besseres Benutzererlebnis zu schaffen.

Die Call Settings finden Sie im Voice Wizard unter Grundeinstellungen.

## Parameter im Detail

### Inaktivitäts-Timeout

**Was macht dieser Parameter?**

Definiert die Anzahl der Sekunden, die der Voice Agent wartet, bevor er nachfragt, ob der Benutzer noch da ist. Wenn der Benutzer innerhalb dieser Zeit nichts sagt, wird eine Nachfrage ausgelöst.

**Verhalten:**

* Voice Agent wartet die eingestellte Zeit auf eine Antwort des Benutzers
* Nach Ablauf der Zeit fragt der Voice Agent: *"Sind Sie noch da? Bitte lassen Sie mich wissen, wenn Sie etwas brauchen."*
* Danach startet automatisch der "Timeout nach Warnung"

**Wert `-1`:** Feature ist deaktiviert - Voice Agent fragt nie nach, ob der Benutzer noch da ist

### Timeout nach Warnung

**Was macht dieser Parameter?**

Definiert die Anzahl der Sekunden, die der Voice Agent nach der Inaktivitätswarnung auf eine Antwort wartet, bevor der Anruf beendet wird.

**Verhalten:**

* Startet NUR nach der Inaktivitätswarnung
* Voice Agent wartet die eingestellte Zeit auf eine Reaktion
* Reagiert der Benutzer nicht, sagt der Voice Agent: *"Ich habe nichts mehr von Ihnen gehört. Auf Wiederhören."* und beendet den Anruf
* Reagiert der Benutzer, wird das Gespräch normal fortgesetzt

**Wert `-1`:** Voice Agent wartet unbegrenzt auf eine Antwort nach der Warnung (nicht empfohlen)

<Warning>
  **Wichtig:** Dieser Parameter wird **ignoriert**, wenn "Inaktivitäts-Timeout" auf `-1` gesetzt ist, da ohne Inaktivitätserkennung keine Warnung ausgelöst wird!
</Warning>

### Maximale Anrufdauer

**Was macht dieser Parameter?**

Definiert die maximale Gesamtdauer eines Anrufs in Sekunden. Unabhängig vom Gesprächsverlauf wird der Anruf nach dieser Zeit automatisch beendet.

**Verhalten:**

* Timer startet beim Anrufbeginn
* Läuft parallel und unabhängig zu den anderen Timeouts
* Nach Ablauf der Zeit sagt der Voice Agent: *"Unsere Zeit ist abgelaufen. Vielen Dank für Ihren Anruf. Auf Wiederhören."* und beendet den Anruf
* Wirkt wie eine "harte Grenze" für die Anrufdauer

**Wert `-1`:** Keine Zeitbegrenzung - Anruf kann theoretisch unbegrenzt lange dauern

<Info>
  **Hinweis:** Die Abschiedsnachrichten werden automatisch in der konfigurierten Sprache des Voice Agents generiert und können nicht angepasst werden.
</Info>

## Wichtige Hinweise

### Sprachunterstützung

Die automatischen Nachrichten werden in der konfigurierten Sprache des Voice Agents ausgegeben. Bei multilingualen Voice Agents wird die Sprache aus der Konversation automatisch erkannt.

## Empfohlene Werte

Die folgende Tabelle zeigt empfohlene Werte:

| Parameter                | Minimum     | Optimum            | Bei -1              |
| ------------------------ | ----------- | ------------------ | ------------------- |
| **Inaktivitäts-Timeout** | 10 Sekunden | **30 Sekunden**    | Deaktiviert         |
| **Timeout nach Warnung** | 5 Sekunden  | **10-15 Sekunden** | Wartet unbegrenzt\* |
| **Maximale Anrufdauer**  | 60 Sekunden | **Je nach Bedarf** | Kein Limit          |

*\* Ignoriert, wenn Inaktivitäts-Timeout deaktiviert ist*

### Warum diese Werte?

**Inaktivitäts-Timeout (Empfohlen: 30 Sekunden):**

* **Minimum 10 Sekunden:** Technische Untergrenze, um fehlerhafte Erkennungen zu vermeiden
* **Optimum 30 Sekunden:** Gibt dem Benutzer ausreichend Zeit zum Nachdenken oder Suchen von Informationen, ohne dass der Anruf zu früh als inaktiv markiert wird. Balance zwischen Benutzerfreundlichkeit und Ressourcenoptimierung.

**Timeout nach Warnung (Empfohlen: 10-15 Sekunden):**

* **Minimum 5 Sekunden:** Mindestzeit für eine Reaktion nach der Warnung
* **Optimum 10-15 Sekunden:** Angemessene Zeit für den Benutzer, um zu reagieren, ohne unnötig lange zu warten. Genug Zeit für "Ja, ich bin noch da", aber nicht zu lange bei tatsächlich inaktiven Anrufen.

**Maximale Anrufdauer (Je nach Bedarf):**

* **Minimum 60 Sekunden:** Technische Untergrenze für sinnvolle Gespräche
* **Individuelle Wahl:** Hängt stark vom Anwendungsfall ab - kurze Info-Hotline (3 Min), Kundenservice (10 Min) oder keine Begrenzung (-1). Wählen Sie basierend auf Ihren spezifischen Anforderungen.

### Szenarien und empfohlene Konfigurationen

<Accordion title="Szenario 1: Kundenservice Hotline (Standard)">
  * **Inaktivitäts-Timeout:** 45 Sekunden - Gibt dem Kunden Zeit zum Nachdenken
  * **Timeout nach Warnung:** 15 Sekunden - Angemessene Zeit für eine Reaktion
  * **Maximale Anrufdauer:** 600 Sekunden (10 Min) - Begrenzt sehr lange Gespräche
</Accordion>

<Accordion title="Szenario 2: Schnelle Info-Hotline">
  * **Inaktivitäts-Timeout:** 30 Sekunden - Schnellere Reaktion
  * **Timeout nach Warnung:** 10 Sekunden - Kurze Wartezeit
  * **Maximale Anrufdauer:** 180 Sekunden (3 Min) - Für kurze, informative Anrufe
</Accordion>

<Accordion title="Szenario 3: Testing/Entwicklung">
  * **Inaktivitäts-Timeout:** `-1` - Deaktiviert für Tests
  * **Timeout nach Warnung:** `-1` - Deaktiviert
  * **Maximale Anrufdauer:** `-1` - Keine Begrenzung beim Testen
</Accordion>

<Accordion title="Szenario 4: Automatisierte Terminvereinbarung">
  * **Inaktivitäts-Timeout:** 60 Sekunden - Zeit für Kalenderprüfung
  * **Timeout nach Warnung:** 15 Sekunden - Höfliche Nachfrage
  * **Maximale Anrufdauer:** 300 Sekunden (5 Min) - Ausreichend für Terminbuchung
</Accordion>

## Anwendungsbeispiele

<Accordion title="Beispiel 1: Inaktivitätserkennung in Aktion">
  **Konfiguration:**

  * Inaktivitäts-Timeout: 30 Sekunden
  * Timeout nach Warnung: 10 Sekunden

  **Ablauf:**

  `00:00` - Anruf beginnt, Voice Agent begrüßt den Anrufer

  `00:15` - Kunde stellt eine Frage

  `00:16` - Voice Agent antwortet

  `00:46` - 30 Sekunden Stille - Voice Agent: *"Sind Sie noch da? Bitte lassen Sie mich wissen, wenn Sie etwas brauchen."*

  `00:56` - Weitere 10 Sekunden keine Reaktion - Voice Agent: *"Ich habe nichts mehr von Ihnen gehört. Auf Wiederhören."* - Anruf beendet
</Accordion>

<Accordion title="Beispiel 2: Kunde reagiert nach Warnung">
  **Konfiguration:**

  * Inaktivitäts-Timeout: 30 Sekunden
  * Timeout nach Warnung: 10 Sekunden

  **Ablauf:**

  `00:00` - Anruf beginnt

  `00:30` - Voice Agent: *"Sind Sie noch da?"*

  `00:35` - Kunde: *"Ja, ich bin noch da!"*

  Timer wird zurückgesetzt, Gespräch geht weiter

  `01:05` - Erneut 30 Sekunden Stille - Voice Agent fragt wieder nach
</Accordion>

<Accordion title="Beispiel 3: Maximale Anrufdauer erreicht">
  **Konfiguration:**

  * Maximale Anrufdauer: 300 Sekunden (5 Minuten)

  **Ablauf:**

  `00:00` - Anruf beginnt

  `04:30` - Gespräch läuft aktiv

  `05:00` - 5 Minuten erreicht - Voice Agent: *"Unsere Zeit ist abgelaufen. Vielen Dank für Ihren Anruf. Auf Wiederhören."* - Anruf beendet

  **Wichtig:** Dies passiert unabhängig davon, ob gerade gesprochen wird oder nicht!
</Accordion>

<Accordion title="Beispiel 4: Alle Features kombiniert">
  **Konfiguration:**

  * Inaktivitäts-Timeout: 45 Sekunden
  * Timeout nach Warnung: 15 Sekunden
  * Maximale Anrufdauer: 600 Sekunden (10 Minuten)

  **Szenario A - Inaktivität:**
  Nach 45 Sekunden Stille fragt Voice Agent nach. Nach weiteren 15 Sekunden ohne Antwort wird Anruf beendet.

  **Szenario B - Zeitlimit:**
  Nach 10 Minuten wird Anruf automatisch beendet, auch wenn aktiv gesprochen wird.

  **Szenario C - Normales Gespräch:**
  Solange alle 45 Sekunden eine Interaktion stattfindet und 10 Minuten nicht überschritten werden, läuft der Anruf normal weiter.
</Accordion>

## Zusammenfassung

Call Settings bieten flexible Möglichkeiten zur Steuerung der Anrufdauer und Handhabung von Inaktivität:

* Optimierung von Ressourcen durch automatische Beendigung ungenutzter Anrufe
* Verbessertes Benutzererlebnis durch höfliche Nachfragen bei Stille
* Kontrolle über maximale Gesprächsdauer zur Kostenoptimierung
* Flexible Konfiguration je nach Anwendungsfall
* Automatische Sprachanpassung der Nachrichten

Verwenden Sie `-1` um einzelne Features zu deaktivieren und passen Sie die Werte an Ihren spezifischen Anwendungsfall an.
