Beam Help — supporto esperto indipendente per Zoho. Questo articolo mostra modi pratici per recuperare prodotti all'interno di Zoho Desk in modo che gli agenti o gli script client possano visualizzare i record dei prodotti per ticket o widget[8][7].
Perché è importante
Gli agenti devono spesso collegare un prodotto a un ticket in modo che la cronologia del supporto e il contesto degli asset viaggino con la conversazione[8]. Sviluppatori e amministratori che creano widget lato client potrebbero dover recuperare elenchi di prodotti (ad esempio, per categoria) e restituire gli elementi selezionati al chiamante[7].
Guida passo passo
- Apri il modulo Prodotti in Zoho Desk per visualizzare i prodotti dell'azienda. I prodotti sono gestiti a livello di organizzazione e sono disponibili agli agenti per associarli ai ticket[8].[8]
- Utilizza i campi prodotto su un ticket per collegare un articolo. Le voci del modulo Prodotti possono essere associate ai ticket in modo che gli agenti registrino di quale prodotto tratta un ticket[8].[8]
- Quando hai bisogno di un selettore personalizzato o di un elenco filtrato, crea un widget che interroghi il modulo Prodotti. I widget possono recuperare prodotti in base a una Categoria Prodotto selezionata e visualizzare i risultati all'interno dell'interfaccia utente del widget per la selezione[7].[7]
- Prepara il codice del widget per acquisire e restituire le selezioni allo script client. Nell'esempio del widget, i prodotti recuperati vengono archiviati in una variabile (searchresponse), visualizzati nell'HTML del widget e gli elementi selezionati vengono raccolti in un array prima di essere restituiti con $Client.close(selectedproducts)[7].[7]
- Carica lo zip del widget e crealo da Setup > Developer Space > Widgets. Vai su Setup, apri Developer Space, scegli Widgets e fai clic su Crea nuovo widget per caricare l'app HTML pacchettizzata[7].[7]
- Imposta l'hosting del widget su Zoho e specifica la pagina di ingresso HTML; scegli il tipo di pulsante per il rendering dello script client. Il flusso di creazione di un nuovo widget richiede che Hosting sia impostato su "Zoho", il nome della pagina che hai caricato e il widget dovrebbe utilizzare il tipo "button" quando prevedi di avviarlo da uno script client[7].[7]
- Chiama il widget dal tuo script client e ricevi i prodotti selezionati. L'esempio del widget termina chiamando $Client.close(selected_products) per passare i prodotti scelti allo script client e chiudere la finestra del widget[7].[7]
- Verifica la disponibilità del prodotto e l'accesso degli agenti nelle Impostazioni Aziendali se gli articoli non compaiono. La configurazione del prodotto a livello aziendale e i controlli di associazione si trovano nelle Impostazioni Aziendali di Desk sotto Aggiunta e Associazione di Prodotti ai Ticket, il che influisce su come i prodotti sono disponibili per gli agenti[8].[8]
Errori comuni
- Se il tuo widget restituisce un elenco vuoto, conferma la logica di filtraggio della categoria prodotto nel widget anziché presumere che Desk abbia bloccato la query; l'esempio memorizza i risultati in una variabile search_response prima del rendering[7].[7]
- Se gli agenti non riescono a collegare i prodotti ai ticket, verifica che i prodotti esistano nell'elenco prodotti dell'azienda e che le impostazioni della tua organizzazione espongano i prodotti agli agenti come previsto[8].[8]
Cosa controllare
- Conferma che il prodotto appaia nel tuo elenco Prodotti Aziendali di Zoho Desk e sia configurato per l'uso con i ticket[8].[8]
- Se utilizzi un widget, verifica che il tuo widget sia caricato tramite Setup > Developer Space > Widgets, che l'hosting sia impostato su Zoho e che il tipo di widget sia "button" quando invocato da uno script client[7].[7]
- Assicurati che il tuo widget restituisca le selezioni utilizzando $Client.close(selected_products) in modo che lo script client riceva gli oggetti prodotto scelti[7].[7]