Die Verbindung von Atera mit Drittanbieterdiensten und Atera-Ticketaktionen ermöglicht es Ihnen, mehr Ihrer Arbeitsabläufe zu automatisieren und den manuellen Aufwand für Ihr Team zu reduzieren. Sie können verschiedene Aktionen auf externen Plattformen auslösen – oder Atera-Ticketing-APIs wie Eskalieren, Lösen, Auflisten und Abrufen von Tickets aktivieren – alles direkt aus Atera heraus, indem Sie dynamische, parameterbasierte Aufrufe an die jeweilige API des Dienstes senden. So bleiben Ihre Systeme synchron, Sie können Kontext (wie Geräte-, Standort-, Benutzer- oder Ticketdetails) an diese Aktionen übergeben und umfassendere End-to-End-Prozesse rund um Ihre Überwachungs-, Automatisierungs-, Robin- und Ticketing-Workflows aufbauen.

Überblick

Cloud-Aktionen definieren, wie Atera mit externen Diensten und Ticketing-APIs kommuniziert – welcher API-Endpunkt aufgerufen wird, welche Parameter und Header gesendet werden und welche Daten im Request-Body enthalten sein sollen. Sie können statische Werte (wie Authentifizierung und feste Einstellungen) mit dynamischen Werten kombinieren, die aus Tickets, Geräten, Benutzern oder Benutzereingaben stammen, und sogar den KI-Copilot die anfängliche Aktion für Sie generieren lassen. So erhalten Sie eine flexible Möglichkeit, Integrationen als Teil Ihrer Überwachungs-, Automatisierungs-, Robin- und Ticketing-Workflows zu erstellen und wiederzuverwenden.

Cloud-Aktionen können auch Atera-Ticketaktionen auslösen, darunter das Eskalieren, Lösen, Auflisten und Abrufen von Ticketdetails. So können KI-Copilot und Robin dabei helfen, Ticket-Workflows mit dem richtigen Kontext zum richtigen Zeitpunkt voranzutreiben.

Parameter

Parameter ermöglichen es Ihnen, zusätzliche Daten an den API-Endpunkt zu übergeben, wie Filter, Standorte oder Ressourcenkennungen. Sie können je nach API-Spezifikation als Query-Parameter oder Pfadparameter hinzugefügt werden.

• Statische Parameter: Verwenden Sie statische Parameter für Werte, die bei jedem Ausführen der Aktion gleich bleiben (z. B. ein fester Ländercode, ein Standardstatus oder eine bestimmte API-Version). Diese werden einmal eingegeben und bei jeder Anfrage wiederverwendet.
• Dynamische Parameter: Verwenden Sie dynamische Parameter für Werte, die sich zur Laufzeit ändern können und vom Benutzer oder aus dem Kontext stammen sollten (z. B. Geräte-ID, Kunden-ID, Stadtname oder Ticket-ID). Sie definieren den Parameternamen und eine Beschreibung, und KI-Copilot sowie Robin fordern diese Werte an oder ziehen sie aus dem relevanten Kontext, wenn die Aktion ausgeführt wird.

So können Sie statische Standardwerte mit dynamischen, anfragebasierten Werten kombinieren, sodass dieselbe Aktion bei verschiedenen Kunden, Mandanten, Standorten, Ressourcen oder Tickets wiederverwendet werden kann.

Header

Header ermöglichen es Ihnen, zusätzliche Metadaten an den API-Endpunkt zu übergeben, wie Authentifizierung, Content-Type oder Client-Informationen. Jeder Header hat einen Typ (Standard oder Geheim), einen Schlüssel und einen Wert. Wenn Sie „Geheim“ auswählen, wird der Wert ausgeblendet und kann nur durch Klicken auf das Augensymbol angezeigt werden.

• Standard-Header: Verwenden Sie diese für nicht sensible Werte, die sicher angezeigt werden können, oder andere feste Konfigurationswerte.
• Geheime Header: Verwenden Sie diese für sensible Werte wie API-Schlüssel, Tokens oder Zugangsdaten. Diese Werte werden maskiert, um vertrauliche Informationen zu schützen, stehen aber zur Laufzeit dem API-Aufruf zur Verfügung.

Header können ebenfalls als statisch oder dynamisch definiert werden, je nachdem, ob ihre Werte bei jedem Ausführen der Aktion gleich bleiben oder sich zur Laufzeit durch Benutzereingaben oder Kontext ändern.

