Collegare Atera a servizi di terze parti e alle azioni di ticketing di Atera ti permette di automatizzare ancora di più i tuoi flussi di lavoro e ridurre il lavoro manuale per il tuo team. Puoi attivare diverse azioni su piattaforme esterne — oppure utilizzare le API di ticketing di Atera come escalation, risoluzione, elenco e recupero dei ticket — tutto direttamente da Atera, usando chiamate dinamiche e basate su parametri verso le API di ciascun servizio. In questo modo i tuoi sistemi restano sincronizzati, puoi trasmettere il contesto (come dettagli di dispositivo, sito, utente o ticket) in queste azioni e costruire processi più completi e integrati attorno al monitoraggio, all’automazione, a Robin e ai flussi di lavoro di ticketing.

Panoramica

Le cloud action definiscono come Atera comunica con servizi esterni e API di ticketing — quale endpoint API chiamare, quali parametri e header inviare e quali dati includere nel corpo della richiesta. Puoi combinare valori statici (come autenticazione e impostazioni fisse) con valori dinamici presi da ticket, dispositivi, utenti o input dell’utente, e persino lasciare che AI Copilot generi l’azione iniziale per te. Questo ti offre un modo flessibile per costruire e riutilizzare integrazioni come parte dei tuoi flussi di lavoro di monitoraggio, automazione, Robin e ticketing.

Le cloud action possono anche attivare azioni di ticketing di Atera, tra cui escalation dei ticket, risoluzione dei ticket, elenco dei ticket e recupero dei dettagli dei ticket. Questo permette ad AI Copilot e Robin di aiutare a far avanzare i flussi di lavoro dei ticket usando il giusto contesto al momento giusto.

Parametri

I parametri ti permettono di trasmettere dati aggiuntivi all’endpoint API, come filtri, località o identificativi di risorse. Possono essere aggiunti come parametri di query o di percorso, a seconda delle specifiche dell’API.

• Parametri statici: Usa parametri statici per valori che restano sempre uguali ogni volta che l’azione viene eseguita (ad esempio, un prefisso internazionale fisso, uno stato predefinito o una versione specifica dell’API). Questi vengono inseriti una sola volta e riutilizzati in ogni richiesta.
• Parametri dinamici: Usa parametri dinamici per valori che possono cambiare durante l’esecuzione e che devono provenire dall’utente o dal contesto (ad esempio, ID dispositivo, ID cliente, nome città o ID ticket). Definisci il nome del parametro e una descrizione, e AI Copilot e Robin chiederanno questi valori o li prenderanno dal contesto rilevante quando eseguiranno l’azione.

Questo ti permette di combinare valori predefiniti statici con valori dinamici per richiesta, così la stessa azione può essere riutilizzata per diversi clienti, tenant, sedi, risorse o ticket.

Header

Gli header ti permettono di trasmettere metadati aggiuntivi all’endpoint API, come autenticazione, tipo di contenuto o informazioni sul client. Ogni header ha un tipo (Predefinito o Segreto), una chiave e un valore. Quando selezioni 'Segreto', il valore viene nascosto e può essere visualizzato solo cliccando sull’icona dell’occhio.

• Header predefiniti: Usali per valori non sensibili che possono essere visualizzati in sicurezza, o per altri valori di configurazione fissi.
• Header segreti: Usali per valori sensibili come chiavi API, token o credenziali. Questi valori sono mascherati per proteggere le informazioni riservate, pur restando disponibili per la chiamata API durante l’esecuzione.

Gli header possono anche essere definiti come statici o dinamici, a seconda che i loro valori restino sempre uguali o cambino durante l’esecuzione in base all’input dell’utente o al contesto.

