Se usi oggetti personalizzati legacy, continuerai ad avere accesso a oggetti, record e relazioni. Tutte le risorse che aiutano a continuare a usare gli oggetti personalizzati legacy sono state etichettate come "legacy". La documentazione degli oggetti personalizzati senza l'etichetta "legacy" si applica solo alla nuova esperienza oggetto personalizzato .
Zendesk offre molti tipi di oggetti dati nativi per la memorizzazione e la gestione dei dati dei clienti, inclusi ticket, utenti, organizzazioni e altro ancora. Tuttavia, non può fornire tutti i tipi di oggetti dati che la tua organizzazione potrebbe desiderare. Ad esempio, potresti voler associare ogni nuovo ticket a un prodotto nel catalogo per avere un quadro migliore dell'esperienza dei clienti quando usano i diversi prodotti. Gli oggetti personalizzati legacy ti consentono di creare un progetto per un nuovo tipo di oggetto in Zendesk, quindi di creare record oggetto in base al progetto.
Questo articolo contiene le seguenti sezioni:
- Informazioni sugli oggetti personalizzati legacy
- Abilitazione di oggetti personalizzati legacy
- Definizione di un tipo oggetto personalizzato legacy
- Aggiunta di record di oggetti legacy
- Modellazione dei dati con oggetti personalizzati legacy
- Definizione di un tipo di relazione legacy
- Associazione di record correlati di oggetti personalizzati legacy
- Recupero di record correlati
- Mettere tutto insieme
- Impostazione di ruoli e autorizzazioni per gli oggetti legacy
- Eliminazione di tipi oggetto personalizzato e tipi di relazione
Informazioni sugli oggetti personalizzati legacy
Un oggetto personalizzato legacy può essere qualsiasi cosa, inclusi un prodotto, un contratto di servizio o la visita di un cliente. Puoi creare oggetti personalizzati legacy nel Centro amministrativo Zendesk o con l’ API, quindi usare gli oggetti personalizzati legacy per personalizzare il tuo account Zendesk in base alle tue esigenze aziendali. Puoi controllare l’accesso agli oggetti personalizzati legacy specificando le autorizzazioni applicabili a ciascun oggetto.
Questa guida mostra come definire un oggetto personalizzato legacy nel Centro amministrativo. Come esempio, viene usata un’azienda di affitti per le vacanze. I clienti possono segnalare problemi con una proprietà in affitto chiamando o avviando una chat con il team assistenza dell’azienda, che crea dei ticket per loro. L’azienda vorrebbe associare ciascun ticket a una proprietà in affitto in Support per aiutare gli agenti a fornire un servizio clienti migliore. L’azienda vorrebbe anche usare le informazioni per avere un quadro migliore dell’esperienza del cliente in ciascuna sede e pianificare i miglioramenti alle proprietà.
Il video seguente offre una panoramica degli oggetti personalizzati legacy nel Centro amministrativo, ma tieni presente che l'interfaccia ha ora un nuovo aspetto:
Miglioramenti oggetto personalizzato legacy (6:02)
Limitazioni per gli oggetti personalizzati legacy
Le limitazioni seguenti si applicano agli oggetti e ai record personalizzati legacy.
- Ogni account può avere un massimo di 50 oggetti personalizzati legacy.
- Support Enterprise, Suite Team e Growth: 100.000 record oggetto personalizzato
- Suite Professional: 250.000 record oggetto personalizzato
- Suite Enterprise: 1.000.000 di record oggetto personalizzato
- Suite Enterprise Plus: 25.000.000 di record oggetto personalizzato
Abilitazione di oggetti personalizzati legacy
Gli oggetti personalizzati legacy sono disponibili solo per gli account che hanno abilitato la funzione prima di settembre 2023. Se hai appena iniziato a usare i dati personalizzati in Zendesk, dai un’occhiata alla nuova esperienza oggetto personalizzato.
Definizione di un tipo oggetto personalizzato legacy
Per le aziende di affitti per le vacanze, vuoi che ogni proprietà in affitto sia rappresentata da un record oggetto personalizzato legacy in Zendesk. Se l’azienda acquista un’altra proprietà per le vacanze, devi semplicemente aggiungere un record oggetto per rappresentarla.
Le proprietà in affitto condividono determinati attributi. Ad esempio, ogni proprietà ha un indirizzo, un affitto settimanale, un numero di camere da letto e altro ancora. I valori degli attributi variano in base alla proprietà in affitto. Uno potrebbe essere un appartamento con due camere da letto a Lisbona per $ 600 a settimana, mentre un altro potrebbe essere una casa con tre camere da letto ad Aspen per $ 1100 a settimana.
Allo stesso modo, gli oggetti personalizzati Sunshine dello stesso tipo (come il tipo "proprietà in affitto") condividono tutti gli stessi attributi. Gli attributi di un oggetto personalizzato legacy sono definiti in un progetto chiamato tipo di oggetto.
A livello tecnico, un tipo di oggetto è costituito da una chiave e da uno schema che descrive gli attributi. La chiave è il nome da usare per identificare il tipo di oggetto. Inserisci la chiave nel campo Nome oggetto quando crei un tipo di oggetto. Esempio: "rental_property".
Puoi definire tutti i tipi di attributi per una proprietà in affitto. Per semplificare l’esempio, decidi di usare i seguenti attributi per un nuovo oggetto personalizzato con una chiave denominata “rental_property”:
| Nome | Tipo | Obbligatorio | Commento |
|---|---|---|---|
| id | stringa | sì | Identificatore univoco assegnato dall’azienda alla proprietà in affitto |
| camere da letto | numero | no | Numero di camere da letto |
| indirizzo | stringa | no | Indirizzo della proprietà in affitto |
| Paese | stringa | no | Paese in cui si trova la proprietà in affitto |
| servizio_pulizia | stringa | no | Servizio di pulizia locale |
| cleaning_service_phone | stringa | no | Numero di telefono del servizio di pulizia locale |
| animali_ammessi | booleano | sì | Se gli animali sono ammessi o meno nella proprietà |
Questo è il tuo schema. Tieni presente che lo schema non contiene informazioni su nessuna specifica proprietà in affitto. Descrive semplicemente tali informazioni. Per ulteriori informazioni, consulta Creazione di uno schema per un oggetto personalizzato legacy.
Per creare un tipo oggetto personalizzato legacy
- Nel Centro amministrativo, fai clic su
Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Oggetti legacy. - Fai clic su Aggiungi oggetto.
- In Nome oggetto, inserisci la chiave dell’oggetto come “rental_property”.
La chiave deve soddisfare i seguenti requisiti:
- Sii unico
- Contiene solo caratteri alfanumerici (az, 0-9), caratteri di sottolineatura (_) e trattini (-)
- Avere un minimo di 2 caratteri e un massimo di 32 caratteri
- Fai clic su Aggiungi proprietà per definire una nuova proprietà.
- Inserisci i seguenti valori nel modulo Aggiungi proprietà nel pannello a destra:
- Nome - id
- Tipo - stringa
- Descrizione : Identificatore univoco assegnato dall’azienda alla proprietà in affitto
- Obbligatorio : selezionato
- Fai clic su Aggiungi proprietà se vuoi continuare a creare lo schema.
- Inserisci i valori della seconda proprietà nel modulo Aggiungi proprietà.
- Continua a fare clic su Aggiungi proprietà per aggiungere le altre proprietà nella tabella dello schema.
- Fai clic su Salva.
Dopo averlo riaperto, il tipo di oggetto legacy dovrebbe apparire come segue:
Dopo aver salvato l’oggetto, puoi impostare le autorizzazioni di accesso basate sui ruoli per definire le autorizzazioni di agenti e utenti finali per i record di oggetti o relazioni. Consulta Impostazione di ruoli e autorizzazioni per gli oggetti.
Aggiunta di record di oggetti legacy
Dopo aver creato il tipo di oggetto proprietà in affitto nel Centro amministrativo, gli sviluppatori della tua organizzazione possono usare l’API Sunshine per creare un record oggetto personalizzato legacy per ciascuna delle proprietà in affitto dell’azienda. Possono anche usare l’API per leggere, aggiornare ed eliminare i record. I record di oggetti legacy non sono altro che record di database con proprietà definite.
I dati che uno sviluppatore include nella richiesta API di creare un record di proprietà in affitto sono definiti dal tipo di oggetto definito, che per il tipo "rental_property" è costituito da attributi denominati "id", "camere da letto", "indirizzo", "paese ", "servizio_pulizie" e "servizio_pulizie_telefono". Esempio:
{
"data": {
"type": "rental_property",
"attributes": {
"id": "fr-021",
"bedrooms": 2,
"address": "11 rue Laurier, Saint-Tropez",
"country": "France"
"cleaning_service": "tropez-nettoyage"
"cleaning_service_phone": "011.33.06.55.47.54.74 "
}
}
}Se vuoi recuperare i record in un secondo momento, uno sviluppatore può usare diversi endpoint per recuperarli. Consulta Record di oggetti legacy nella documentazione API.
Se l’azienda apporta una modifica a una proprietà in affitto, ad esempio un nuovo servizio di pulizia, uno sviluppatore può usare l’endpoint Aggiorna record oggetto legacy per aggiornare il record oggetto per quella proprietà in affitto.
Se l’azienda vende la proprietà in affitto, uno sviluppatore può usare l’endpoint Elimina record oggetto legacy .
Se l’azienda acquista un’altra proprietà in affitto, uno sviluppatore può usare l’endpoint Crea record oggetto legacy .
Modellazione dei dati con oggetti personalizzati legacy
Per usare i dati delle proprietà in affitto in modi più significativi, puoi stabilire una relazione tra il tipo "rental_property" e altri tipi di oggetti in Zendesk. Ad esempio, le informazioni su una particolare proprietà in affitto non sono molto utili per un amministratore di struttura a meno che non siano associate a ticket inviati dagli ospiti relativi alla proprietà. Tieni presente che i ticket sono solo un altro tipo di oggetto in Zendesk.
Gli oggetti personalizzati assistenza diverse relazioni tra i tipi di oggetti:
-
Uno a uno : entrambi i tipi di oggetti possono avere un solo record su entrambi i lati della relazione. Ad esempio, un ticket sarebbe associato a una sola proprietà in affitto e una proprietà in affitto sarebbe associata a un solo ticket. Questa non è un’opzione praticabile nell’esempio delle case vacanze. A una proprietà in affitto possono essere associati più ticket.
-
Uno a molti : ogni oggetto del primo tipo di oggetto è correlato a nessuno, uno o più oggetti del secondo tipo di oggetto. Ad esempio, una proprietà in affitto può essere associata a nessuno, a uno o a più ticket.
-
Molti-a-molti : ogni oggetto del primo tipo di oggetto è correlato a nessuno, uno o più oggetti del secondo tipo di oggetto e ogni oggetto del secondo tipo di oggetto è correlato a nessuno, uno o più oggetti del primo tipo di oggetto . Puoi definire un tipo di relazione molti-a-molti con due tipi di relazione uno-a-molti.
Una relazione può essere tra:
- due tipi oggetto personalizzato legacy (tra il tipo di oggetto "rental_property" e un tipo di oggetto "guest_contract", ad esempio)
- un tipo oggetto personalizzato legacy e uno dei seguenti tipi di oggetto Zendesk: ticket, utenti, articoli, organizzazioni, gruppi o chat
- due tipi di oggetti Zendesk standard
Definizione di un tipo di relazione legacy
Proprio come un tipo di oggetto è un progetto per la creazione di record oggetto, un tipo di relazione è un progetto per la creazione di record di relazione tra due tipi di oggetti specifici. Per l’esempio degli affitti per le vacanze, devi definire un tipo di relazione "la struttura in affitto ha molti ticket" tra il tipo di oggetto personalizzato "proprietà_affitto" e il tipo di oggetto ticket Zendesk standard.
La definizione di un tipo di relazione non crea un'associazione tra due record specifici. Descrive semplicemente la relazione. Dopo aver definito il tipo di relazione, puoi creare un record di relazione che associ un ticket specifico a una specifica proprietà in affitto. Man mano che questi record di relazione si accumulano, ogni record associa un ticket a una proprietà in affitto, inizierai ad avere un quadro più chiaro dei problemi in ciascuna proprietà in affitto. Sunshine può raggruppare i ticket in base alla proprietà in affitto in base al tipo di relazione definito: una proprietà in affitto ha molti ticket.
Per creare un tipo di relazione legacy
- Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Relazioni.
- Fai clic su Aggiungi tipo di relazione.
- In Nome relazione, inserisci "rental_prop_has_many_tickets".
La chiave deve soddisfare i seguenti requisiti:
- Sii unico
- Contiene solo caratteri alfanumerici (az, 0-9), caratteri di sottolineatura (_) e trattini (-)
- Avere un minimo di 2 caratteri e un massimo di 32 caratteri
- Seleziona i seguenti valori dai menu:
- Origine - rental_property
- Digita - 1:Molti
- Destinazione - zen:ticket
La pagina dovrebbe apparire come segue:
- Fai clic su Salva.
Associazione di record correlati di oggetti personalizzati legacy
Dopo aver definito un tipo di relazione, puoi iniziare ad associare i record correlati in base al tipo di relazione.
Puoi associare un record di un tipo di oggetto a un record di un altro tipo di oggetto creando un record di relazione (da non confondere con un tipo di relazione). Per la tua azienda di affitti per le vacanze, puoi creare un record di relazione tra un particolare ticket e una particolare proprietà in affitto.
Un record di relazione è costituito dagli ID dei due record oggetto correlati e dal relativo tipo di relazione. Il record di relazione non contiene informazioni effettive sul problema del locatario o sulla proprietà in affitto. Contiene solo l’ID del record del ticket e l’ID del record della proprietà in affitto. Sunshine usa questi ID per recuperare i record correlati.
Il record di relazione è regolato da un tipo di relazione che hai creato: il tipo uno-a-molti denominato "rental_property_has_many_tickets", in cui ogni ticket può essere associato a una sola proprietà in affitto, ma ogni proprietà in affitto può essere associata a più ticket.
Per creare un record di relazione, uno sviluppatore del team può inviare una richiesta POST all’endpoint Crea record di relazione . L’oggetto JSON che lo sviluppatore include nella richiesta deve specificare il tipo di relazione e gli ID degli oggetti “source” e “target”. Esempio:
{
"data": {
"relationship_type": "rental_property_has_many_tickets",
"source": "1c771ee0-2c3f-11e7-bf60-e5c3f630b5aa",
"target": "zen:ticket:35437746"
}
}Recupero di record correlati
Uno sviluppatore del team può usare l’endpoint Elenca record di relazione per record oggetto per recuperare i record di relazione. Ad esempio, lo sviluppatore potrebbe ottenere tutti i ticket correlati per la proprietà in affitto con un ID record "5d0daa84-aec0-11e7-9a70-416881d66b6d".
Esempio di risposta:
{
"data": [
{
"id": "c5477230-2e98-11e7-acd9-9dbd5d6450d8",
"target": "zen:ticket:35438118",
"ref": "/api/v2/tickets/35438118"
},
{
"id": "5d3484b5-aec6-11e7-9a70-a12d6a7d800c",
"target": "zen:ticket:35437746",
"ref": "/api/v2/tickets/35437746"
}
],
"links": {
"previous":null,
"next":null
}
}Nell’esempio, alla proprietà in affitto sono associati due ticket, 35438118 e 35437746. Puoi usare le informazioni per visualizzare i ticket.
Mettere tutto insieme
Puoi usare gli oggetti personalizzati e i record di relazione per risolvere problemi reali, migliorare i processi esistenti o semplicemente per avere un quadro migliore dei clienti. Ad esempio, uno sviluppatore del tuo team potrebbe usare oggetto personalizzato della proprietà in affitto per creare un’app Zendesk che mostri i dettagli di una proprietà in affitto all’agente che lavora a un ticket.
L’app potrebbe anche creare un record di relazione tra il ticket e una proprietà in affitto quando l’agente cambia lo stato del ticket da Nuovo ad Aperto. Puoi quindi usare l’API Sunshine per generare report che elencano tutti i ticket per ciascuna proprietà in affitto e usare le informazioni per pianificare i miglioramenti alla proprietà.
Impostazione di ruoli e autorizzazioni per gli oggetti legacy
Quando crei un oggetto personalizzato legacy, puoi impostare le autorizzazioni dopo aver salvato lo schema dell’oggetto. Dopo aver salvato lo schema degli oggetti, puoi vedere una serie di autorizzazioni predefinite nella scheda Autorizzazioni. Le autorizzazioni predefinite per un oggetto legacy forniscono autorizzazioni complete (creazione, lettura, aggiornamento o eliminazione) agli agenti e nessuna autorizzazione agli utenti finali.
Per impostare i ruoli e le autorizzazioni per un oggetto personalizzato legacy
- Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Oggetti legacy.
- Fai clic su Aggiungi tipo di oggetto o seleziona un oggetto esistente da modificare.
- Fai clic sulla scheda Autorizzazioni .
- Seleziona il ruolo Agenti o Utenti finali per definire le autorizzazioni.
- Nel pannello Agenti o Utenti finali , seleziona le autorizzazioni da abilitare per gli agenti o gli utenti finali.
Le scelte sono: Crea, leggi, aggiorna ed elimina.
- Fai clic su Salva.
Riceverai un messaggio che informa che l’oggetto legacy è stato salvato e puoi vedere le autorizzazioni aggiornate nella tabella.
Eliminazione di tipi oggetto personalizzato e tipi di relazione
Puoi eliminare un tipo oggetto personalizzato o un tipo di relazione nel Centro amministrativo, ma non un record oggetto personalizzato o un record di relazione. Questa sezione descrive come eliminare un tipo oggetto personalizzato o un tipo di relazione nel Centro amministrativo. Non puoi eliminare un tipo di oggetto/relazione se a esso sono associati relazioni o record esistenti. Per eliminare un record oggetto personalizzato o eliminare un record di relazione, usa l’API Sunshine .
Per eliminare un tipo oggetto personalizzato
- Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Oggetti.
- Posiziona il cursore del mouse sul tipo oggetto personalizzato da eliminare, quindi fai clic sull’icona del cestino accanto al tipo.
- Quando viene visualizzato un messaggio di conferma, fai clic su Elimina per confermare l’eliminazione.
Per eliminare un tipo di relazione
- Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Relazioni.
- Posiziona il cursore del mouse sul tipo di relazione da eliminare, quindi fai clic sull’icona del cestino accanto al tipo.
- Quando viene visualizzato un messaggio di conferma, fai clic su Elimina per confermare l’eliminazione.
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.