Connecter Atera à des services tiers et aux actions de ticketing d’Atera vous permet d’automatiser davantage vos flux de travail et de réduire le travail manuel pour votre équipe. Vous pouvez déclencher différentes actions sur des plateformes externes — ou activer les API de ticketing d’Atera comme l’escalade, la résolution, la liste et la récupération de tickets — directement depuis Atera, en utilisant des appels dynamiques et paramétrés à l’API de chaque service. Cela permet de garder vos systèmes synchronisés, de transmettre le contexte (comme les détails de l’appareil, du site, de l’utilisateur ou du ticket) dans ces actions, et de construire des processus plus complets et intégrés autour de vos flux de surveillance, d’automatisation, de Robin et de ticketing.

Aperçu

Les actions cloud définissent comment Atera communique avec les services externes et les API de ticketing — quel point de terminaison API appeler, quels paramètres et en-têtes envoyer, et quelles données inclure dans le corps de la requête. Vous pouvez combiner des valeurs statiques (comme l’authentification et les paramètres fixes) avec des valeurs dynamiques extraites des tickets, appareils, utilisateurs ou saisies utilisateur, et même laisser l’IA Copilot générer l’action initiale pour vous. Cela vous offre une façon flexible de créer et de réutiliser des intégrations dans le cadre de vos flux de surveillance, d’automatisation, de Robin et de ticketing.

Les actions cloud peuvent aussi activer des actions de ticketing Atera, comme l’escalade, la résolution, la liste et la récupération de tickets. Cela permet à l’IA Copilot et à Robin de faire avancer les flux de tickets en utilisant le bon contexte au bon moment.

Paramètres

Les paramètres vous permettent de transmettre des données supplémentaires au point de terminaison API, comme des filtres, des emplacements ou des identifiants de ressources. Ils peuvent être ajoutés en tant que paramètres de requête ou de chemin, selon la spécification de l’API.

• Paramètres statiques : Utilisez des paramètres statiques pour les valeurs qui restent identiques à chaque exécution de l’action (par exemple, un code pays fixe, un statut par défaut ou une version spécifique de l’API). Ils sont saisis une fois et réutilisés à chaque requête.
• Paramètres dynamiques : Utilisez des paramètres dynamiques pour les valeurs susceptibles de changer à l’exécution et qui doivent provenir de l’utilisateur ou du contexte (par exemple, ID d’appareil, ID client, nom de ville ou ID de ticket). Vous définissez le nom du paramètre et une description, et l’IA Copilot et Robin demanderont ces valeurs ou les récupéreront dans le contexte approprié lors de l’exécution de l’action.

Cela vous permet de combiner des valeurs par défaut statiques avec des valeurs dynamiques par requête, afin que la même action puisse être réutilisée pour différents clients, locataires, emplacements, ressources ou tickets.

En-têtes

Les en-têtes vous permettent de transmettre des métadonnées supplémentaires au point de terminaison API, comme l’authentification, le type de contenu ou des informations sur le client. Chaque en-tête a un type (Défaut ou Secret), une clé et une valeur. Lorsque vous sélectionnez « Secret », la valeur est masquée et ne peut être révélée qu’en cliquant sur l’icône en forme d’œil.

• En-têtes par défaut : À utiliser pour les valeurs non sensibles qui peuvent être affichées sans risque, ou pour d’autres valeurs de configuration fixes.
• En-têtes secrets : À utiliser pour les valeurs sensibles comme les clés API, tokens ou identifiants. Ces valeurs sont masquées pour protéger les informations confidentielles tout en restant disponibles pour l’appel API lors de l’exécution.

Les en-têtes peuvent aussi être définis comme statiques ou dynamiques, selon que leurs valeurs restent identiques à chaque exécution de l’action ou changent à l’exécution selon la saisie utilisateur ou le contexte.