• Header statici: Usa header statici per valori che restano sempre uguali in ogni richiesta, come autenticazione e configurazioni fisse. (ad esempio, Authorization: ApiKey {{api_key}}). Una volta impostati, AI Copilot li include automaticamente in ogni richiesta così sa come autenticarsi e chiamare la giusta API senza chiedere nulla all’utente.
• Header dinamici: Usa header dinamici per valori che possono cambiare durante l’esecuzione e che devono provenire dall’utente o dal contesto (ad esempio, città, paese, ID tenant o ID ticket). Definisci la chiave dell’header e una descrizione, e AI Copilot chiederà questi valori o li ricaverà dal ticket, dispositivo o cliente corrente quando esegue l’azione.

Combinando header Predefiniti o Segreti con comportamento statico e dinamico, puoi riutilizzare in modo sicuro la stessa azione API per diversi clienti, sedi, risorse e flussi di lavoro di ticketing, mantenendo il flusso di lavoro flessibile e sicuro.

Corpo della richiesta

Aggiungi un corpo della richiesta (in formato JSON valido) se la tua azione deve inviare dati al servizio di destinazione o all’API di ticketing di Atera (ad esempio, per creare o aggiornare una risorsa o modificare un ticket). Per i valori dinamici, racchiudi i segnaposto tra parentesi graffe (ad esempio, {customer_id} o {ticket_id}).

Crea una cloud action

Quando crei una cloud action, definisci esattamente cosa deve succedere nel servizio esterno o all’interno di Atera (ad esempio, azioni di ticketing) — quale endpoint chiamare, quali dati inviare e quando deve essere eseguita. Questo ti dà un controllo preciso sulle integrazioni, così puoi adattare ogni azione ai tuoi strumenti, casi d’uso, flussi di lavoro di ticketing e requisiti di sicurezza.

Per creare una cloud action:

1. Vai su AI Center > Cloud actions.

2. Clicca su Nuova cloud action.

Apparirà la pagina Crea cloud action.

3. Inserisci il nome e la descrizione.

4. Attiva o disattiva Robin per permettergli di valutare i problemi segnalati dagli utenti ed eseguire questa cloud action quando necessario. 

5. Seleziona il metodo di richiesta HTTP (GET, POST, PUT, PATCH o DELETE). Poi inserisci l’URL completo dell’endpoint API che vuoi chiamare con questa cloud action.

6. Compila parametri, header e corpo come richiesto dal servizio di destinazione o dall’azione di ticketing di Atera:

• Parametri: Aggiungi eventuali parametri di query o di percorso richiesti dall’endpoint. Puoi anche usare valori dinamici racchiudendoli tra doppie parentesi graffe (ad esempio,  {{ticket_id}}).
• Header: Aggiungi eventuali header HTTP richiesti dall’API (segui il formato definito nella documentazione dell’API di riferimento).
• Corpo: Aggiungi un corpo della richiesta (in formato JSON valido) se la tua azione deve inviare dati al servizio di destinazione o all’API di ticketing di Atera. Per inserire valori dinamici, racchiudili tra doppie parentesi graffe (ad esempio, {{ticket_id}}).

Genera azioni con AI Copilot

Descrivi il tuo obiettivo in modo semplice e lascia che AI Copilot prepari la richiesta per te — URL, metodo, header e corpo, sia che si tratti di un servizio esterno che di un’azione di ticketing di Atera. Ti consigliamo di rivedere e perfezionare l’azione generata prima di abilitarla, così sarà perfettamente allineata alle tue esigenze e alle tue policy interne.

Per generare una cloud action con AI Copilot:

1. Clicca su Genera con AI Copilot.

Apparirà la finestra Genera cloud action con AI Copilot.

2. Descrivi il caso d’uso.

3. Inserisci il valore che il sistema di destinazione si aspetta nell’header Authorization per le sue chiamate API. Di solito si tratta di una chiave API o di un token. 

Nota: Se l’API non richiede autorizzazione, puoi lasciare questo campo vuoto.

4. Inserisci l’URL della documentazione dell’API.

5. Clicca su Genera azione.

L’azione apparirà nella pagina Cloud actions. 

6. Aprila, rivedi i dettagli creati da AI Copilot e apporta eventuali modifiche necessarie. Poi clicca su Salva. 

7. Imposta lo stato su Attivo.