> 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. # Alertas ## Resumen Las alertas te avisan cuando algo va mal con los agentes de tu espacio de trabajo. ElevenLabs supervisa continuamente la actividad de las conversaciones y genera una alerta cuando una tasa de errores supera un umbral configurado o aumenta bruscamente respecto a su nivel de referencia reciente. Las alertas no requieren configuración para empezar a funcionar: los monitores se ejecutan automáticamente con umbrales predeterminados, y puedes ajustar los umbrales o añadir notificaciones cuando lo necesites. Las alertas se consultan y gestionan en el panel de ElevenLabs, donde la configuración se establece a nivel de espacio de trabajo y de agente. La configuración a nivel de agente también se puede establecer mediante programación a través del campo `platform_settings.alerting` al crear o actualizar un agente con la API, los SDK o los archivos de configuración de [Agents CLI](/docs/es/eleven-agents/operate/cli) de [Actualizar agente](/docs/es/api-reference/agents/update). La configuración a nivel de espacio de trabajo y el historial de alertas solo están disponibles en el panel. Se evalúan los siguientes monitores para cada agente: | Tipo de alerta | Activador | | --------------------------------- | --------------------------------------------------------------------------------- | | Fallo de conversación | Los errores superan un porcentaje de las conversaciones | | Fallo de herramienta | Los errores superan un porcentaje de las llamadas a herramientas, por herramienta | | Error de webhook | Los errores superan un porcentaje de las llamadas de webhook | | Activación de guardrail | Las activaciones de guardrails superan un porcentaje de las conversaciones | | Error al iniciar la llamada | Los errores superan un porcentaje de los inicios de llamada | | Puntuación de éxito de evaluación | La puntuación media de éxito de evaluación baja de un umbral | Cada alerta tiene uno de los siguientes estados: * **Activa**: La condición se está activando actualmente. * **Resuelta**: La condición dejó de activarse y la alerta se resolvió automáticamente tras un periodo de inactividad. * **Descartada**: Un usuario descartó manualmente la alerta. ## Ver alertas Ve a [**Desarrolladores** > **Alertas**](https://elevenlabs.io/app/developers/alerts) para consultar las alertas de monitorización recientes de los agentes de tu espacio de trabajo. La página muestra una cronología de la actividad de alertas y una tabla con la fecha y hora, duración, estado, tipo y agente de cada alerta. Puedes filtrar por estado, agente o herramienta, y ajustar el intervalo temporal (hasta 90 días). ![Página de alertas en el panel](/docs/_fern-img/d2dbe97d07149ab05ea88cff5300146de39682532a84d1a37326b01dbc04ba9f.webp) Haz clic en una alerta para abrir las conversaciones afectadas o usa el menú de fila para **Inspeccionar conversaciones** en el historial de conversaciones. Puedes descartar las alertas activas desde el mismo menú. Las alertas activas también aparecen como tarjetas de alta prioridad en [**Spotlight**](/docs/es/eleven-agents/dashboard/spotlight), el panel de resumen de la página de cada agente, y aparece un banner en el panel de Agents con un enlace a la página de Alertas siempre que tu espacio de trabajo tenga alertas activas. ## Configurar umbrales Los umbrales de alerta se pueden configurar a nivel de espacio de trabajo y sobrescribir para cada agente. Los valores no definidos recurren a la configuración del espacio de trabajo, y los valores no definidos del espacio de trabajo recurren a los valores predeterminados del sistema. > **Note** > > Solo los administradores del espacio de trabajo pueden cambiar la configuración de alertas a nivel de espacio de trabajo. En la página [**Desarrolladores** > **Alertas**](https://elevenlabs.io/app/developers/alerts), haz clic en **Configuración de alertas** y selecciona **Configurar umbrales**. Para sobrescribir los umbrales de un solo agente, abre la sección **Alertas** en la pestaña de configuración **Avanzada** del agente y haz clic en **Configurar umbrales**. Cada monitor se puede activar o desactivar y cuenta con una configuración de **Umbral**: la tasa de errores que activa una alerta, como porcentaje entre el 0 % y el 100 %. También puedes establecer **Resolver automáticamente tras inactividad (minutos)** para controlar cuánto tiempo puede permanecer inactiva una alerta antes de resolverse automáticamente. ![Configuración de alertas en la pestaña Avanzada del agente](/docs/_fern-img/d951fa5b6cd3c39590227a893874426be4b0629cd84a6d9919b584a977d2cfdc.webp) ## Notificaciones Las alertas pueden notificar a sistemas externos mediante [webhooks del espacio de trabajo](/docs/es/eleven-api/resources/webhooks), Slack y PagerDuty. Cuando una alerta se activa, se resuelve o se descarta, ElevenLabs avisa a cada notificador configurado. Los notificadores se pueden añadir a nivel de espacio de trabajo y por agente; los notificadores a nivel de agente se añaden a los del espacio de trabajo, en lugar de sustituirlos. Se pueden configurar hasta 10 notificadores por nivel. Para configurar un notificador, haz clic en **Configuración de alertas** > **Configurar notificaciones** en la página [**Desarrolladores** > **Alertas**](https://elevenlabs.io/app/developers/alerts) o, para un solo agente, en **Configurar notificaciones** dentro de la sección **Alertas** de la pestaña de configuración **Avanzada** del agente. Cada notificador tiene una acción **Enviar prueba** para verificar el envío antes de que se active una alerta. ### Webhooks Selecciona un webhook existente del espacio de trabajo o crea uno nuevo con una URL de callback HTTPS. ElevenLabs envía una solicitud POST para cada evento del ciclo de vida de una alerta. Tu ruta debe verificar la firma de la solicitud y devolver HTTP 200 sin demora; los webhooks que fallen repetidamente se desactivan automáticamente, siguiendo las mismas reglas que los demás [webhooks del espacio de trabajo](/docs/es/eleven-api/resources/webhooks). #### Carga útil de la notificación Las notificaciones de alertas usan el tipo de evento `convai_alerting_notification`. El campo `event.name` indica qué ha ocurrido: `triggered` cuando la alerta pasa a estar activa, `auto_resolved` cuando se resuelve tras un periodo de inactividad y `resolved` cuando un usuario la descarta (en cuyo caso `was_resolved_by_user` es `true`). El campo `text` contiene un resumen legible para personas con formato de marcado de Slack, por lo que la notificación puede reenviarse directamente a un webhook entrante de 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 } } ``` El campo `monitor` puede ser `elevated_conversation_failure_rate`, `elevated_tool_failure_rate`, `webhook_error_spike`, `guardrail_trigger_spike`, `call_initiation_error_spike` o `low_evaluation_success_score`. El campo `tool_name` solo se establece para alertas de fallo de herramientas. ### Slack Los notificadores de Slack publican notificaciones de alertas directamente en un canal de Slack. Conecta la [integración de Slack](/docs/es/eleven-agents/customization/integrations/slack) a tu espacio de trabajo y, a continuación, añade la conexión como notificador e introduce el ID del canal donde publicar. Para encontrar el ID del canal en Slack, abre el canal, haz clic en el nombre del canal de la cabecera, desplázate hasta el final de la pestaña **Acerca de** y copia el ID del canal (por ejemplo, `C0123456789`). Añade la aplicación de Slack conectada al canal; la aplicación necesita el permiso `chat:write`, o `chat:write.public` para publicar en canales públicos a los que no se haya unido. Se publica un mensaje cuando se activa una alerta y otro cuando se resuelve. ### PagerDuty Los notificadores de PagerDuty envían alertas como incidentes de PagerDuty a través de la [API de eventos](https://developer.pagerduty.com/docs/events-api-v2-overview). Conecta la integración de PagerDuty en la [página de integraciones](https://elevenlabs.io/app/agents/integrations) con una clave de integración de Events API v2 del servicio de PagerDuty que debe recibir las alertas y, a continuación, añade la conexión como notificador. Se activa un incidente cuando una alerta pasa a estar activa y se resuelve automáticamente cuando la alerta se resuelve; las activaciones repetidas de la misma alerta se deduplican en un único incidente. Se admiten las regiones de servicio de PagerDuty de EE. UU. y la UE. ## Recursos relacionados #### [Webhooks](/docs/es/eleven-api/resources/webhooks) Configura webhooks del espacio de trabajo, reintentos y el comportamiento de desactivación automática. #### [Monitorización en tiempo real](/docs/es/eleven-agents/guides/realtime-monitoring) Observa conversaciones en directo y envía comandos de control durante llamadas activas. #### [Webhooks posteriores a la llamada](/docs/es/eleven-agents/workflows/post-call-webhooks) Recibe datos y análisis de conversaciones después de que terminen las llamadas. #### [Analítica](/docs/es/eleven-agents/dashboard) Supervisa las métricas de rendimiento de los agentes en el panel.