Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazioni
## AWS Servizi
### Simple Storage Service (Amazon S3)
Le azioni di Amazon S3 consentono di archiviare e recuperare file e dati.
**Azioni disponibili**
+ **Scarica file**: scarica un file da Amazon S3 e restituisce un handle di oggetto file.
+ **Carica file**: carica un handle di oggetto file su Amazon S3.
+ **Copia oggetto**: crea una copia di un oggetto già archiviato in Amazon S3 da un file di origine a una posizione di destinazione.
+ **Elimina oggetto**: elimina un oggetto specificato da un bucket S3.
+ **Elenca oggetti**: elenca tutti gli oggetti nel bucket specificato. Può essere filtrato utilizzando un prefisso.
### Amazon Bedrock
Le azioni di Amazon Bedrock ti consentono di connetterti ai modelli di base (FMs) delle principali aziende di intelligenza artificiale tramite un'unica API.
+ **Basic Model Converse**: invia un prompt a un modello di intelligenza artificiale. Usa il linguaggio naturale per generare testo, analizzare i contenuti e ottenere risposte basate sull'intelligenza artificiale.
+ **Modello avanzato Converse**: richiede un modello con più opzioni. Le opzioni avanzate includono formati di messaggi personalizzati, integrazioni di strumenti e controllo granulare sul comportamento del modello.
### Agent per Amazon Bedrock
Le azioni di Amazon Bedrock Agent ti consentono di richiamare assistenti AI in grado di connettersi alle tue fonti di dati e ai sistemi di APIs backend.
+ **Basic agent invoke**: invia una richiesta a un agente AI. Utilizzalo per interazioni semplici che non richiedono file allegati, input da parte dell'utente o configurazioni personalizzate.
+ **Advanced agent invoke**: chiama un agente con più opzioni. Utilizzato per interazioni avanzate che richiedono file allegati, input dell'utente o configurazioni personalizzate.
### Automazione dei dati Amazon Bedrock
Bedrock Data Automation (BDA) semplifica il processo di estrazione di informazioni preziose dai contenuti non strutturati utilizzando l'intelligenza artificiale generativa.
**Azioni disponibili**
+ **Invoke Data Automation Async**: elabora i dati con uno o più progetti di automazione dei dati. Avvia l'elaborazione asincrona dei dati e restituisce un ID di chiamata.
+ **Ottieni lo stato di automazione dei dati: ottiene dettagli sullo stato** di chiamata di automazione dei dati e sulla posizione di output.
### Amazon Textract
Amazon Textract ti aiuta ad aggiungere il rilevamento e l'analisi del testo dei documenti alle tue automazioni.
+ **Interrogazione di documenti di base**: estrae i dati in base alle domande. Ogni query contiene la domanda da porre e l'alias che si desidera associare. Textract fornisce la risposta testuale a ciascuna domanda e un punteggio di confidenza.
+ **Analisi di base dei documenti**: estrae i dati dai documenti. Rileva ed estrae automaticamente moduli (coppie chiave-valore), tabelle (dati strutturati) e testo preservando il layout del documento e le relazioni tra i dati.
### Amazon Comprehend
Amazon Comprehend è un servizio di elaborazione del linguaggio naturale (NLP) per ottenere informazioni dettagliate sui contenuti dei documenti. Aiuta ad analizzare il testo per estrarre frasi chiave, identificare i sentimenti e classificare i documenti.
**Azioni disponibili**
+ **Classify Document**: crea una richiesta di classificazione per analizzare un singolo documento in tempo reale utilizzando un endpoint modello personalizzato. Supporta l'immissione di testo o file di documenti (PDF, Word o immagini).
+ **Rileva le frasi chiave**: rileva le frasi nominali chiave presenti nel testo, identificando concetti e argomenti importanti all'interno del contenuto.
## Applicazioni esterne
### Microsoft Outlook
Le azioni di Microsoft Outlook consentono alle tue automazioni di gestire e-mail e calendari.
+ **E-mail**
+ **Invia e-mail utente**: invia un messaggio e-mail per conto di un utente specifico.
+ **Rispondi a un'e-mail**: rispondi al mittente di un messaggio.
+ **Elenca i messaggi della cartella**: archivia i messaggi in una cartella specifica della casella di posta dell'utente che ha effettuato l'accesso.
+ **Elenca i messaggi degli utenti: recupera** i messaggi nella casella di posta dell'utente che ha effettuato l'accesso (incluse le cartelle Deleted Items e Clutter).
+ **Visualizza e-mail**: recupera le proprietà e le relazioni di un oggetto messaggio specifico.
+ **Aggiorna e-mail**: aggiorna le proprietà di un oggetto messaggio.
+ **Elimina e-mail**: elimina un messaggio nella casella di posta dell'utente specificato.
+ **Elenca allegati e-mail**: recupera un elenco di oggetti allegati allegati a un messaggio.
+ **Ottieni allegato**: leggi le proprietà, le relazioni o il contenuto non elaborato di un allegato.
+ **Cartelle**
+ **Elenca cartelle di posta**: ottieni la raccolta di cartelle di posta direttamente nella cartella principale dell'utente che ha effettuato l'accesso.
+ **Sposta e-mail nella cartella**: sposta un messaggio in un'altra cartella all'interno della casella di posta dell'utente specificato.
+ **Ottieni le impostazioni della cassetta postale**: ottieni le impostazioni della cassetta postale dell'utente, come le risposte automatiche, il formato della data e il fuso orario.
+ **Calendario**
+ **Elenca eventi del calendario**: recupera un elenco di eventi del calendario per l'utente o la risorsa specificati da Microsoft Outlook.
+ **Crea evento del calendario**: crea un evento nel calendario predefinito dell'utente o nel calendario specificato.
+ **Aggiorna evento del calendario**: aggiorna le proprietà di un oggetto evento esistente.
+ **Other (Altro)**
+ **Elenca luoghi**: ottieni una raccolta di oggetti (stanze o elenchi di stanze) definiti nel tenant.
+ **Elenca utenti**: recupera un elenco di utenti dell'organizzazione da Microsoft Outlook con le relative informazioni di base.
+ **Elenca contatti**: recupera una raccolta di contatti dalla cartella dei contatti predefinita dell'utente che ha effettuato l'accesso.
### Microsoft Teams
Le azioni di Microsoft Teams consentono alle automazioni di comunicare con i membri del team tramite canali e messaggi di chat, oltre a gestire le riunioni.
+ **Messaggi**
+ **Elenca chat**: visualizza tutte le conversazioni in chat
+ **Crea chat**: avvia una nuova conversazione in chat
+ **Crea una chat individuale**: visualizza i dettagli di una chat specifica
+ **Elenca tutti i messaggi di chat** - Visualizza i messaggi in una conversazione di chat
+ **Invia messaggio di chat**: invia un nuovo messaggio in una chat
+ **Team**
+ **Elenca team**: visualizza tutti i team accessibili all'utente autenticato
+ **Get Team**: visualizza informazioni dettagliate su un team specifico
+ **Elenca tutti i membri del team**: visualizza i membri di un team
+ **Invita utente nel team**: aggiungi un nuovo membro a un team
+ **Canali**
+ **Elenca tutti i canali**: visualizza tutti i canali di un team specifico
+ **Crea canale**: crea un nuovo canale all'interno di un team
+ **Accedi al canale**: visualizza informazioni dettagliate su un canale specifico
+ **Elenca tutti i messaggi del canale**: visualizza i messaggi pubblicati in un canale
+ **Invia messaggio al canale**: pubblica un nuovo messaggio su un canale
+ **Rispondi al messaggio del canale**: aggiungi una risposta a un messaggio del canale esistente
+ **Invita un membro del canale**: aggiungi un membro a un canale specifico
+ **Riunioni**
+ **Crea una riunione di team online**: pianifica una nuova riunione online
+ **Richiedi una riunione online dei team**: visualizza i dettagli di una riunione specifica
+ **Elenca tutte le registrazioni** - Visualizza le registrazioni di una riunione
+ **Elenca tutte le trascrizioni - Visualizza le trascrizioni** di una riunione
+ **Utenti**
+ **Elenca utenti**: visualizza l'elenco degli utenti dell'organizzazione
### Microsoft SharePoint
Microsoft ti SharePoint consente di archiviare, gestire e condividere centralmente documenti e informazioni tramite le tue automazioni.
+ **Elenchi ed elementi**
+ **Ottieni elenco**: ottieni un elenco di operazioni associate a un elenco
+ **Crea elemento**: crea un nuovo elemento in un elenco
+ **Aggiorna elemento**: aggiorna le proprietà di un ListItem
+ **Elimina elemento**: rimuove un elemento da un elenco
+ **Ottieni elemento**: restituisce i metadati per un elemento in un elenco
+ **Elemento dell'elenco**: ottiene la raccolta di elementi in un elenco
+ **Fogli e file**
+ **Aggiungi foglio**: aggiungi un nuovo foglio di lavoro alla cartella di lavoro
+ **Elimina foglio: rimuove il foglio** di lavoro dalla cartella di lavoro
+ **Aggiorna foglio**: modifica le proprietà del foglio di lavoro (ridenominazione, visibilità)
+ **List Sheets** - Recupera un elenco di oggetti del foglio di lavoro
+ **Leggi il foglio**: recupera le proprietà di un foglio di lavoro
+ **Carica file**: crea o aggiorna un file di cartella di lavoro
+ **Intervalli e celle**
+ **Intervallo di lettura**: recupera i valori da un intervallo specificato
+ **Elimina intervallo**: elimina le celle in un intervallo specificato
+ **Write Range**: aggiorna i valori in un intervallo specificato
+ **Get Used Range**: restituisce l'intervallo utilizzato del foglio di lavoro specificato
+ **Clear Range**: cancella i valori dell'intervallo, inclusi formato, riempimento e bordo
+ **Read Cell**: ottiene il valore da una cella specifica
+ **Write Cell**: imposta il valore di una cella specifica
### Microsoft OneDrive
OneDrive Le azioni Microsoft consentono di archiviare, sincronizzare e condividere file. Puoi interagire direttamente con i file di Microsoft Excel salvati OneDrive per le azioni del foglio di calcolo.
+ **Gestione dei file**
+ **Ottieni elemento**: visualizza i dettagli di un file o di una cartella specifici
+ **Get Drive**: visualizza i dettagli OneDrive dell'account e le informazioni di archiviazione
+ **Elenca elementi**: visualizza tutti i file e le cartelle in un'unità
+ **Crea articolo/Crea cartella**: crea una nuova cartella o un nuovo elemento in OneDrive
+ **Elenca bambini**: visualizza gli elementi contenuti in una cartella specifica
+ **Elimina elemento**: rimuove un file o una cartella
+ **Aggiorna elemento/Sposta elemento**: aggiorna i metadati o sposta i file tra le cartelle
+ **Copia elemento**: crea una copia di un file o di una cartella in una posizione diversa
+ **Aggiungi autorizzazioni**: configura le autorizzazioni di condivisione e accesso per i file
+ **Carica file**: aggiungi nuovi file a OneDrive
+ **Excel**
+ **Aggiungi foglio**: crea un nuovo foglio di lavoro in una cartella di lavoro di Excel
+ **Cancella intervallo**: rimuove il contenuto e la formattazione da un intervallo di celle
+ **Elimina intervallo**: rimuove celle, righe o colonne da un foglio di lavoro
+ **Elimina foglio**: rimuove un foglio di lavoro da una cartella di lavoro
+ **Elenco fogli**: visualizza tutti i fogli di lavoro in una cartella di lavoro
+ **Leggi cella**: ottieni il valore di una cella specifica
+ **Intervallo di lettura**: ottieni valori da un intervallo di celle
+ **Leggi il foglio**: visualizza il contenuto di un intero foglio di lavoro
+ **Leggi l'intervallo utilizzato**: ottieni l'intervallo di celle che contengono dati
+ **Aggiorna foglio**: modifica le proprietà del foglio di lavoro
+ **Write Cell** - Imposta il valore di una cella specifica
+ **Write Range** - Imposta i valori per un intervallo di celle
### Salesforce
Le azioni di Salesforce ti consentono di automatizzare il processo di gestione delle relazioni con i clienti in base a casi, opportunità, lead, campagne, contatti e altro ancora.
+ **Casi**
+ **Ottieni l'elenco dei casi**: ottiene un elenco dei casi di assistenza clienti di Salesforce, inclusi i relativi metadati e gli articoli recenti.
+ **Get Case**: visualizza i dettagli di un caso specifico
+ **Create Case** - Crea un nuovo caso di supporto
+ **Elimina caso**: rimuove un caso esistente
+ **Aggiorna caso**: modifica i dettagli e le informazioni del caso
+ **Opportunità**
+ **Ottieni opportunità**: visualizza l'elenco delle opportunità di vendita
+ **Ottieni un'opportunità specifica**: visualizza i dettagli di un'opportunità specifica
+ **Crea opportunità**: crea una nuova opportunità di vendita
+ **Aggiorna opportunità**: modifica i dettagli dell'opportunità
+ **Elimina opportunità**: rimuove un'opportunità esistente
+ **Lead**
+ **Aggiorna lead**: modifica i dettagli e le informazioni sui lead
+ **Campagne**
+ **Aggiorna campagna**: modifica i dettagli e le informazioni della campagna
+ **Elementi del feed**
+ **Aggiorna elemento del feed**: modifica il contenuto e le proprietà degli elementi del feed
+ **Contatti**
+ **Ottieni l'elenco dei contatti**: visualizza tutti i contatti del sistema
+ **Get Contact** - Recupera i dettagli di un contatto specifico
+ **Aggiorna contatto**: modifica le informazioni di contatto
+ **Utenti**
+ **Ottieni l'elenco degli utenti**: recupera l'elenco degli utenti di Salesforce
+ **System (Sistema)**
+ **Descrivi SObject**: ottieni i metadati degli oggetti e i dettagli dei campi per qualsiasi tipo di oggetto Salesforce
### Jira
Le azioni di Jira ti consentono di automatizzare la gestione di problemi, progetti, sprint e altro ancora.
+ **Problemi**
+ **Crea problema**: crea un problema in un progetto.
+ **Modifica problema**: modifica un problema esistente in un progetto.
+ **Aggiorna lo stato del problema (Esegui transizione)**: modifica lo stato dell'attività di un problema.
+ **Elimina problema**: elimina un problema in un progetto.
+ Visualizza **problema**: visualizza i dettagli di un problema in un progetto.
+ **Problemi di ricerca**: cerca problemi utilizzando JQL
+ **Stati di ricerca: cerca gli** stati dei problemi.
+ **Scarica l'allegato del problema**: visualizza il contenuto di un allegato.
+ **Aggiungi allegato**: aggiungi un allegato a un problema.
+ **Ottieni tutte le etichette** - Visualizza tutte le etichette.
+ **Commenti**
+ **Aggiungi commento**: aggiungi un nuovo commento a un problema.
+ **Elimina commento**: rimuove il commento da un problema.
+ **Aggiorna commento**: modifica un commento esistente su un problema.
+ **Ottieni commenti**: visualizza i commenti sul problema.
+ **Progetti**
+ **Crea progetto**: crea un nuovo progetto in Jira.
+ **Aggiorna progetto**: modifica i dettagli del progetto.
+ **Elimina progetto**: rimuove il progetto da Jira.
+ **Get Project** - Visualizza i dettagli del progetto.
+ **Scarica i tipi di problemi per il progetto**: visualizza i tipi di problemi del progetto.
+ **Cerca progetti**: trova progetti visibili.
+ **Sprint**
+ **Crea Sprint**: crea uno sprint in un progetto.
+ **Aggiorna Sprint**: aggiorna i dettagli dello sprint.
+ **Elimina Sprint**: elimina uno sprint in un progetto.
+ **Get Sprint**: visualizza i dettagli di uno sprint in un progetto.
+ **Sposta i problemi in Sprint e Rank**: assegna un problema a uno sprint.
+ **Sposta i problemi nel backlog: sposta i problemi nel backlog**.
+ **Utenti**
+ **Trova utenti**: cerca un utente Jira.
+ **Trova utenti assegnabili**: restituisce un elenco di utenti che possono essere assegnati a un problema.
+ **Ottieni tutti gli utenti**: elenca tutti gli utenti di Jira.
### ServiceNow
ServiceNow le azioni consentono di automatizzare la gestione dei servizi IT di incidenti, richieste di modifica e altro ancora.
+ **Incidenti**
+ **Crea incidente**: crea un nuovo record di incidente.
+ **Leggi incidente**: recupera i dettagli di un incidente specifico.
+ **Aggiorna incidente**: modifica il record di un incidente esistente.
+ **Elimina incidente**: rimuove un record di incidente specifico.
+ **Richieste di modifica**
+ **Crea richiesta di modifica**: crea un nuovo record di richiesta di modifica.
+ **Leggi richiesta di modifica**: recupera i dettagli di una richiesta di modifica specifica.
+ **Aggiorna richiesta** di modifica: modifica un record di richiesta di modifica esistente.
+ **Elimina richiesta di modifica**: rimuove uno specifico record di richiesta di modifica.
+ **Articoli della Knowledge Base**
+ **Aggiorna articolo della Knowledge Base**: modifica un articolo della Knowledge Base esistente.
+ **Record dei problemi**
+ **Aggiorna record di problema**: modifica un record di problema esistente.
+ **Allegati**
+ **Carica allegato binario**: carica un file come allegato a un record specificato.
+ **Carica allegato al modulo in più parti: carica un allegato** al modulo in un record.
+ **Recupera il contenuto dell'allegato**: ottiene il contenuto binario di un allegato specifico.
+ **Recupera i metadati degli allegati**: ottiene i metadati per un allegato specifico.
+ **Elimina allegato**: rimuove un allegato dal sistema.
+ **Recupera metadati per gli allegati**: ottiene i metadati per più allegati.
+ **System (Sistema)**
+ **Elenca utenti**: recupera tutti i record esistenti dalla tabella degli utenti del sistema.
+ **List Choices** - Recupera i valori dell'elenco di scelte dal sistema.
### SAP
Le azioni SAP consentono di automatizzare i processi che coinvolgono i dati dei partner commerciali, le scorte di materiali, le distinte dei materiali, le descrizioni dei prodotti e l'inventario fisico.
+ **Partner commerciali SAP**
+ **Get Business Partner**: recupera i dati generali per i partner commerciali, fornendo una visione completa delle informazioni sui partner.
+ **Get Business Partner By ID**: recupera i dati dettagliati dei partner commerciali utilizzando un numero specifico di partner commerciale come identificatore.
+ **Ottieni l'indirizzo del partner commerciale**: recupera i dettagli degli indirizzi associati ai partner commerciali, inclusi gli indirizzi postali e le informazioni di contatto.
+ **Ottieni il ruolo del partner commerciale**: recupera le informazioni sul ruolo dei partner commerciali, mostrandone le relazioni e le funzioni all'interno del sistema.
+ **Ottieni il ruolo del partner commerciale per ID**: recupera i dati specifici sul ruolo di un partner commerciale utilizzando i campi identificativi chiave.
+ **Stock di materiali SAP**
+ **Ottieni le scorte di materiale in Account Model Collection**: ottiene i livelli delle scorte di materiale con dettagli come il lotto, la posizione di stoccaggio e indicatori speciali delle scorte.
+ **Distinta base SAP**
+ **Get Material BOM Item**: recupera i dettagli dei materiali utilizzati nelle distinte materiali, comprese quantità, categorie e relazioni.
+ **Master del prodotto SAP**
+ **Ottieni Product Master Records** - Visualizza i dettagli generali del prodotto. Restituisce le anagrafiche complete del prodotto con opzioni per filtrare, ordinare e selezionare dati specifici.
+ **Ottieni i dati di impianto del Product Master Record** - Visualizza i dettagli dell'impianto del prodotto. Accedi a informazioni dettagliate specifiche dell'impianto per un determinato prodotto, inclusi dati di produzione, stoccaggio e logistica.
+ **Ottieni i dati di pianificazione della fornitura per numero di prodotto e impianto**: visualizza i dettagli della pianificazione della fornitura per numero di prodotto e impianto. Recupera i parametri di pianificazione dettagliati, tra cui le dimensioni dei lotti, i livelli delle scorte di sicurezza e i dati di approvvigionamento.
+ **Inventario fisico SAP**
+ **Get Phys Inventory Doc Item**: recupera gli articoli del documento di inventario fisico, inclusi i risultati del conteggio e le differenze di inventario.
## Integrazione con l'API REST
L'integrazione della connessione all'API REST consente a Quick Automate di interagire con REST APIs e servizi web personalizzati, consentendo di estendere le funzionalità di automazione ai sistemi esterni. Questa integrazione supporta l'esecuzione di azioni per i metodi HTTP GET, POST, DELETE, PATCH e PUT.
**Casi d'uso comuni:**
+ Invio di notifiche a sistemi esterni
+ Recupero di dati da servizi di terze parti
+ Aggiornamento dei record in database esterni
+ Attivazione di flussi di lavoro nelle applicazioni connesse
**Prerequisiti**
Prima di creare automazioni con l'integrazione dell'API REST, assicurati di avere:
+ **Integrazione dell'API REST configurata**
+ Accedi alla console Quick Suite
+ Passa a Integrazioni > Connessione API REST
+ Configura il tuo endpoint dell'API REST con l'URL di base
+ Configurazione completa dell'autenticazione (vedi la sezione Autenticazione di seguito)
+ Dettagli completi: [Integrazione della connessione API REST](rest-api-integration.md)
+ **Integrazione connessa con Automation Group**
+ Collega l'integrazione dell'API REST configurata al tuo gruppo di automazione
+ Verifica che l'integrazione compaia nelle azioni disponibili
+ Step-by-step guida: [AWS connettori service action](builtin-services-integration.md)
+ **Autenticazione configurata**
+ OAuth Credenziali 2.0 ottenute dal tuo provider di API
### Autenticazione
Per Quick Automate, questa integrazione supporta l'autenticazione **OAuth 2.0**. È necessario configurare OAuth le credenziali prima di creare automazioni.
**OAuth 2.0 Fasi di configurazione:**
+ Ottieni OAuth le credenziali (Client ID e Client Secret) dal tuo provider di identità
+ Nella console Quick Suite, accedi alle impostazioni di integrazione dell'API REST
+ Seleziona OAuth 2.0 come metodo di autenticazione
+ Inserisci il tuo ID cliente e il segreto del cliente
+ Configura l'URL di autorizzazione e l'URL del token forniti dal tuo provider di API
+ Completa il OAuth flusso per autorizzare Quick Suite
+ Verifica la connessione per verificare l'autenticazione
**Note importanti:**
+ Quick Automate non supporta l'autenticazione con token al portatore nelle intestazioni delle richieste. Utilizzate invece la configurazione OAuth .
+ Configura l'autenticazione a livello di integrazione, non per azione di automazione
### Configurazione
**Configurazione dell'integrazione dell'API REST**
Fase 1: Creare una configurazione URL di base
Fase 2: Connect a Automation Group
Fase 3: Accedere alle azioni dell'API REST
+ Apri il pannello delle azioni nella tua automazione
+ Individua l'azione dell'API REST
+ Trascina e rilascia le azioni nel tuo flusso di lavoro di automazione
+
**Nota**
Le azioni dell'API REST devono essere aggiunte tramite il pannello Azioni; non sono disponibili nell'interfaccia Build with Assistant
### Riferimento alle proprietà
+ **ID Q Action Connector (obbligatorio)**
+ **Descrizione:** identificatore univoco che collega l'azione dell'API REST all'integrazione configurata, inclusi l'URL di base e le impostazioni di autenticazione.
+ **Formato:** compilato automaticamente dall'integrazione connessa
+ **Esempio**: `rest-api-connector-abc123`
+ **URI (opzionale)**
+ **Descrizione:** percorso aggiuntivo aggiunto all'URL di base per specificare l'endpoint API esatto.
+ **Formato:** stringa di percorso con o senza barra iniziale (dipende dal formato dell'URL di base)
+ **Come funziona:**
+ URL di base: `https://api.example.com`
+ URI: `/users/123`
+ URL finale: `https://api.example.com/users/123`
+ **Esempi:**
```
/users/123
prod/send-email
/v2/orders
customers/search
```
+ **Intestazioni aggiuntive (facoltative)**
+ **Descrizione:** intestazioni HTTP personalizzate da includere nella richiesta API come coppie chiave-valore.
+ **Formato:**
```
Key: Value
```
+ **Esempi comuni:**
```
Content-Type: application/json
Accept: application/json
X-Custom-Header: custom-value
X-API-Version: 2.0
```
+ **Limitazioni importanti:**
+ Non includono le intestazioni di autorizzazione; l'autenticazione viene gestita tramite configurazione OAuth
+ Ogni intestazione deve trovarsi su una riga separata
+ Le intestazioni fanno differenza tra maiuscole e minuscole
+ **Richiesta (obbligatorio)**
+ **Descrizione:** dati in formato JSON da inviare con richieste POST o PUT.
+ **Formato:** oggetto JSON valido. \$1\$1 per richieste vuote
+ **Esempio di richiesta POST (creazione di una risorsa):**
```
{
"title": "My New Post",
"body": "This is the content of my new post.",
"userId": 1,
"tags": ["automation", "api"],
"published": true
}
```
+ **Esempio di richiesta PUT (aggiornamento di una risorsa):**
```
{
"status": "completed",
"completedDate": "2026-01-27",
"notes": "Task finished successfully"
}
```
+ **Variabile di output (opzionale)**
+ **Descrizione:** nome della variabile per memorizzare la risposta JSON della chiamata API da utilizzare nelle successive azioni di automazione.
+ **Formato:** nome della variabile alfanumerico (senza spazi)
+ **Esempio:`apiResponse`,**, `userData` `orderDetails`
### Esempio di utilizzo dell'API
#### Esempio 1: Richiesta GET - Recupera i dettagli del ticket
**Scenario:** recupera i dettagli di un ticket di supporto esistente da un sistema di ticketing esterno
**Configurazione:**
+ **ID del connettore Q Action:** rest-api-connector-tickets
+ **Metodo HTTP:** GET
+ **URI: /tickets/** `ticketId`
+ **Intestazioni aggiuntive:**
```
Accept: application/json
```
+ **Corpo della richiesta:** \$1\$1 (vuoto per le richieste GET)
+ **Variabile di output:** TicketDetails
#### Esempio 2: Richiesta POST - Crea nuovo record
**Scenario:** invio di un nuovo ticket di assistenza a un sistema di ticketing esterno
**Configurazione:**
+ **ID del connettore Q Action:** rest-api-connector-tickets
+ **Metodo HTTP:** POST
+ **URI:** `/tickets`
+ **Intestazioni aggiuntive:**
```
Content-Type: application/json
Accept: application/json
```
+ **Corpo della richiesta:**
```
{
"title": "{{ticketTitle}}",
"description": "{{ticketDescription}}",
"priority": "{{ticketPriority}}",
"requestedBy": "{{userEmail}}",
"category": "technical_support"
}
```
+ **Variabile di uscita:** `ticketResponse`