Creazione app ti consente di creare app Zendesk che estendono Zendesk per adattarle ai workflow del servizio clienti e dipendenti. Invece di una costosa assistenza per gli sviluppatori o di lunghe attese per le nuove funzionalità del prodotto, puoi creare rapidamente le soluzioni necessarie per assistenza processi specializzati, proprio quando ne hai bisogno.
Creazione app ti consente di creare queste app usando l’elaborazione del linguaggio naturale (NLP) e AI generativa. Con la PNL, puoi fornire istruzioni in un linguaggio semplice, in modo simile a come potresti spiegare le tue idee a un collega o ad un amico. Intelligenza artificiale generativa interpreta questi prompt e genera il codice, l’interfaccia utente e le funzionalità necessari. Con AI generativa, creare app è facile come descriverle, eliminando la curva di apprendimento associata alla codifica tradizionale.
Ecco alcuni dei principali vantaggi di Creazione app:
- Prototipazione accelerata: La generazione di codice funzionale da prompt in linguaggio semplice consente di passare rapidamente dall’ideazione al prototipo funzionante.
- Anteprima visiva in tempo reale: Visualizza istantaneamente l’aspetto e il comportamento della tua app durante la creazione, semplificando la convalida del design e delle funzionalità.
- Controllo versione integrato: Ogni modifica apportata viene automaticamente modificata. Traccia facilmente le modifiche, ripristina le versioni precedenti e confronta le differenze.
- Ambiente di test end-to-end: Prova la tua app con dati Zendesk reali e risposte API in un ambiente sicuro prima della distribuzione. Qualsiasi modifica apportata durante il test si rifletterà nel tuo account effettivo.
- Competenze AI specifiche di Zendesk: Genera app usando i framework e le API Zendesk e le best practice di progettazione e risolvi automaticamente i problemi più comuni specifici di Zendesk.
- Integrazione dei dati: Crea app che si collegano e funzionano con i dati di Zendesk, dei sistemi interni della tua azienda e delle piattaforme di terzi più diffuse come Google, Jira e altri.
- Lavoro salvato e sincronizzato ovunque: Il tuo lavoro viene salvato in modo sicuro e aggiornato su tutte le sessioni, i browser e i dispositivi.
- Interfaccia globale e localizzata: Creazione app e tutti i relativi menu, prompt e indicazioni sono completamente traducibili. L’interfaccia viene visualizzata nella lingua scelta in cui sono disponibili le traduzioni e supporta automaticamente i layout da destra a sinistra (RTL) e i formati specifici per regione.
Le app create da Creazione app sono progettate con i componenti Zendesk Garden , le API ZAF e le API REST.
Questo articolo include le seguenti sezioni:
- Panoramica di Creazione app (video)
- Per cominciare
- Esempio: Creazione di un’app di monitoraggio delle modifiche assegnatario
- Esplorazione della scheda del codice e delle impostazioni dell’app
- Installazione e gestione delle app
- Integrazione con sistemi privati e piattaforme di terzi
- Risoluzione dei problemi
- Limitazioni
Panoramica di Creazione app (video)
Oltre ai dettagli in questo articolo, questo video offre una panoramica visiva di Creazione app per aiutarti a iniziare.
Per cominciare
Ogni app inizia come una conversazione: uno scambio guidato e continuo nel riquadro della conversazione in cui descrivi i tuoi requisiti, esamini le soluzioni suggerite, perfezioni l’app e risolvi i problemi in base alle esigenze. Queste conversazioni fungono da discussioni tra te e Creazione app, registrando tutte le richieste, le risposte e le iterazioni.
Puoi avere più conversazioni contemporaneamente per esplorare idee o prototipi diversi. Non tutte le conversazioni portano a un’app pubblicata. A volte sperimenti, impari o decidi di non procedere.
Le app sono i risultati tangibili che crei e installi da conversazioni riuscite. Un’app è la soluzione funzionante che puoi creare, testare, pubblicare e gestire in Zendesk. Una volta pubblicata, gli agenti e gli amministratori possono usare l’app nel proprio workflow. Un’app può essere generata da una singola conversazione o da più round o dopo diversi cicli di perfezionamento.
Le conversazioni e le app vengono monitorate separatamente in Creazione app.
Creazione app usa la NLP e AI generativa per interpretare le richieste degli utenti e convertirle in app funzionali. Per assicurarti di ottenere i migliori risultati da Creazione app, è importante seguire linee guida specifiche durante la creazione dei prompt. Per le best practice, consulta Linee guida per la richiesta di creazione app.
- Crea una funzione semplice e continua a perfezionare l’app aggiungendo ulteriori prompt che offrono più contesto e requisiti dettagliati. Suddividendo il processo di sviluppo in più segmenti, puoi risolvere e risolvere più facilmente i problemi in parti specifiche dell’app prima di introdurre ulteriore complessità.
- Se l’app creata non funziona, chiedi AI di aggiungere la registrazione.
- Leggi la risposta dell’intelligenza artificiale per assicurarti che comprenda ciò che stai chiedendo di creare.
- Esegui test approfonditi dell’app prima di pubblicarla.
- Se riscontri un errore durante il test dell’app, copia e incolla il messaggio di errore nel prompt. Ciò consente a Creazione app di analizzare il problema e aiutarti a risolverlo.
- Se qualcosa non funziona come previsto, fornisci spiegazioni dettagliate su ciò che ti aspetti, quali parti funzionano correttamente e quali no. Evita di dire semplicemente che non funziona.
- Affronta il processo con pazienza per capire meglio come funziona l’ AI e quali passaggi intraprendere se non stai ottenendo i risultati desiderati.
Creazione della prima app
Nel Centro amministrativo, fai clic su 
App e integrazioni nella barra laterale, quindi seleziona App > Creazione app. Per usare Creazione app, devi essere un amministratore Zendesk.
Se non hai ancora creato un’app, l’apertura di Creazione app porta a una pagina di benvenuto. Fai clic su Inizia una conversazione per iniziare il processo di creazione dell’app.
Gli utenti di ritorno vengono visualizzati nella pagina di un elenco di conversazioni per un rapido accesso alle conversazioni esistenti. Le conversazioni sono ordinate in base agli aggiornamenti più recenti.
- Barra laterale ticket: Appare accanto ai dettagli di ciascun ticket in Zendesk Support (impostazione predefinita). Seleziona questa posizione per visualizzare informazioni, azioni o integrazioni specifiche dei ticket. La barra laterale dei ticket si applica ai ticket esistenti e, facoltativamente, ai nuovi ticket.
- Nuova barra laterale ticket: Visibile quando un agente sta creando un nuovo ticket. Questa posizione è utile per le soluzioni che aiutano nella creazione di ticket, nei modelli, nell’arricchimento dei dati o nella convalida.
- Navigazione principale: La barra superiore dell’interfaccia di Zendesk è sempre accessibile, indipendentemente dal ticket o dalla schermata. Seleziona questa opzione per strumenti globali come hub di notifica o azioni rapide.
- Navigazione laterale: Situata nella parte inferiore del pannello di navigazione a sinistra di Zendesk Support, quest’area è ideale per le app complesse o autonome che richiedono spazio aggiuntivo, come dashboard o report.
Dopo aver selezionato la posizione dell’app, entrerai nella finestra di conversazione. Usa uno dei prompt di esempio forniti oppure inserisci i requisiti dell’app e fai clic su Invia.
Approvazione del piano proposto AI
Dopo aver inserito la richiesta iniziale, AI di Creazione app genera e presenta un piano consigliato per la tua app. Puoi rivedere il piano, approvarlo così com’è, rimuovere elementi non necessari o incorporare funzionalità suggerite aggiuntive. Questo approccio offre un modo rapido e flessibile per personalizzare l’app in base alle tue esigenze.
Nella schermata “Approva il piano”, vedrai un riepilogo delle funzionalità proposte per l’app, oltre alle funzionalità principali e facoltative. Seleziona o deseleziona le caselle accanto a ciascuna funzione in base alle tue preferenze. Puoi continuare ad apportare modifiche in un secondo momento, quindi non preoccuparti se non sei sicuro ora. Ecco un esempio:
Nella parte inferiore della schermata di pianificazione, hai due scelte:
- Continua a pianificare: Perfeziona ulteriormente il piano proposto aggiungendo nuovi requisiti o apportando ulteriori modifiche.
- Approva piano e build: Conferma le funzioni selezionate e consenti a Creazione app di generare l’app in base al piano approvato.
Perfezionamento e test dell’app
Dopo che l’ AI ha generato il tuo piano approvato, Creazione app ti consente di perfezionare, visualizzare in anteprima, testare e pubblicare l’app direttamente nel tuo account Zendesk.
- Anteprima: Fai clic su Anteprima per visualizzare l’app appena generata nella scheda Anteprima, che usa dati fittizi per dare un primo sguardo sicuro al layout, al flusso di dati e agli elementi interattivi. Ciò non garantisce che l’app funzioni come previsto una volta pubblicata. Prima della pubblicazione, dovresti testare l’app (vedi sotto) con dati reali dell’account.
Usa la scheda Codice per rivedere i file, le cartelle e i componenti delle app e la scheda Impostazioni per rivedere e aggiornare il nome e il logo dell’app.
- Perfeziona e ripeti: Perfeziona e aggiorna l’app in qualsiasi momento inserendo nuovi prompt nel riquadro delle conversazioni. Ogni modifica viene salvata, consentendoti di sperimentare liberamente e di tornare a una versione precedente quando necessario. Ogni modifica viene automaticamente modificata.
- Ripristina: Ogni modifica viene salvata automaticamente come nuova versione, consentendoti di tornare a qualsiasi versione precedente in qualsiasi momento, indipendentemente dal fatto che tu stia sperimentando, correggendo un errore o riconsiderando il tuo approccio.
- Prova: Fai clic su Prova per eseguire l’app in Zendesk Support usando dati reali dell’account. Qui puoi verificare se l’app visualizza, legge e scrive i dati come previsto e se funziona in scenari reali. Nota: Qualsiasi aggiornamento o modifica apportata durante il test dell’app viene applicato ai dati effettivi dell’account.
- Risoluzione dei problemi: Se qualcosa non funziona, usa i messaggi di errore e i registri leggibili dell’app per identificare i problemi. Incolla i dettagli dell’errore nella richiesta di assistenza mirata oppure chiedi a Creazione app di aggiungere l’output di debug.
- Impostazioni app: Personalizza l’app inserendo un nome personalizzato e selezionando un’icona e un colore di sfondo dalla libreria di icone Garden nella scheda Impostazioni.
- Pubblica e gestisci l’app: Quando sei completamente soddisfatto, fai clic su Pubblica per rendere l’app disponibile agli amministratori o agli agenti Zendesk.
Esempio: Creazione di un’app di monitoraggio delle modifiche assegnatario
Ecco un esempio di creazione di un’app per tenere traccia delle modifiche negli assegnatari dei ticket.
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona App > Creazione app.
- Fai clic su Inizia una conversazione.
- Seleziona la barra laterale Ticket e fai clic su Seleziona ubicazione.
- Quando richiesto, inserisci “Missione: Questa app aiuta a fornire una visione molto rapida delle modifiche degli assegnatari invece di dover esaminare la cronologia degli eventi dei ticket, cercare tutti gli eventi di modifica degli assegnatari e tenerne traccia. E questa è spesso una domanda per le persone "ok, dov'è il trasferimento nella catena di custodia di questi ticket". Azione: Crea un’app denominata Assegnatario Change Tracker che tiene traccia della cronologia delle modifiche apportate a un assegnatario in un determinato ticket. Parti: Una tabella dovrebbe elencare ogni volta che l’assegnatario di un ticket cambia, in ordine dal più recente al meno recente. Ogni riga deve includere il nome dell’assegnatario, la data di assegnazione e il periodo di assegnazione al ticket. Sopra la tabella, visualizza il numero totale di modifiche nell’assegnazione del ticket. Aggiungi un pulsante per aggiornare i dati visualizzati in modo che riflettano le ultime modifiche. Aggiungi un altro pulsante per esportare i dati in un foglio di calcolo Excel. Rendi entrambi i pulsanti piccoli e uno accanto all’altro. Ambito: Questa app è solo per il ticket corrente.
- Usa le opzioni di piano predefinite e fai clic su Approva piano e build.
- Fai clic su Invia.
App Builder risponde con qualcosa di simile a questo:
- Esamina l’anteprima per vedere l’aspetto e il comportamento della tua app e controlla la richiesta di risposta dell’intelligenza artificiale per comprendere le istruzioni sottostanti. Fai clic sulla scheda Codice per visualizzare i file contenenti il codice generato e i dati fittizi usati per compilare l’anteprima.
- Quando richiesto, inserisci “Aggiungi assegnatario precedente come prima colonna della tabella per acquisire il nome completo della persona a cui era stato assegnato il ticket in precedenza. Aggiungi anche suggerimenti a entrambi i pulsanti che visualizzano una breve descrizione della funzione di ciascun pulsante quando ci si posiziona sopra il cursore del mouse.
- Fai clic su Invia.
App Builder risponde con qualcosa di simile a questo:
- Fai clic su Prova per testare l’app usando i tuoi dati Zendesk. Durante il test, qualsiasi modifica apportata influirà sul tuo account effettivo, quindi esamina attentamente l’impatto delle tue azioni. Valuta anche la possibilità di personalizzare l’aspetto dell’app nella scheda Impostazioni. Ad esempio, aggiorna il colore e l’icona dell’app in modo che siano pertinenti al tema dell’app anziché usare l’icona predefinita. Questo aiuta a identificare chiaramente la tua app.
L’app è completa ed è pronta per essere pubblicata.
Esplorazione della scheda del codice e delle impostazioni dell’app
Dopo aver creato e perfezionato l’app con Creazione app, puoi accedere alla scheda Codice per visualizzare tutti i file di codice e le cartelle generati per l’app.
| File o cartella | Descrizione |
|---|---|
| blueprint.md | Un riepilogo di alto livello dello scopo dell’app, dell’architettura, delle funzionalità, dei dettagli di integrazione e delle tecnologie chiave usate (come React, i componenti di Zendesk Garden e così via). |
| changelog.md | Un registro cronologico di tutte le modifiche e gli aggiornamenti apportati durante lo sviluppo dell’app. Usa questa opzione per monitorare lo stato di avanzamento e, se necessario, per tornare indietro usando il menu a discesa dell’app Generata o la Versione nella cronologia delle conversazioni. |
| index.jsx | Questo è il file di origine principale dell’app. Gestisce il caricamento dell’app, la gestione degli errori, l’applicazione dei temi e funge da punto di ingresso per le funzionalità dell’app. |
| mock.js | Questo file contiene i dati fittizi usati per visualizzare in anteprima l’aspetto dell’app e testare i flussi dell’interfaccia utente nell’ambiente di Creazione app. |
| componenti | Questa cartella contiene i componenti React che definiscono l’interfaccia utente interattiva e la struttura dell’app. |
| stili | Questa cartella contiene fogli di stile per garantire un aspetto coerente. |
| utils | Questa cartella contiene le funzioni helper e il codice di utilità usati nell’app. Queste funzioni eseguono attività come la formattazione delle date, il filtraggio dei dati e così via. |
- Tieni traccia delle modifiche nel tempo usando i file del progetto e del registro delle modifiche.
- Trova e risolvi facilmente i problemi, poiché saprai dove cercare se qualcosa non funziona.
- Sperimenta in sicurezza stili, dati fittizi o nuove funzionalità.
Anche se non scrivi codice ogni giorno, la comprensione della struttura ti aiuta a creare, perfezionare e gestire le app in modo sicuro.
Per maggiori informazioni sul codice, consulta App nella documentazione per sviluppatori Zendesk.
Nella parte superiore troverai quanto segue:
- Menu Opzioni: Fai clic sui tre punti verticali per inviare un feedback o scaricare la conversazione come file JSON. Il download della conversazione è particolarmente utile durante la risoluzione dei problemi in quanto consente al team di rivedere i dettagli completi della conversazione se un utente riscontra un errore che non può risolvere. Puoi anche accedere all’articolo Linee guida per i prompt centro assistenza per visualizzare strategie ed esempi per comunicare chiaramente le tue esigenze a Creazione app.
- App generata: Usa il menu per scegliere e visualizzare in anteprima le diverse versioni dell’app. Ciò consente di rivedere versioni specifiche, confrontare le modifiche e ripristinare le funzionalità precedenti, se necessario.
- Prova: Fai clic per visualizzare e interagire con l’app in Zendesk Support. Il test dell’app qui consente di esplorarne e valutarne le funzionalità usando i dati reali del tuo account Zendesk. Qualsiasi aggiornamento o modifica apportata durante il test dell’app verrà applicato ai dati effettivi dell’account. Assicurati di verificare che l’app si comporti come previsto prima di distribuirla al tuo team. Se si verifica un errore durante il test, il problema non viene risolto automaticamente al momento della pubblicazione. La pubblicazione rende l’app disponibile solo nel tuo account Zendesk. Non risolve gli errori. Assicurati di risolvere eventuali problemi durante il test per garantire che l’app funzioni come previsto dopo la pubblicazione.
- Pubblica: Quando sei pronto per rilasciare l’app, fai clic su Pubblica. Questa operazione installa l’app e la rende disponibile agli agenti.
Scelta dell’icona di un’app personalizzata
Le icone personalizzate semplificano l’identificazione dell’app e la personalizzazione dell’aspetto in base al brand o al workflow. Puoi personalizzare l’icona dell’app selezionandola dalla libreria di icone Garden di Zendesk. Per ogni posizione dell’app, Creazione app garantisce la corretta visualizzazione dell’icona generando una versione PNG dell’icona SVG, se necessario.
Per selezionare l’icona di un’app personalizzata:
- Fai clic sulla scheda Impostazioni.
- Inserisci un nome per l’app. Se non inserisci un nome, Creazione app genera automaticamente un nome in base ai dettagli della conversazione e ai prompt che hai fornito.
- Sfoglia una raccolta curata di icone Garden e colori di sfondo. Fai clic su qualsiasi icona o combinazione di colori per visualizzare in anteprima l’aspetto della tua app.
- Una volta soddisfatto, fai clic su Salva.
Il nome, l’icona e il colore selezionati appariranno in Zendesk Support una volta pubblicati. Se non selezioni un’icona personalizzata, viene usata l’icona segnaposto predefinita.
Queste impostazioni vengono salvate in Creazione app, quindi la prossima volta che torni alla stessa app, vengono visualizzati i nomi e le icone più recenti a partire dalla versione in cui hai apportato le modifiche.
Controllo versione
Creazione app gestisce automaticamente le versioni dell’app durante la creazione e l’iterazione, semplificando la sperimentazione, la revisione delle modifiche e il ripristino del lavoro precedente.
Ogni volta che generi un aggiornamento o ripristini una versione precedente, Creazione app crea una nuova versione e ne registra la data/ora.
Quando viene creata una nuova versione, vedrai i dettagli della versione nella cronologia delle conversazioni. Fai clic su Ripristina per riportare l’anteprima dell’app e il codice a qualsiasi stato precedente. Il ripristino genera sempre una nuova versione, quindi nulla va perso.
Puoi anche selezionare una versione precedente usando il menu a discesa dell’app Generata nella scheda Anteprima o Codice.
Installazione e gestione delle app
Quando sei soddisfatto dell’app, fai clic su Pubblica nell’angolo in alto a destra. Ti verrà chiesto di impostare chi può accedere a questa app selezionando ruoli Zendesk specifici (come amministratore, agente e così via) e gruppi di utenti. Ciò ti consente di limitare l’accesso in base al ruolo o al gruppo. Ad esempio, limitando l’app ai soli amministratori o a gruppi di utenti selezionati.
Quindi, accetta l’esclusione di responsabilità del servizio relativa all’uso delle app create tramite Creazione app. Dopo aver fatto clic su Accetto e pubblica, inizia il processo di installazione e Creazione app ti avvisa quando l’app è stata installata correttamente.
Per modificare le autorizzazioni o gestire ulteriormente l’app, fai clic su Gestisci app nella notifica nella pagina Creazione app oppure seleziona App > App supportate da Zendesk. Consulta Gestione delle app installate.
Integrazione con sistemi privati e piattaforme di terzi
Creazione app semplifica il collegamento dell’app a origini dati aziendali private e a piattaforme esterne di terzi, guidandoti passo dopo passo attraverso la configurazione della connessione e l’autenticazione.
Per l’integrazione con servizi privati o esterni, in genere sono necessari l’endpoint API e i dettagli di autenticazione. Creazione app supporta due approcci di autenticazione principali:
- Autenticazione con chiave API: Fornisci una chiave API direttamente come credenziale, che autorizza l’app ad accedere all’API esterna. Questa chiave funge da prova che sei autorizzato a usare l’API. L’uso di una chiave API è rapido e semplice, il che la rende ideale per i sistemi interni o per i casi in cui l’API è controllata.
- Autenticazione OAuth 2.0: Anziché inserire una chiave API, OAuth 2.0 gestisce un handshake sicuro tra l’app e il servizio esterno. Questo metodo è più sicuro in quanto evita la gestione diretta delle chiavi API e abilita autorizzazioni granulari. Questo metodo è più adatto per i servizi di terzi in cui gli utenti devono concedere esplicitamente all’app l’accesso ai propri dati.
Creazione app visualizza automaticamente il pannello delle impostazioni di autenticazione appropriato quando è necessario, spesso dopo aver esaminato i requisiti per un sistema di terzi attraverso la ricerca web basata AI. Il pannello delle impostazioni di autenticazione viene visualizzato solo quando fai clic su Prova o Pubblica.
Uso delle chiavi API
Quando crei una connessione con chiave API, devi specificare un nome di intestazione HTTP. Quando la connessione viene usata per effettuare una chiamata API, Zendesk trasmette la chiave API come valore per questa intestazione.
I passaggi esatti per la configurazione dell’autenticazione con chiave API variano in base all’integrazione. Di seguito è riportato un esempio tipico e una procedura dettagliata visiva.
- In Dominio, inserisci l’URL di base del tuo account. Ad esempio, "testdomain".
- Inserisci la chiave del progetto. Questa è una chiave univoca che identifica il progetto a cui vuoi collegare l’app. Ad esempio, "Risorse umane".
- Fai clic su Continua.
- Fai clic su Prova.
- Fai clic su Avanti.
- In Domini consentiti, inserisci il dominio completo che vuoi consentire per questa connessione. Ad esempio, testdomain.atlassian.net.
- Inserisci il token API. Questa è la credenziale sicura usata per autenticare la connessione al servizio.
- Fai clic su Crea integrazione e prova app.
Uso di OAuth 2.0
Creazione app supporta il protocollo OAuth 2.0 sicuro e standard del settore per la connessione ad API interne e di terzi. Ciò significa che puoi creare in sicurezza app che accedono ai dati da sistemi esterni o dalle tue API, usando flussi di autenticazione basati su token anziché condividere credenziali statiche.
Prima di creare una connessione con il tipo di autenticazione OAuth 2.0, devi configurare un client OAuth. Per la configurazione del client OAuth sono necessari l’ID del client, il segreto del client, l’URL di autorizzazione, l’URL token e gli ambiti indicati nell’interfaccia di configurazione OAuth del sistema esterno o nel portale di amministrazione. Queste credenziali vengono generate durante la registrazione dell’applicazione client (come Zendesk) nel sistema esterno. I passaggi esatti variano in base al servizio esterno. Creazione app proverà a fornire istruzioni di configurazione per la creazione di un client OAuth nel sistema esterno. Tuttavia, le linee guida potrebbero non essere fornite se Creazione app non dispone dei dettagli necessari.
Esistono due approcci per creare un’integrazione che richiede OAuth:
-
Richiedi esplicitamente OAuth: Se sai che la tua integrazione richiederà OAuth, puoi specificarlo direttamente nel prompt di Creazione app. Ad esempio, “Crea un tutto che mi consenta di aggiungere link dai miei Fogli Google ai ticket Zendesk. Dovrebbe visualizzare un elenco di Fogli Google disponibili. Usa OAuth per connetterti a Google. Quando includi un requisito come “usa OAuth”, Creazione app ti guida passo passo nella connessione dell’app alla piattaforma esterna usando il flusso OAuth corretto.
-
Rilevamento automatico dei requisiti OAuth: Per iniziare, non è necessario essere esperti di metodi di autenticazione. Se descrivi la funzionalità che desideri, ad esempio “collegati a Google”, Creazione app riconosce quando OAuth è necessario, anche se non lo specifichi nel prompt. Il sistema guida l’utente attraverso tutti i passaggi di autorizzazione richiesti.
Quando fai clic su Test in un’app generata che usa OAuth:
- Copia l’URL di richiamata del client OAuth e salvalo in un luogo sicuro. Dovrai usarlo come URI di reindirizzamento quando crei il client OAuth nel sistema del provider OAuth di terzi.
- OAuth viene selezionato automaticamente come tipo di autenticazione. Questa apertura è disabilitata e non può essere modificata.
- Inserisci i domini consentiti per la connessione. Non puoi cambiare i domini consentiti dopo aver creato la connessione. Per maggiori informazioni, consultaDominio consentito.
- Inserisci l’ID del client. Si tratta di un identificatore univoco assegnato al client OAuth, simile al nome utente del client.
- Inserisci il segreto client. Questa è una chiave riservata rilasciata al momento della registrazione del client OAuth .
- Inserisci l’URL del token di accesso. Si tratta dell’URL usato per ricevere un token di accesso.
- Inserisci l’URL di autorizzazione. Questo è l’URL per concedere all’applicazione l’accesso all’account.
Per la maggior parte dei campi precedenti, Creazione app suggerisce e precompila i valori. Tuttavia, controlla sempre e verifica che i dettagli siano corretti.
- Inserisci un elenco di ambiti predefiniti separati da spazi. Gli ambiti sono autorizzazioni che definiscono ciò a cui un’applicazione client può accedere per conto dell’utente.
- Fai clic su Avanti.
- Nel campo Tipo di concessione, inserisci il codice di autorizzazione. Il tipo di concessione OAuth determina la modalità di autenticazione dell’app.
- (facoltativo) Seleziona “Consenti accesso offline” per richiedere i token di aggiornamento e per mantenere l’accesso mentre l’utente è offline.
- (facoltativo) Inserisci il sottodominio URL OAuth . Se necessario, inserisci il sottodominio personalizzato per il tuo provider OAuth . Lascia vuoto se non applicabile.
- Fai clic su Autorizza e seleziona un account.
Creazione app ti reindirizza al provider OAuth di terzi per selezionare il tuo account e autorizzare l’accesso. In caso di esito positivo, vedrai una conferma e un ID connessione.
- Copia l’ID connessione. Ti servirà per fare riferimento a questa connessione OAuth quando configuri o effettui richieste autenticate dall’app.
- Fai clic su Continua.
Il video seguente mostra un esempio di flusso OAuth , incluso il test dell’app.
Il video seguente mostra un esempio di flusso OAuth , inclusa la pubblicazione dell’app.
Integrazione guidata
Quando ci si connette a servizi privati o di terzi che richiedono l’autenticazione (come una chiave API o OAuth), AI di Creazione app analizza i prompt nella conversazione per determinare i dettagli di connessione necessari.
Creazione app visualizza le impostazioni di autenticazione pertinenti e acquisisce automaticamente tutte le informazioni richieste che può rilevare dalle istruzioni.
Se sono necessari ulteriori dettagli, Creazione app richiede le credenziali o la configurazione necessarie, guidandoti passo dopo passo nella configurazione della connessione.
Integrazione con i sistemi aziendali privati
Per connettersi a sistemi privati o interni:
- Ottieni l’endpoint API e informazioni su come eseguire l’autenticazione (ad esempio se hai bisogno di una chiave API o di credenziali OAuth ) dai documenti interni o dal tuo team di sviluppo.
- Per integrazioni più complesse, raccogli tutte le credenziali necessarie (chiavi API, token OAuth ) e definisci i formati di dati di input e output che verranno usati dall’app.
- Quando sei pronto per configurare la connessione, chiedi a Creazione app con le informazioni che hai raccolto e verrai guidato attraverso i passaggi rimanenti. Tieni presente che App Builder non ha familiarità con i tuoi sistemi interni e può aiutarti solo se fornisci documentazione o dettagli pertinenti su questi sistemi.
Una volta configurata l’integrazione, fai clic su Prova in Creazione app per verificare la funzionalità dell’integrazione prima della distribuzione nell’ambiente Zendesk attivo.
Integrazione dell’app con piattaforme di terzi
Creazione app ti consente di creare applicazioni in grado di visualizzare o manipolare dati da o verso qualsiasi applicazione di terzi, come Jira, Slack, Google, Calendly, Workday e altri, a condizione che tali servizi dispongano di API pubbliche. Ad esempio, puoi creare un’integrazione di Fogli Google che consenta agli agenti di visualizzare o aggiornare rapidamente i record dei clienti, i registri dei ticket, gli elenchi di inventario o i tracker del workflow senza uscire da Zendesk. L’app potrebbe presentare dati in tempo reale da fogli di calcolo o intervalli specifici e persino consentire agli agenti di aggiungere nuove voci, aggiornare i valori delle celle o archiviare i vecchi record direttamente dall’interfaccia Zendesk. Dopo ogni azione, l’app notifica all’agente se l’operazione è riuscita o se si sono verificati problemi con l’integrazione.
Risoluzione dei problemi
Creazione app potrebbe riscontrare errori che richiedono contesto o informazioni aggiuntive per essere risolti. Alcuni esempi di questi errori includono:
- Impossibile caricare l’anteprima.
- Impossibile generare o installare l’app.
- Integrazione con un sistema aziendale privato o una piattaforma di terzi non riuscita.
Quando App Builder riscontra problemi, tenta di risolverli automaticamente. In caso contrario, verrà visualizzato un messaggio di errore. Fai clic su Mostra dettagli errore per visualizzare ulteriori informazioni sul problema.
Per aiutare Creazione app a diagnosticare e risolvere il problema, fornisci dettagli chiari e specifici nella conversazione. Ciò può includere chiarimenti, credenziali o qualsiasi contesto mancante correlato all’errore. L’ AI usa queste informazioni per comprendere meglio il problema e risolverlo o chiedere maggiori dettagli.
Ad esempio, se l’output previsto era un formato di dati specifico o una particolare risposta dell’app, ma l’output effettivo era diverso, la descrizione dettagliata di queste discrepanze consentirà a Creazione app di risolvere i problemi in modo efficace e suggerire soluzioni appropriate. Più il feedback è preciso e dettagliato, meglio l’ AI può imparare dall’interazione e migliorare le sue risposte negli scenari futuri.
Quando provi l’app con dati in tempo reale nell’istanza Zendesk, come il recupero o l’aggiornamento di record o l’integrazione con app di terzi, potrebbero apparire errori che non sarebbero visibili quando si usano dati fittizi in modalità di anteprima. La maggior parte delle app sembra funzionare correttamente nella scheda Anteprima, a meno che non si verifichi un problema di compilazione del codice che impedisce il caricamento dell’anteprima. Le notifiche Guardrail ti avviseranno di eventuali errori di questo tipo durante i test con dati reali. Se riscontri un errore, copia i dettagli e incollali nella conversazione per aiutare Creazione app ad analizzare e risolvere il problema.
- 401: Errore non autorizzato - Indica che l’utente non dispone delle autorizzazioni necessarie per accedere alla risorsa richiesta.
- 403: Errore non consentito - Ciò si verifica quando un utente viene disconnesso dal Centro amministrativo dopo la scadenza della sessione mentre Creazione app rimane aperto nel browser. Può anche derivare da errori di integrazione.
- 404: Errore non trovato - Questo errore indica un URL errato o errato oppure potrebbe indicare che il percorso API richiesto non è corretto o non è disponibile.
- 431: Campi intestazione richiesta troppo grandi - Questo errore si verifica in genere dopo una serie estesa di richieste. Per risolvere il problema, prova a svuotare la cache e a svuotare i cookie dell’app Zendesk nel browser.
- 503: Errore servizio non disponibile - Questo errore si verifica quando il server riceve troppe richieste, superando i limiti di risorse. Ciò può verificarsi anche se il server non è disponibile per manutenzione o aggiornamenti.
Limitazioni
I limiti attuali includono:
- Indennità per le conversazioni in base al piano:
- Suite Professional e Support Professional: Fino a 5 conversazioni nell’app
- Suite Enterprise e Support Enterprise: Fino a 10 conversazioni nell’app
- Suite Enterprise Plus: Fino a 20 conversazioni nell’app
Nota: Una conversazione è la chat o l’insieme di messaggi in cui collabori con AI per pianificare, perfezionare e risolvere idee per le app. Inizia una nuova conversazione per ogni nuova app che vuoi creare. Non tutte le conversazioni portano a un’app pubblicata.Un’app è il prodotto finito che pubblichi da una conversazione. Una volta pubblicata, l’app viene installata nel tuo account Zendesk per essere usata da agenti e amministratori.
I limiti di conversazione limitano solo il numero di build che puoi avere in corso alla volta. Puoi pubblicare e distribuire tutte le app di cui hai bisogno. Non esiste un limite al numero di app pubblicate, ma solo al numero di conversazioni app che puoi avere contemporaneamente.
- L’eliminazione di una conversazione nell’app non elimina l’app pubblicata stessa. L’app rimarrà disponibile e utilizzabile in Zendesk per agenti e amministratori. Tuttavia, una volta eliminata la conversazione, non potrai più modificare o aggiornare l’app. Per apportare ulteriori modifiche, devi creare una nuova conversazione e creare una nuova versione dell’app.
- Un solo provider OAuth per app. Non puoi connetterti a più servizi OAuth (ad esempio, Google) nella stessa app.
- Non puoi connettere un’app sia alla chiave API che ai provider OAuth contemporaneamente. Ogni app supporta un solo tipo di provider di autenticazione alla volta.
- Puoi creare e usare app solo in un singolo ambiente. Non puoi spostare un’app dalla sandbox alla produzione o da un ambiente all’altro, quindi dovrai ricrearla manualmente se lo desideri altrove.
- Non puoi importare un’app esistente in Creazione app per modificarla o migliorarla. Puoi solo creare nuove app o continuare a lavorare sulle app originariamente avviate in Creazione app.
- Quando avvii una nuova app, devi sceglierne la posizione e non puoi cambiarla dopo l’inizio della conversazione.
- Ogni app può includere solo il codice per una singola ubicazione. Se vuoi la stessa funzionalità in più posizioni, dovrai creare e gestire una versione separata dell’app per ciascuna di esse.
- Le app in Creazione app vengono create e aggiornate interamente tramite prompt in linguaggio naturale. Al momento non è disponibile alcun assistenza per il caricamento di immagini, design o documenti come input.
- Se l’app riscontra un errore durante il test, Creazione app non lo risolverà automaticamente. Dovrai invece copiare i dettagli dell’errore e chiedere aiuto AI per risolverlo.
- Creazione app attualmente limita le richieste di immissione a 50.000 caratteri e consente fino a 200 messaggi per conversazione. Inoltre, le azioni sono limitate a 6-12 richieste al minuto per utente.
- Man mano che le conversazioni si allungano, potresti notare un rallentamento delle prestazioni perché l’impaginazione completa non è ancora supportata.
- Il registro delle modifiche tiene traccia solo dei dettagli delle dieci versioni più recenti. I file molto lunghi potrebbero non essere monitorati completamente, quindi potresti non vedere sempre la cronologia completa di ogni modifica nell’app.
- Quando scarichi l’app, riceverai il codice compilato, non i file di origine separati o i dettagli completi della configurazione, il che significa che al momento non è possibile apportare modifiche al di fuori di Creazione app.
- Attualmente sono supportate le librerie pdfjs-dist, tesseract.jse di grafici di terzi.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.