• Statische Header: Verwenden Sie statische Header für Werte, die bei jeder Anfrage gleich bleiben, wie Authentifizierung und feste Konfiguration (z. B. Authorization: ApiKey {{api_key}}). Sobald Sie diese eingerichtet haben, fügt KI-Copilot sie automatisch jeder Anfrage hinzu, sodass er weiß, wie er sich authentifizieren und die richtige API aufrufen kann, ohne den Benutzer zu fragen.
• Dynamische Header: Verwenden Sie dynamische Header für Werte, die sich zur Laufzeit ändern können und vom Benutzer oder aus dem Kontext stammen sollten (z. B. Stadt, Land, Mandanten-ID oder Ticket-ID). Sie definieren den Header-Schlüssel und eine Beschreibung, und KI-Copilot fordert diese Werte an oder leitet sie aus dem aktuellen Ticket, Gerät oder Kunden ab, wenn die Aktion ausgeführt wird.

Durch die Kombination von Standard- oder geheimen Headern mit statischem und dynamischem Verhalten können Sie dieselbe API-Aktion sicher über verschiedene Kunden, Standorte, Ressourcen und Ticket-Workflows hinweg wiederverwenden und dabei den Workflow flexibel und sicher halten.

Request-Body

Fügen Sie einen Request-Body (im gültigen JSON-Format) hinzu, wenn Ihre Aktion Daten an den Zielservice oder die Atera-Ticketing-API senden muss (z. B. um eine Ressource zu erstellen oder zu aktualisieren oder ein Ticket zu bearbeiten). Für dynamische Werte setzen Sie die Platzhalter in geschweifte Klammern (z. B. {customer_id} oder {ticket_id}).

Eine Cloud-Aktion erstellen

Wenn Sie eine Cloud-Aktion erstellen, legen Sie genau fest, was im externen Dienst oder innerhalb von Atera passieren soll (z. B. Ticketaktionen) – welcher Endpunkt aufgerufen wird, welche Daten gesendet werden und wann sie ausgeführt werden soll. So haben Sie die volle Kontrolle über Integrationen und können jede Aktion auf Ihre spezifischen Tools, Anwendungsfälle, Ticket-Workflows und Sicherheitsanforderungen zuschneiden.

So erstellen Sie eine Cloud-Aktion:

1. Gehen Sie zu KI Center > Cloud-Aktionen.

2. Klicken Sie auf Neue Cloud-Aktion.

Die Seite Cloud-Aktion erstellen erscheint.

3. Geben Sie den Namen und die Beschreibung ein.

4. Schalten Sie Robin ein oder aus, damit er gemeldete Probleme bewerten und diese Cloud-Aktion bei Bedarf ausführen kann. 

5. Wählen Sie die HTTP-Anfragemethode (GET, POST, PUT, PATCH oder DELETE) aus. Geben Sie dann die vollständige URL des API-Endpunkts ein, den diese Cloud-Aktion aufrufen soll.

6. Füllen Sie die Parameter, Header und den Body entsprechend den Anforderungen des Zielservices oder der Atera-Ticketaktion aus:

• Parameter: Fügen Sie alle Query- oder Pfadparameter hinzu, die der Endpunkt erwartet. Sie können hier auch dynamische Werte verwenden, indem Sie sie in doppelte geschweifte Klammern setzen (z. B. {{ticket_id}}).
• Header: Fügen Sie alle HTTP-Header hinzu, die von der API benötigt werden (folgen Sie dem Format in der jeweiligen API-Dokumentation).
• Body: Fügen Sie einen Request-Body (im gültigen JSON-Format) hinzu, wenn Ihre Aktion Daten an den Zielservice oder die Atera-Ticketing-API senden muss. Um dynamische Werte einzufügen, setzen Sie sie in doppelte geschweifte Klammern (z. B. {{ticket_id}}).

Aktionen mit KI-Copilot generieren

Beschreiben Sie Ihr Ziel in einfachen Worten und lassen Sie den KI-Copilot die Anfrage für Sie entwerfen – URL, Methode, Header und Body, egal ob für einen externen Dienst oder eine Atera-Ticketaktion. Wir empfehlen, die generierte Aktion zu überprüfen und ggf. anzupassen, bevor Sie sie aktivieren, damit sie genau Ihren Anforderungen und internen Richtlinien entspricht.

So generieren Sie eine Cloud-Aktion mit KI-Copilot:

1. Klicken Sie auf Mit KI-Copilot generieren.

Das Fenster Cloud-Aktionen mit KI-Copilot generieren erscheint.

2. Beschreiben Sie den Anwendungsfall.

3. Geben Sie den Wert ein, den das Zielsystem im Authorization-Header für seine API-Aufrufe erwartet. Das ist in der Regel ein API-Schlüssel oder Token. 

Hinweis: Wenn die API keine Autorisierung benötigt, können Sie dieses Feld leer lassen.

4. Geben Sie die URL zur API-Dokumentation ein.

5. Klicken Sie auf Aktion generieren.

Die Aktion erscheint auf der Seite Cloud-Aktionen. 

6. Öffnen Sie die Aktion, überprüfen Sie die von KI-Copilot erstellten Details und nehmen Sie ggf. Anpassungen vor. Klicken Sie dann auf Speichern. 

7. Setzen Sie den Status auf Aktiv.