Herramientas para desarrolladores
PagerDuty en tu producto y en tus agentes de IA, con una API
El toolkit de PagerDuty cubre incidentes, sus notas y entradas de registro, servicios, turnos de guardia, usuarios, políticas de escalado y prioridades. Con Connect, un producto o agente de IA activa y gestiona incidentes en la cuenta del cliente, con los permisos de quien creó el token, sin construir la integración.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/pagerduty_create_incident/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"incident": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a PagerDuty.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de PagerDuty. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con PagerDuty.
Incidentes desde tu monitoreo
Crea un incidente en un servicio cuando tu producto detecte un fallo, lo que notifica a la política de escalado de ese servicio.
Consulta de guardia para un agente
Deja que un agente de IA liste quién está de guardia ahora, lea la línea de tiempo del incidente por sus entradas de registro y publique una nota con lo que encontró.
Triaje de incidentes
Lista los incidentes recientes y reconócelos, reasígnalos, escálalos o resuélvelos desde tu interfaz o desde un chat con un agente.
Tools
12 tools de PagerDuty
- Listar incidentesGETLista los incidentes de la cuenta creados en el último mes, o en el rango de since y until. Aquí no hay filtro por estado, servicio o asignado, así que lee status, service y assignments en cada elemento. Pagina con limit y offset mientras more sea true.
- Obtener incidenteGETDevuelve un incidente con su estado, urgencia, prioridad, servicio, asignaciones, reconocimientos y política de escalado.
- Crear incidentePOSTCrea un incidente en un servicio, lo que notifica a la política de escalado del servicio o a los usuarios en assignments. Necesita type, title y service. Envía assignments o escalation_policy, nunca ambos. Un incidente que el usuario se asigna a sí mismo empieza reconocido, sin notificarlo.
- Actualizar incidentePUTReconoce, resuelve, reasigna o escala un incidente, o cambia su título, urgencia, prioridad o servicio. Envía type y solo los campos a cambiar. Reasignar o escalar notifica a los nuevos responsables, y definir status en un incidente resuelto lo reabre.
- Listar notas del incidenteGETLista las notas de un incidente, cada una con su contenido, autor y hora de creación.
- Crear nota en el incidentePOSTAgrega una nota a un incidente, firmada por el usuario de la conexión. Un incidente admite hasta 2000 notas.
- Listar entradas de registro del incidenteGETLista la línea de tiempo de un incidente: activaciones, notificaciones, reconocimientos, asignaciones, escalados, notas y resolución, cada uno con el agente y la hora. Pagina con limit y offset mientras more sea true.
- Listar serviciosGETLista los servicios de la cuenta, cada uno con id, nombre, estado y política de escalado. El id es lo que piden Create incident y Update incident. Pagina con limit y offset mientras more sea true.
- Listar guardiasGETLista quién está de guardia, una entrada por usuario, política de escalado y nivel, con el horario cuando el turno viene de uno. Sin since y until, devuelve las guardias de este momento. Pagina con limit y offset mientras more sea true.
- Listar usuariosGETLista los usuarios de la cuenta, con id, nombre, correo y rol. El id va en el assignee de Create incident y Update incident. Pagina con limit y offset mientras more sea true.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de PagerDuty
¿Necesito implementar la API de PagerDuty?
No. Connect ya trae 12 tools de PagerDuty descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de PagerDuty?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
