Send Support Feedback

La chiamata di Invio Feedback Supporto permette, indicandone i parametri relativi, di:

Aggiornare una Richiesta di Supporto (Ticket), per la Card indicata, impostando la valutazione di resoconto dell’Utente finale (il valore del feedback può corrispondere a –1,1,2,3,4,5); - Se l’utente non lascia un feedback il valore corrispondente è -1;

Richiede in ingresso:

I parametri relativi alla valutazione del Ticket;
Restituisce:
Il Ticket appena aggiornato;
Oppure, se non va a buon fine, la descrizione dell’errore riscontrato;

Chiave	Valore
Indirizzo Test	https://test-apiv2.smiletech.it/APIv2/Supports/SendSupportFeedback
Indirizzo Prod	https://apiv2.smiletech.it/APIv2/Supports/SendSupportFeedback
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-"
        }
        

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

Request body

{
    "id": "[string]{identificativo univoco del Ticket} OBBLIGATORIO", 
    "feedbackValue": [int]{identificativo univoco della Domanda selezionata} OBBLIGATORIO,
    "feedback": "[array[object{}]]{da lasciare nullo}"
}

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

Response body

{ 
    "ticket": 
    { 
        "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/SendSupportFeedback

Header

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

Request body

{
    "id": "46766", 
    "feedbackValue": 5, 
    "feedback": "Problema risolto. Assistenza funzionale e cordiale."
}

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

Response body

{ 
    "ticket": 
    { 
        "id": 46789, 
        "cardCode": "003E5E25E4484094", 
        "dateOpened": "2023-06-30T17:45:59.0300711", 
        "dateAppointment": "2023-07-01T15:45:59.0300711", 
        "dateClosed": "2023-07-01T17:45:59.0300711", 
        "dateReplied": "2023-07-01T15:31:59.0300711", 
        "title": "Il computer è lento e ci impiega tanto a caricare", 
        "problemDescription": "Non riesco ad avviare i programmi, il PC è troppo lento.", 
        "replySolution": "Abbiamo pulito cache, registro e deframmentato il disco.", 
        "feedback": "Problema risolto. Assistenza funzionale e cordiale.",
        "feedbackValue": 5,
        "isTaken": true, 
        "hasAppointment": true, 
        "isClosed": true, 
        "isResolved": true
    }
}

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

Response

Status: 400 Bad Request

        {
            "error": "Ticket non trovato per l'identificativo fornito."
        }
        

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.

17 novembre 2025