> 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. # Benachrichtigungen ## Überblick Benachrichtigungen informieren Sie, wenn etwas mit den Agenten in Ihrem Workspace nicht stimmt. ElevenLabs überwacht Gesprächsaktivitäten kontinuierlich und löst eine Benachrichtigung aus, wenn eine Fehlerrate einen konfigurierten Schwellenwert überschreitet oder stark über ihre jüngste Baseline steigt. Benachrichtigungen funktionieren ohne Einrichtung: Überwachungen laufen automatisch mit Standardschwellenwerten. Bei Bedarf können Sie Schwellenwerte anpassen oder Benachrichtigungen hinzufügen. Benachrichtigungen werden im ElevenLabs-Dashboard angezeigt und verwaltet, wo die Einstellungen auf Workspace- und Agentenebene konfiguriert werden. Einstellungen auf Agentenebene können auch programmgesteuert über das Feld `platform_settings.alerting` festgelegt werden, wenn Sie einen Agenten über die API, SDKs oder Konfigurationsdateien der [Agents CLI](/docs/de/eleven-agents/operate/cli) erstellen oder mit der API [Agent aktualisieren](/docs/de/api-reference/agents/update) aktualisieren. Einstellungen auf Workspace-Ebene und der Benachrichtigungsverlauf sind nur im Dashboard verfügbar. Die folgenden Überwachungen werden für jeden Agenten ausgewertet: | Benachrichtigungstyp | Auslöser | | --------------------------- | --------------------------------------------------------------------------- | | Gesprächsfehler | Fehler überschreiten einen Prozentsatz der Gespräche | | Tool-Fehler | Fehler überschreiten einen Prozentsatz der Tool-Aufrufe, pro Tool erfasst | | Webhook-Fehler | Fehler überschreiten einen Prozentsatz der Webhook-Aufrufe | | Guardrail-Auslösung | Guardrail-Auslösungen überschreiten einen Prozentsatz der Gespräche | | Fehler bei Anrufinitiierung | Fehler überschreiten einen Prozentsatz der Anrufinitiierungen | | Bewertungserfolgswert | Der durchschnittliche Bewertungserfolgswert fällt unter einen Schwellenwert | Jede Benachrichtigung hat einen der folgenden Status: * **Aktiv**: Die Bedingung wird derzeit ausgelöst. * **Aufgelöst**: Die Bedingung wird nicht mehr ausgelöst und die Benachrichtigung wurde nach einer Phase der Inaktivität automatisch aufgelöst. * **Verworfen**: Ein Nutzer hat die Benachrichtigung manuell verworfen. ## Benachrichtigungen anzeigen Navigieren Sie zu [**Developers** > **Alerts**](https://elevenlabs.io/app/developers/alerts), um aktuelle Überwachungsbenachrichtigungen für Agenten in Ihrem Workspace anzuzeigen. Die Seite zeigt eine Zeitleiste der Benachrichtigungsaktivität und eine Tabelle mit Zeitstempel, Dauer, Status, Typ und Agent jeder Benachrichtigung. Sie können nach Status, Agent oder Tool filtern und den Zeitraum anpassen (bis zu 90 Tage). ![Benachrichtigungsseite im Dashboard](/docs/_fern-img/d2dbe97d07149ab05ea88cff5300146de39682532a84d1a37326b01dbc04ba9f.webp) Klicken Sie auf eine Benachrichtigung, um die betroffenen Gespräche zu öffnen, oder verwenden Sie das Zeilenmenü, um **Gespräche untersuchen** im Gesprächsverlauf auszuwählen. Aktive Benachrichtigungen können im selben Menü verworfen werden. Aktive Benachrichtigungen erscheinen auch als Karten mit hoher Priorität in [**Spotlight**](/docs/de/eleven-agents/dashboard/spotlight), dem Übersichts-Dashboard auf der Seite jedes Agenten. Zudem verweist ein Banner im Agents-Dashboard auf die Seite „Benachrichtigungen“, wenn Ihr Workspace aktive Benachrichtigungen hat. ## Schwellenwerte konfigurieren Schwellenwerte für Benachrichtigungen können auf Workspace-Ebene konfiguriert und pro Agent überschrieben werden. Nicht festgelegte Werte verwenden die Workspace-Konfiguration, und nicht festgelegte Workspace-Werte verwenden die Systemstandards. > **Note** > > Benachrichtigungseinstellungen auf Workspace-Ebene können nur von Workspace-Administratoren geändert werden. Klicken Sie auf der Seite [**Developers** > **Alerts**](https://elevenlabs.io/app/developers/alerts) auf **Alert-Einstellungen** und wählen Sie **Schwellenwerte konfigurieren**. Um Schwellenwerte für einen einzelnen Agenten zu überschreiben, öffnen Sie stattdessen den Bereich **Alerting** im Tab **Advanced** der Agent-Einstellungen und klicken auf **Schwellenwerte konfigurieren**. Jede Überwachung kann aktiviert oder deaktiviert werden und verfügt über die Einstellung **Schwellenwert**: die Fehlerrate, die eine Benachrichtigung auslöst, als Prozentsatz zwischen 0 % und 100 %. Mit **Nach Inaktivität automatisch auflösen (Minuten)** können Sie außerdem festlegen, wie lange eine Benachrichtigung inaktiv bleiben kann, bevor sie automatisch aufgelöst wird. ![Benachrichtigungseinstellungen im Tab „Advanced“ des Agenten](/docs/_fern-img/d951fa5b6cd3c39590227a893874426be4b0629cd84a6d9919b584a977d2cfdc.webp) ## Benachrichtigungen Benachrichtigungen können externe Systeme über [Workspace-Webhooks](/docs/de/eleven-api/resources/webhooks), Slack und PagerDuty informieren. Wenn eine Benachrichtigung ausgelöst, aufgelöst oder verworfen wird, benachrichtigt ElevenLabs jeden konfigurierten Notifier. Notifier können auf Workspace-Ebene und pro Agent angehängt werden. Notifier auf Agentenebene ergänzen Workspace-Notifier, anstatt sie zu ersetzen. Pro Ebene können bis zu 10 Notifier konfiguriert werden. Um einen Notifier einzurichten, klicken Sie auf der Seite [**Developers** > **Alerts**](https://elevenlabs.io/app/developers/alerts) auf **Alert-Einstellungen** > **Benachrichtigungen konfigurieren**. Für einen einzelnen Agenten wählen Sie **Benachrichtigungen konfigurieren** im Bereich **Alerting** des Tabs **Advanced** in den Agent-Einstellungen. Jeder Notifier bietet die Aktion **Test senden**, mit der Sie die Zustellung prüfen können, bevor eine Benachrichtigung ausgelöst wird. ### Webhooks Wählen Sie einen vorhandenen Workspace-Webhook aus oder erstellen Sie einen neuen mit einer HTTPS-Callback-URL. ElevenLabs sendet für jedes Ereignis im Lebenszyklus einer Benachrichtigung eine POST-Anfrage. Ihr Endpunkt sollte die Anfragesignatur überprüfen und unverzüglich HTTP 200 zurückgeben. Webhooks, die wiederholt fehlschlagen, werden automatisch deaktiviert, gemäß denselben Regeln wie andere [Workspace-Webhooks](/docs/de/eleven-api/resources/webhooks). #### Benachrichtigungs-Payload Benachrichtigungen verwenden den Ereignistyp `convai_alerting_notification`. Das Feld `event.name` zeigt an, was passiert ist: `triggered`, wenn die Benachrichtigung aktiv wird, `auto_resolved`, wenn sie nach Inaktivität aufgelöst wird, und `resolved`, wenn ein Nutzer sie verworfen hat (in diesem Fall ist `was_resolved_by_user` auf `true` gesetzt). Das Feld `text` enthält eine menschenlesbare Zusammenfassung mit Slack-Markup, sodass die Benachrichtigung direkt an einen eingehenden Slack-Webhook weitergeleitet werden kann. ```json { "type": "convai_alerting_notification", "event_timestamp": 1739537297, "text": ":rotating_light: *New agent alert - High tool failure rate*\n*Agent:* \n*Status:* Triggered\n*Started at:* 14 February at 12:48 UTC", "event": { "name": "triggered", "was_resolved_by_user": false }, "alert": { "id": "alert_2601k5zvyjhmfg983brhmhkd98n6", "tool_name": "get_order_status", "monitor": "elevated_tool_failure_rate", "metric_name": "tool_failure_rate", "status": "active", "first_triggered_at_unix_secs": 1739537297, "last_triggered_at_unix_secs": 1739537897 } } ``` Das Feld `monitor` ist eines von `elevated_conversation_failure_rate`, `elevated_tool_failure_rate`, `webhook_error_spike`, `guardrail_trigger_spike`, `call_initiation_error_spike` oder `low_evaluation_success_score`. Das Feld `tool_name` wird nur für Benachrichtigungen über Tool-Fehler gesetzt. ### Slack Slack-Notifier senden Benachrichtigungen direkt an einen Slack-Kanal. Verbinden Sie die [Slack-Integration](/docs/de/eleven-agents/customization/integrations/slack) mit Ihrem Workspace, fügen Sie dann die Verbindung als Notifier hinzu und geben Sie die ID des Kanals an, an den gesendet werden soll. Um die Kanal-ID in Slack zu finden, öffnen Sie den Kanal, klicken Sie in der Kopfzeile auf den Kanalnamen, scrollen Sie dann zum Ende des Tabs **Info** und kopieren Sie die Kanal-ID (zum Beispiel `C0123456789`). Fügen Sie die verbundene Slack-App zum Kanal hinzu. Die App benötigt den Bereich `chat:write` oder `chat:write.public`, um Beiträge in öffentlichen Kanälen zu veröffentlichen, denen sie nicht beigetreten ist. Eine Nachricht wird gesendet, wenn eine Benachrichtigung ausgelöst wird, und erneut, wenn sie aufgelöst wird. ### PagerDuty PagerDuty-Notifier übermitteln Benachrichtigungen als PagerDuty-Incidents über die [Events API](https://developer.pagerduty.com/docs/events-api-v2-overview). Verbinden Sie auf der [Integrationsseite](https://elevenlabs.io/app/agents/integrations) die PagerDuty-Integration mit einem Events API v2-Integrationsschlüssel des PagerDuty-Service, der die Benachrichtigungen erhalten soll. Fügen Sie dann die Verbindung als Notifier hinzu. Ein Incident wird ausgelöst, wenn eine Benachrichtigung aktiv wird, und automatisch aufgelöst, wenn die Benachrichtigung aufgelöst wird. Wiederholte Auslösungen derselben Benachrichtigung werden zu einem einzigen Incident dedupliziert. Die US- und EU-Service-Regionen von PagerDuty werden beide unterstützt. ## Zugehörige Ressourcen #### [Webhooks](/docs/de/eleven-api/resources/webhooks) Konfigurieren Sie Workspace-Webhooks, Wiederholungen und das Verhalten bei automatischer Deaktivierung. #### [Echtzeitüberwachung](/docs/de/eleven-agents/guides/realtime-monitoring) Beobachten Sie Live-Gespräche und senden Sie während aktiver Anrufe Steuerbefehle. #### [Webhooks nach dem Anruf](/docs/de/eleven-agents/workflows/post-call-webhooks) Erhalten Sie Gesprächsdaten und Analysen nach Abschluss von Anrufen. #### [Analysen](/docs/de/eleven-agents/dashboard) Verfolgen Sie Agent-Performance-Metriken im Dashboard.