Automated Request | PUT *

La chiamata di aggiornamento Ticket Automatizzato permette, indicando l'identificativo univoco del Ticket e i parametri dello stesso, di:

Aggiornare una Richiesta di Supporto (Ticket);

Richiede in ingresso:

Identificativo univoco Ticket;
I parametri relativi all'aggiornamento del Ticket;

Restituisce:

Il Ticket appena aggiornato;
Oppure, se non va a buon fine, la descrizione dell’errore riscontrato;

Parametri

Per quanto riguarda i parametri del body, avremo la seguente gestione:

Obbligatori, sempre aggiornati;
Opzionali, aggioranti solo se effettivamente valorizzati;

Chiave	Valore
Indirizzo Test	https://test-apiv2.smiletech.it/APIv2/Supports/AutomatedRequest/{idTicket}
Indirizzo Prod	https://apiv2.smiletech.it/APIv2/Supports/AutomatedRequest/{idTicket}
Metodo	PUT
Success Response	200 (Success)
Error Response	400 (Bad Request) 401 (Unauthorized) 500(Internal Server Error)

Di seguito la struttura dell’Header contenente:

Header

        {
            "authorization": "Bearer -indicare-qui-Token-fornito-"
        }
        

L' identificativo univoco va inserito come parametro nell’URL andando a sostituire {idTicket} all’interno dell’indirizzo.

Di seguito la struttura del body contenente i valori da inserire all’interno della richiesta:

Request body

{   
    "operatorEmail": "[string]{email univoca e identificativa dell'Operatore designato per l'appuntamento} OBBLIGATORIO",
    "dateAppointment": "[dateTime]{data/momento dell'appuntamento} OBBLIGATORIO",
    "problemDescription": "[string]{descrizione della problematica riscontrata dall’Utente}",
    "audioMessageLink": "[string][nullable]{link audio messaggio}",
}

Di seguito la struttura della response contenente i valori di ritorno dal sistema:

Response body

{
    "id": "[long]{identificativo univoco del Ticket}",
    "cardCode": "[string]{codice univoco della CardReleased di appartenenza}",
    "dateOpened": "[DateTime]{data di apertura del Ticket}",
    "dateAppointment": "[DateTime]{data appuntamento risoluzione, concordato con il cliente}",
    "dateClosed": "[DateTime]{data di risoluzione del Ticket}",
    "dateReplied": "[DateTime]{data di risposta da parte dell’operatore, al Ticket}",
    "title": "[string]{titolo della problematica riscontrata}",
    "problemDescription": "[string]{descrizione accurata della problematica riscontrata}",
    "replySolution": "[string]{risposta di risoluzione dell’operatore}",
    "feedback": "[string]{resoconto dell’esperienza dell’utente}",
    "feedbackValue": "[int][nullable]{valutazione (da 1 a 5) dell’esperienza dell’utente}",
    "isTaken": "[bool]{indica se il Ticket è stato preso in carico dall’Operatore}",
    "hasAppointment": "[bool]{indica se il Ticket ha un appuntamento di risoluzione fissato}",
    "isClosed": "[bool]{indica se il Ticket è chiuso (true) o aperto (false)}",
    "isResolved": "[bool]{indica se il Ticket è risolto (true) o meno (false)}"
}

Un esempio di chiamata con dati verosimili:

https://test-apiv2.smiletech.it/APIv2/Supports/AutomatedRequest/11782

Header

        {
            "authorization": "Bearer NTNv7j0TuYARvmNMmWXo6fKvM4o6nv/aUi9ryX38ZH+L1bkrnD1ObOQ8Jdav"
        }
        

Request body

{
    "operatorEmail": "operatore@smiletech.com",
    "dateAppointment": "2025-06-30T17:45:59.0300711",
    "problemDescription": "Non riesco ad avviare corretamente la console.",
    "audioMessageLink": "https://linkaudiomessaggio.com/1234"
}

In caso di Successo il sistema ritorna il seguente modello JSON:

Response body

{
    "id": 46789,
    "cardCode": "003E5E25E4484094",
    "dateOpened": "2025-06-30T17:45:59.0300711",
    "dateAppointment": "2025-07-01T12:30:59.0300711",
    "dateClosed": null,
    "dateReplied": null,
    "title": "Il computer è lento e ci impiega tanto a caricare",
    "problemDescription": "Non riesco ad avviare i programmi, il PC è troppo lento.",
    "replySolution": null,
    "feedback": null,
    "feedbackValue": null,
    "isTaken": true,
    "hasAppointment": true,
    "isClosed": false,
    "isResolved": false
}

In caso di Errore il sistema ritorna il seguente modello JSON:

Response

Status: 400 Bad Request

        {
            "error": "Ticket non trovato."
        }
        

Errori Riscontrabili

Di seguito la lista che indica gli errori che possono essere riscontrati:

Codice	Descrizione
400 (BadRequest)	I dati in ingresso non sono corretti o non sono correttamente formattati. Viene restituita la descrizione dell’errore nel dettaglio.
401 (Unauthorized)	Il codice Token fornito non è valido. L’autenticazione non è andata a buon fine.
500 (Internal Server Error)	Il server ha riscontrato un errore inaspettato, generalmente esula dal tipo di request e si verifica per problemi assoggettabili al sistema.

15 dicembre 2025