• En-têtes statiques : Utilisez des en-têtes statiques pour les valeurs qui restent identiques à chaque requête, comme l’authentification et la configuration fixe. (par exemple, Authorization: ApiKey {{api_key}}). Une fois configurés, l’IA Copilot les inclut automatiquement dans chaque requête pour savoir comment s’authentifier et appeler la bonne API sans demander à l’utilisateur.
• En-têtes dynamiques : Utilisez des en-têtes dynamiques pour les valeurs susceptibles de changer à l’exécution et qui doivent provenir de l’utilisateur ou du contexte (par exemple, ville, pays, ID locataire ou ID ticket). Vous définissez la clé de l’en-tête et une description, et l’IA Copilot demandera ces valeurs ou les déduira du ticket, de l’appareil ou du client en cours lors de l’exécution de l’action.

En combinant des en-têtes par défaut ou secrets avec un comportement statique ou dynamique, vous pouvez réutiliser en toute sécurité la même action API pour différents clients, emplacements, ressources et flux de tickets tout en gardant le flux flexible et sécurisé.

Corps de la requête

Ajoutez un corps de requête (au format JSON valide) si votre action doit envoyer des données au service cible ou à l’API de ticketing d’Atera (par exemple, créer ou mettre à jour une ressource ou modifier un ticket). Pour les valeurs dynamiques, entourez les espaces réservés avec des accolades (par exemple, {customer_id} ou {ticket_id}).

Créer une action cloud

Lorsque vous créez une action cloud, vous définissez exactement ce qui doit se passer dans le service externe ou dans Atera (par exemple, des actions de ticketing) — quel point de terminaison appeler, quelles données envoyer et quand elle doit s’exécuter. Cela vous donne un contrôle précis sur les intégrations, afin que vous puissiez adapter chaque action à vos outils, cas d’usage, flux de tickets et exigences de sécurité.

Pour créer une action cloud :

1. Allez dans Centre IA > Actions cloud.

2. Cliquez sur Nouvelle action cloud.

La page Créer une action cloud s’affiche.

3. Saisissez le nom et la description.

4. Activez ou désactivez Robin pour lui permettre d’évaluer les problèmes signalés par les utilisateurs et d’exécuter cette action cloud si besoin. 

5. Sélectionnez la méthode de requête HTTP (GET, POST, PUT, PATCH ou DELETE). Puis saisissez l’URL complète du point de terminaison API que vous souhaitez appeler avec cette action cloud.

6. Renseignez les paramètres, en-têtes et le corps selon les exigences du service cible ou de l’action de ticketing Atera :

• Paramètres : Ajoutez tous les paramètres de requête ou de chemin attendus par le point de terminaison. Vous pouvez aussi utiliser ici des valeurs dynamiques en les entourant de doubles accolades (par exemple, {{ticket_id}}).
• En-têtes : Ajoutez tous les en-têtes HTTP requis par l’API (suivez le format défini dans la documentation de l’API concernée).
• Corps : Ajoutez un corps de requête (au format JSON valide) si votre action doit envoyer des données au service cible ou à l’API de ticketing d’Atera. Pour insérer des valeurs dynamiques, entourez-les de doubles accolades (par exemple, {{ticket_id}}).

Générer des actions avec l’IA Copilot

Décrivez votre objectif en langage simple et laissez l’IA Copilot rédiger la requête pour vous — URL, méthode, en-têtes et corps, que ce soit pour un service externe ou une action de ticketing Atera. Nous vous recommandons de relire et d’ajuster l’action générée avant de l’activer, afin qu’elle corresponde exactement à votre intention et à vos politiques internes.

Pour générer une action cloud avec l’IA Copilot :

1. Cliquez sur Générer avec l’IA Copilot.

La fenêtre Générer des actions cloud avec l’IA Copilot s’affiche.

2. Décrivez le cas d’usage.

3. Saisissez la valeur attendue par le système cible dans l’en-tête Authorization pour ses appels API. Il s’agit généralement d’une clé API ou d’un token. 

Remarque : Si l’API ne nécessite pas d’autorisation, vous pouvez laisser ce champ vide.

4. Saisissez l’URL de la documentation de l’API.

5. Cliquez sur Générer l’action.

L’action apparaîtra sur la page Actions cloud. 

6. Ouvrez-la, vérifiez les détails créés par l’IA Copilot et apportez les modifications nécessaires. Puis cliquez sur Enregistrer. 

7. Passez le statut à Actif.