Résumé ◀▼
Vous pouvez connecter le créateur d’actions à incident.io pour automatiser la gestion des incidents dans vos workflows. Cela vous permet de créer, de mettre à jour et de rechercher des incidents directement à partir des workflows d’actions, et ainsi d’améliorer la collaboration et la résolution des incidents. Utilisez un compte de service dédié pour l’authentification et gérez les tokens API de manière sécurisée pour assurer le contrôle et la sécurité de votre intégration de gestion des incidents.
Incident.io est une plateforme de gestion des incidents qui aide les équipes à réagir et à résoudre les incidents rapidement. Avec le connecteur incident.io pour le créateur d’actions, vous pouvez créer et gérer des incidents, mettre les détails des incidents à jour, et récupérer les informations sur les incidents directement à partir de vos workflows d’actions Zendesk.
Connexion d’incident.io au créateur d’actions
Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.
- Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
- Toutes les intégrations demandent l’accès aux portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant d’autoriser l’accès au système externe.
- Quand vous gérez les identifiants pour les outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.
Pour générer un token API pour l’authentification
- Connectez-vous à votre compte incident.io.
- Allez à Settings.
- Allez à API tokens.
- Créez un nouveau token API avec les permissions nécessaires.
- Enregistrez le token API ou laissez la fenêtre ouverte pour pouvoir le copier et le coller dans Zendesk. Vous en aurez besoin pour connecter incident.io au créateur d’actions.
- Dans le Centre d’administration, cliquez sur Applications et intégrations (
) dans la barre latérale, puis sélectionnez Actions > Workflows d’actions. - Créez ou modifiez un workflow d’actions.
- Ouvrez la barre latérale.
- Sous Actions externes, cliquez sur incident.io.
- Cliquez sur Connexion.
- Suivez les invites d’incident.io pour vous authentifier et terminer la connexion.Remarque – Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
Une fois que vous vous êtes connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour incident.io.
Utilisation des actions incident.io dans les workflows d’actions
Vous pouvez utiliser les étapes d’actions incident.io pour rechercher des formulaires et des réponses aux enquêtes.
Création d’un nouvel incident
Utilisez l’actionCréer un incident pour créer un nouvel incident dans incident.io avec les détails spécifiés.
Cette action a les entrées et les sorties suivantes :
| Variables | |
|---|---|
| Entrées | Obligatoires : Nom, GravitéFacultatives :
Remarque – Les options de visibilité incluent Privé ou Publique (elle est publique par défaut). L’URL de l’appel peut être un lien vers un appel d’incident ou une passerelle comme Zoom ou Google Meet.
|
| Sortie | Détails de l’incident, notamment l’ID, le nom, le statut, la gravité et l’horodatage de création |
Mise à jour d’un incident
Utilisez l’action Mettre à jour l’incident pour mettre à jour les propriétés d’un incident existant dans incident.io.
Cette action a les entrées et les sorties suivantes :
| Variables | |
|---|---|
| Entrées | Obligatoires : Identifiant de l'incidentFacultatives :
Remarque – Les options de visibilité incluent Privé ou Publique (elle est publique par défaut). L’URL de l’appel peut être un lien vers un appel d’incident ou une passerelle comme Zoom ou Google Meet.
|
| Sortie | Détails de l’incident mis à jour, notamment l’ID, le nom, le statut, la gravité et l’horodatage de mise à jour |
Recherche d’un incident
Utilisez l’action Rechercher un incident pour récupérer des informations détaillées au sujet d’un incident spécifique par ID.
Cette action a les entrées et les sorties suivantes :
| Variables | |
|---|---|
| Entrées | Obligatoires : Identifiant de l'incident
|
| Sortie | Détails complets de l’incident, notamment l’ID, le nom, le résumé, les informations de statut (ID et nom), les informations de gravité (ID et nom), l’URL de l’appel et les horodatages |
Recherche d’incidents
Utilisez l’action Rechercher des incidents pour trouver des incidents en fonction de divers critères de filtres.
Cette action a les entrées et les sorties suivantes :
| Variables | |
|---|---|
| Entrées | Facultatives : Catégorie du statut, Gravité, Type d'incident, Création entre (plage de dates), Mise à jour entre (plage de dates), Après le curseur, Taille de la page
Remarque – Les filtres de plage de dates devraient utiliser le format AAAA-MM-JJ~AAAA-MM-JJ. La taille de page est 1-250 incidents.
|
| Sortie | Tableau des incidents avec l’ID, le nom, le résumé, les informations de statut (ID et nom), les informations de gravité (ID et nom) et l’horodatage de création (inclut aussi le curseur de pagination) |