Resumen: ◀▼
Conectar el generador de acciones a incident.io es una manera de automatizar la gestión de incidentes dentro de sus flujos de trabajo. Así podrá crear, actualizar y buscar incidentes desde los mismos flujos de acciones para mejorar la colaboración y la respuesta a incidentes. Use una cuenta de servicio exclusiva para la autenticación y administre los tokens de API de manera segura para mantener la integración de la administración de incidentes controlada y protegida.
Incident.io es una plataforma de administración de incidentes que ayuda a los equipos a responder a los incidentes y resolverlos de manera eficiente. Con el conector de incident.io para el generador de acciones, puede crear y administrar incidentes, actualizar los detalles de los incidentes y obtener información de los incidentes desde sus flujos de acciones de Zendesk.
Conectar incident.io con el generador de acciones
Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.
- Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.
- Todas las integraciones solicitan acceso a los ámbitos necesarios. Sin embargo, es importante que revise y valide los ámbitos antes de autorizar la conexión al sistema externo.
- Cuando necesite administrar credenciales para herramientas que funcionan con claves API (como OpenAI), lo mejor es guardar las claves en una bóveda o con un administrador de credenciales.
Para generar un token de API para la autenticación
- Inicie sesión en su cuenta de incident.io.
- Vaya a Settings.
- Desplácese a API tokens.
- Cree un nuevo token de API con los permisos necesarios.
- Guarde el token de API o mantenga abierta la ventana para poder copiarlo y pegarlo en Zendesk. Lo necesitará para conectar incident.io con el generador de acciones.
- En el Centro de administración, haga clic en
Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones > Flujos de acciones. - Cree o edite un flujo de acciones.
- Abra la barra lateral de pasos.
- En Acciones externas, haga clic en incident.io.
- Haga clic en Conectar.
- Siga las instrucciones de incident.io para autenticarse y completar la conexión.Nota: Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.
Después de conectarse al sistema, verá un indicador de conexión y detalles sobre la instancia a la que está conectado, así como las acciones disponibles para incident.io.
Usar las acciones de incident.io en los flujos de acciones
Los pasos de acción de incident.io se pueden usar para buscar formularios y respuestas de encuestas.
Crear un nuevo incidente
Use la acción Crear incidente para crear un incidente nuevo en incident.io con los detalles especificados.
Esta acción tiene las siguientes entradas y salidas:
| Variables | |
|---|---|
| Entrada | Requerido: Name, SeverityOpcional:
Nota: Las opciones de visibilidad incluyen Público o Privado (Público de manera predeterminada). El URL de llamada puede ser un vínculo a una llamada de incidente o una plataforma como Zoom o Google Meet.
|
| Salida | Detalles del incidente, lo que incluye: ID, nombre, estado, severidad y marca de tiempo de creación |
Actualizar un incidente
Use la acción Actualizar incidente para actualizar las propiedades de un incidente existente en incident.io.
Esta acción tiene las siguientes entradas y salidas:
| Variables | |
|---|---|
| Entrada | Requerido: Incident IDOpcional:
Nota: Las opciones de visibilidad incluyen Público o Privado (Público de manera predeterminada). El URL de llamada puede ser un vínculo a una llamada de incidente o una plataforma como Zoom o Google Meet.
|
| Salida | Detalles del incidente actualizado, lo que incluye: ID, nombre, estado, severidad y marca de tiempo de actualización |
Buscar un incidente
Use la acción Buscar incidente para obtener información detallada sobre un incidente específico por su ID.
Esta acción tiene las siguientes entradas y salidas:
| Variables | |
|---|---|
| Entrada | Requerido: Incident ID
|
| Salida | Detalles completos del incidente, lo que incluye: ID, nombre, resumen, información del estado (ID y nombre), información de la severidad (ID y nombre), URL de llamada y marcas de tiempo |
Buscar incidentes
Use la acción Buscar incidentes para buscar incidentes en función de distintos criterios de filtro.
Esta acción tiene las siguientes entradas y salidas:
| Variables | |
|---|---|
| Entrada | Opcional: Status category, Severity, Incident
type, Created at (date range), Updated at (date range), After
cursor, Page size
Nota: Los filtros de intervalo de fechas deben usar el formato AAAA-MM-DD~AAAA-MM-DD. El tamaño de página puede ser de 1-250 incidentes.
|
| Salida | Matriz de incidentes con ID, nombre, resumen, información del estado (ID y nombre), información de la severidad (ID y nombre) y marca de tiempo de creación; también incluye el cursor de paginación. |