logo
Desarrollo
Buscar
Notificación de alertas

Notificación de alertas

Tipo de alerta

image-20241226194156222

En «Organization - Alert Notifications» de GPTBots, se pueden probar las funciones relacionadas con alertas.
La función de notificaciones de alertas de GPTBots se divide en tres tipos según los distintos escenarios de negocio:

  • Alerta de cuota: alerta relacionada con créditos y planes de suscripción. Incluye: alertas de saldo de créditos, alertas de consumo de créditos, alertas de planes de suscripción.
  • Alerta de Agent: alerta relacionada con los escenarios de negocio de Agent (agente). Incluye: alertas por superar el límite de RPM de las conversaciones de Agent, alertas del número de activaciones del límite de RPM de las conversaciones de Agent, alertas por superar el límite del número de respuestas anómalas en conversaciones de Agent.
  • Alerta de clasificación de incidencias: alerta relacionada con escenarios que implican la frecuencia de clasificaciones de incidencias durante las interacciones de Agent.

Configuración de reglas de alerta

Elementos de alerta

image-20241226194534946

Tras seleccionar el tipo de alerta, hacer clic en «Add Alert» para comenzar a configurar la alerta.

Al configurar la alerta, es necesario seleccionar elementos de alerta específicos. Por ejemplo: saldo de créditos.
Se debe tener en cuenta que, en las alertas de cuota y de Agent, se debe seleccionar el Agent de destino. En las alertas de clasificación de incidencias, se deben seleccionar tanto el Agent de destino como la clasificación de incidencias de destino.

Reglas de alerta

Las reglas de alerta son las condiciones que activan la alerta. Cuando se cumplen las condiciones, se activa una alerta.

Frecuencia de notificación

La frecuencia de notificación determina con qué periodicidad se envían las alertas. Una vez que se activa una alerta, los usuarios pueden configurar la frecuencia de notificación de forma independiente.

Canales de notificación

image-20241226194739578

GPTBots admite cuatro métodos de notificación: correo electrónico (Email), SMS, WhatsApp y webhook. Se pueden seleccionar los métodos de notificación y añadir miembros. Cuando se activa una alerta, GPTBots la enviará según los métodos seleccionados y los datos de contacto de los miembros.

Configuración del webhook de alertas

Este webhook se utiliza para recibir notificaciones de alertas. Mediante una solicitud POST, GPTBots envía a la URL de webhook especificada la información de la alerta, incluido el título, la hora y el contenido.

URL de solicitud

  • URL: URL de webhook configurada dinámicamente
  • Método: POST
  • Content-Type: application/json

Encabezados de solicitud
Username: webhookClientId
Secret: webhookClientSecret

Encabezado Obligatorio Descripción
Content-Type El tipo de contenido del cuerpo de la solicitud, siempre es application/json
Authorization No Este encabezado es obligatorio si se configuran tanto webhookClientId como webhookClientSecret.

Descripción del encabezado Authorization

  • Si existen tanto webhookClientId como webhookClientSecret, se utiliza autenticación Basic, con el formato:
Authorization: Basic Base64(clientId:clientSecret)
                      
                      Authorization: Basic Base64(clientId:clientSecret)

                    
Este bloque de código en una ventana flotante
  • Si solo existe webhookClientId, se debe utilizar autenticación Bearer con el siguiente formato:
Authorization: Bearer clientId
                      
                      Authorization: Bearer clientId

                    
Este bloque de código en una ventana flotante
  • Si solo existe webhookClientSecret, se debe utilizar autenticación Bearer con el siguiente formato:
Authorization: Bearer clientSecret
                      
                      Authorization: Bearer clientSecret

                    
Este bloque de código en una ventana flotante

Cuerpo de la solicitud
El cuerpo de la solicitud está en formato JSON e incluye los siguientes campos:

Campo Tipo Obligatorio Descripción
title String título de la alerta
time Long marca de tiempo de la alerta (en milisegundos)
content String Contenido específico de la alerta

Ejemplo:

{ "title": "CPU Usage alert", "time": 1698745600000, "content": "The CPU usage has exceeded 90% for the last 5 minutes." }
                      
                      {
  "title": "CPU Usage alert",
  "time": 1698745600000,
  "content": "The CPU usage has exceeded 90% for the last 5 minutes."
}

                    
Este bloque de código en una ventana flotante

Notas

  1. Validación de la URL de webhook: La URL debe ser una dirección externa válida y no puede apuntar a una dirección de red interna (p. ej., 192.168.x.x o 10.x.x.x).
  2. Autenticación: Si se configura webhookClientId o webhookClientSecret, se puede realizar la autenticación según el método correspondiente.
  3. Configuración del tiempo de espera: El tiempo de espera predeterminado de la solicitud es de 5 segundos. Si el servidor de destino no responde en 5 segundos, la solicitud fallará.

Control de frecuencia de alertas

image-20241226194848985

En «Alert Frequency Control», se puede configurar el volumen total de notificaciones de alertas enviadas a través de distintos canales y configurar el idioma de las notificaciones de alertas.