PagerDuty
En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.
Descripción General
Conecta tu cuenta de PagerDuty a Nirvai para automatizar la gestión de incidentes, horarios de guardia y flujos de trabajo de alertas.
Métodos de Autenticación Soportados
- API Key - Token de API REST para acceso completo a la API
Requisitos Previos
- Una cuenta de PagerDuty
- Rol de Admin o Account Owner (para crear claves API)
Instrucciones de Configuración
API Key
- Inicia sesión en tu cuenta de PagerDuty
- Navega a Integrations > Developer Tools > API Access Keys
- O ve a: Settings (icono de engranaje) > API Access
- Haz clic en Create New API Key
- Ingresa una descripción (ej., "Integración Nirvai")
- Selecciona el tipo de clave:
- Read-only: Solo para monitoreo
- Full Access: Para crear/actualizar incidentes
- Haz clic en Create Key
- Copia la API Key inmediatamente (no se mostrará de nuevo)
- Pega la clave en Nirvai
Alternativa: Token de Usuario
También puedes usar un Token de API de Usuario:
- Haz clic en tu avatar > My Profile
- Ve a la pestaña User Settings
- Desplázate hasta API Access
- Haz clic en Create API User Token
- Copia y usa el token
Tipos de Claves
| Tipo de Clave | Caso de Uso | Permisos |
|---|---|---|
| Account API Key | Acceso a toda la organización | Solo lectura o Completo |
| User Token | Acceso específico del usuario | Basado en el rol del usuario |
Operaciones Disponibles
Con credenciales de PagerDuty, puedes:
- Crear y gestionar incidentes
- Reconocer y resolver alertas
- Acceder a horarios de guardia
- Gestionar políticas de escalamiento
- Ver estado de servicios
- Acceder a usuarios y equipos
- Gestionar ventanas de mantenimiento
Solución de Problemas
Problemas Comunes
- 401 Unauthorized: La API key es inválida o fue revocada. Genera una nueva clave.
- 403 Forbidden: La clave carece de permisos para la operación.
- 404 Not Found: El recurso no existe o la clave no puede acceder a él.
- Rate Limiting: PagerDuty limita las solicitudes API. Implementa backoff.
Gestión de Claves
- Las API keys no expiran automáticamente
- Revoca las claves inmediatamente si están comprometidas
- Usa nombres descriptivos para rastrear el uso de claves
- Considera claves separadas para diferentes integraciones
Encontrar IDs de Recursos
PagerDuty usa IDs alfanuméricos (ej., PXXXXXX):
- Service ID: En la URL o configuración del servicio
- User ID: En la URL del perfil de usuario
- Incident ID: En la URL del incidente
Alternativa de Webhook
Para notificaciones en tiempo real, considera usar webhooks de PagerDuty:
- Ve a Service > Integrations
- Agrega un Generic Webhook
- Configura la URL del endpoint
Recursos Relacionados
- PagerDuty API Access Keys
- Documentación de la API REST de PagerDuty
- Portal de Desarrolladores de PagerDuty
Adaptado de la documentación de n8n para la plataforma Nirvai
Siguientes Pasos
Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.