> 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. # Alertes ## Vue d’ensemble Les alertes vous avertissent lorsqu’un problème affecte les agents de vos Workspaces. ElevenLabs surveille en continu l’activité des conversations et déclenche une alerte lorsqu’un taux d’erreur dépasse un seuil configuré ou augmente fortement par rapport à son niveau de référence récent. Les alertes ne nécessitent aucune configuration pour fonctionner : les moniteurs s’exécutent automatiquement avec des seuils par défaut, que vous pouvez ajuster ou compléter par des notifications si nécessaire. Les alertes sont consultées et gérées dans le dashboard ElevenLabs, où les paramètres sont configurés au niveau du Workspace et de l’agent. Les paramètres au niveau de l’agent peuvent également être définis par programmation via le champ `platform_settings.alerting` lors de la création ou de la mise à jour d’un agent avec l’API [Mettre à jour un agent](/docs/fr/api-reference/agents/update), les SDK ou les fichiers de configuration d’[Agents CLI](/docs/fr/eleven-agents/operate/cli). Les paramètres au niveau du Workspace et l’historique des alertes sont uniquement disponibles dans le dashboard. Les moniteurs suivants sont évalués pour chaque agent : | Type d’alerte | Déclencheur | | ------------------------------- | -------------------------------------------------------------------------- | | Échec de conversation | Les erreurs dépassent un pourcentage des conversations | | Échec d’outil | Les erreurs dépassent un pourcentage des appels d’outil, suivi par outil | | Erreur de webhook | Les erreurs dépassent un pourcentage des appels de webhook | | Déclenchement de garde-fou | Les déclenchements de garde-fou dépassent un pourcentage des conversations | | Erreur d’initialisation d’appel | Les erreurs dépassent un pourcentage des initialisations d’appel | | Score de réussite d’évaluation | Le score moyen de réussite d’évaluation tombe sous un seuil | Chaque alerte présente l’un des statuts suivants : * **Active** : la condition est actuellement déclenchée. * **Résolue** : la condition ne se déclenche plus et l’alerte a été résolue automatiquement après une période d’inactivité. * **Ignorée** : un utilisateur a ignoré manuellement l’alerte. ## Consulter les alertes Accédez à [**Développeurs** > **Alertes**](https://elevenlabs.io/app/developers/alerts) pour voir les alertes de suivi récentes concernant les agents de vos Workspaces. La page présente une chronologie de l’activité des alertes et un tableau indiquant pour chacune l’horodatage, la durée, le statut, le type et l’agent. Vous pouvez filtrer par statut, agent ou outil, et ajuster la plage temporelle, jusqu’à 90 jours. ![Page Alertes dans le dashboard](/docs/_fern-img/d2dbe97d07149ab05ea88cff5300146de39682532a84d1a37326b01dbc04ba9f.webp) Cliquez sur une alerte pour ouvrir les conversations concernées, ou utilisez le menu de la ligne pour **Inspecter les conversations** dans l’historique des conversations. Les alertes actives peuvent être ignorées depuis ce même menu. Les alertes actives s’affichent également sous forme de cartes prioritaires dans [**Spotlight**](/docs/fr/eleven-agents/dashboard/spotlight), le dashboard de vue d’ensemble sur la page de chaque agent. Une bannière dans le dashboard Agents renvoie vers la page Alertes lorsque votre Workspace compte des alertes actives. ## Configurer les seuils Les seuils d’alerte peuvent être configurés au niveau du Workspace et remplacés pour chaque agent. Les valeurs non définies utilisent la configuration du Workspace, et les valeurs non définies au niveau du Workspace utilisent les valeurs par défaut du système. > **Note** > > Seuls les administrateurs du Workspace peuvent modifier les paramètres d’alerte au niveau du Workspace. Sur la page [**Développeurs** > **Alertes**](https://elevenlabs.io/app/developers/alerts), cliquez sur **Paramètres des alertes**, puis sélectionnez **Configurer les seuils**. Pour remplacer les seuils d’un seul agent, ouvrez plutôt la section **Alertes** dans l’onglet des paramètres **Avancés** de l’agent, puis cliquez sur **Configurer les seuils**. Chaque moniteur peut être activé ou désactivé et dispose d’un paramètre **Seuil** : le taux d’erreur qui déclenche une alerte, exprimé en pourcentage entre 0 % et 100 %. Vous pouvez aussi définir **Résolution automatique après inactivité (minutes)** pour contrôler la durée pendant laquelle une alerte peut rester inactive avant sa résolution automatique. ![Paramètres d’alerte dans l’onglet Avancés de l’agent](/docs/_fern-img/d951fa5b6cd3c39590227a893874426be4b0629cd84a6d9919b584a977d2cfdc.webp) ## Notifications Les alertes peuvent notifier des systèmes externes via les [webhooks du Workspace](/docs/fr/eleven-api/resources/webhooks), Slack et PagerDuty. Lorsqu’une alerte se déclenche, est résolue ou est ignorée, ElevenLabs notifie chaque notificateur configuré. Des notificateurs peuvent être associés au niveau du Workspace et de chaque agent. Les notificateurs au niveau de l’agent s’ajoutent à ceux du Workspace, sans les remplacer. Vous pouvez configurer jusqu’à 10 notificateurs par niveau. Pour configurer un notificateur, cliquez sur **Paramètres des alertes** > **Configurer les notifications** sur la page [**Développeurs** > **Alertes**](https://elevenlabs.io/app/developers/alerts) ou, pour un seul agent, sur **Configurer les notifications** dans la section **Alertes** de l’onglet des paramètres **Avancés** de l’agent. Chaque notificateur propose l’action **Envoyer un test** pour vérifier la réception avant le déclenchement d’une alerte. ### Webhooks Sélectionnez un webhook existant du Workspace ou créez-en un avec une URL de rappel HTTPS. ElevenLabs envoie une requête POST pour chaque événement du cycle de vie d’une alerte. Votre endpoint doit vérifier la signature de la requête et renvoyer rapidement HTTP 200. Les webhooks qui échouent à répétition sont désactivés automatiquement, selon les mêmes règles que les autres [webhooks du Workspace](/docs/fr/eleven-api/resources/webhooks). #### Charge utile de notification Les notifications d’alerte utilisent le type d’événement `convai_alerting_notification`. Le champ `event.name` indique ce qui s’est produit : `triggered` lorsque l’alerte devient active, `auto_resolved` lorsqu’elle est résolue après une période d’inactivité et `resolved` lorsqu’un utilisateur l’a ignorée, auquel cas `was_resolved_by_user` vaut `true`. Le champ `text` contient un résumé lisible par une personne, mis en forme avec le balisage Slack, afin que la notification puisse être transférée directement vers un webhook entrant Slack. ```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 } } ``` Le champ `monitor` correspond à l’une des valeurs suivantes : `elevated_conversation_failure_rate`, `elevated_tool_failure_rate`, `webhook_error_spike`, `guardrail_trigger_spike`, `call_initiation_error_spike` ou `low_evaluation_success_score`. Le champ `tool_name` est défini uniquement pour les alertes d’échec d’outil. ### Slack Les notificateurs Slack publient les notifications d’alerte directement dans un canal Slack. Connectez l’[intégration Slack](/docs/fr/eleven-agents/customization/integrations/slack) à votre Workspace, puis ajoutez la connexion comme notificateur et saisissez l’ID du canal de publication. Pour trouver l’ID du canal dans Slack, ouvrez le canal, cliquez sur son nom dans l’en-tête, puis faites défiler jusqu’en bas de l’onglet **À propos** et copiez l’ID du canal, par exemple `C0123456789`. Ajoutez l’application Slack connectée au canal. L’application nécessite le champ d’application `chat:write`, ou `chat:write.public` pour publier dans des canaux publics qu’elle n’a pas rejoints. Un message est publié lorsqu’une alerte se déclenche, puis lorsqu’elle est résolue. ### PagerDuty Les notificateurs PagerDuty transmettent les alertes sous forme d’incidents PagerDuty via l’[API Events](https://developer.pagerduty.com/docs/events-api-v2-overview). Connectez l’intégration PagerDuty sur la [page Intégrations](https://elevenlabs.io/app/agents/integrations) avec une clé d’intégration Events API v2 du service PagerDuty qui doit recevoir les alertes, puis ajoutez la connexion comme notificateur. Un incident est déclenché lorsqu’une alerte devient active et automatiquement résolu lorsque l’alerte est résolue. Les déclenchements répétés de la même alerte sont dédupliqués dans un seul incident. Les régions de service PagerDuty américaines et européennes sont prises en charge. ## Ressources associées #### [Webhooks](/docs/fr/eleven-api/resources/webhooks) Configurez les webhooks du Workspace, les nouvelles tentatives et le comportement de désactivation automatique. #### [Suivi en temps réel](/docs/fr/eleven-agents/guides/realtime-monitoring) Observez les conversations en direct et envoyez des commandes de contrôle pendant les appels actifs. #### [Webhooks post-appel](/docs/fr/eleven-agents/workflows/post-call-webhooks) Recevez les données et analyses des conversations une fois les appels terminés. #### [Analyses](/docs/fr/eleven-agents/dashboard) Suivez les métriques de performance des agents dans le dashboard.