Importante: È disponibile una nuova esperienza con gli oggetti personalizzati. Consulta Introduzione ai nuovi oggetti personalizzati.

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 relativa agli oggetti personalizzati senza l'etichetta "legacy" si applica solo alla nuova esperienza con gli oggetti personalizzati.

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 tuo catalogo per avere un quadro migliore dell'esperienza dei clienti quando usano i diversi prodotti. Gli oggetti personalizzati legacy ti permettono di creare un progetto per un nuovo tipo di oggetto in Zendesk, quindi i record oggetto in base al progetto.

L’articolo include le seguenti sezioni:

  • Informazioni sugli oggetti personalizzati legacy
  • Abilitazione di oggetti personalizzati legacy
  • Definizione di un tipo di oggetto personalizzato legacy
  • Aggiunta di record oggetto 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
  • Riassumendo
  • Impostazione di ruoli e autorizzazioni per oggetti legacy
  • Eliminazione di tipi di oggetti personalizzati e di relazioni

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 tramite l’ API, quindi usare gli oggetti personalizzati legacy per personalizzare il tuo account Zendesk in base alle 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 case vacanza. I clienti possono segnalare problemi con una proprietà in affitto chiamando o avviando una chat con il team di 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 agli oggetti personalizzati legacy (18:02)

Limitazioni per gli oggetti personalizzati legacy

Le limitazioni seguenti si applicano a record e oggetti personalizzati legacy.

Limitazioni legacy degli oggetti personalizzati
  • Ogni account può avere un massimo di 50 oggetti personalizzati legacy.
Limitazioni dei record di oggetti personalizzati legacy
  • Support Enterprise, Suite Team e Growth: 100.000 record di oggetti personalizzati
  • Suite Professional: 250.000 record di oggetti personalizzati
  • Suite Enterprise: 1.000.000 di record di oggetti personalizzati
  • Suite Enterprise Plus: 25.000.000 di record di oggetti personalizzati

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 con gli oggetti personalizzati.

Definizione di un tipo di oggetto personalizzato legacy

Per le aziende di case vacanza, ogni proprietà in affitto deve essere rappresentata in Zendesk da un record oggetto personalizzato legacy. 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 che intendi usare per identificare il tipo di oggetto. La chiave deve essere inserita nel campo Nome oggetto quando si crea 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_permessi booleano sì Se gli animali sono ammessi o meno nella proprietà

Questo è il tuo schema. Si noti 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 di oggetto personalizzato legacy

  1. Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Oggetti legacy.
  2. Fai clic su Aggiungi oggetto.
  3. 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 (-)
    • Deve contenere un minimo di 2 e un massimo di 32 caratteri
  4. Fai clic su Aggiungi proprietà per definire una nuova proprietà.
  5. 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 - selezionata

  6. Fai clic su Aggiungi proprietà per continuare a creare lo schema.
  7. Inserisci i valori della seconda proprietà nel modulo Aggiungi proprietà.
  8. Continua a fare clic su Aggiungi proprietà per aggiungere le altre proprietà nella tabella dello schema.
  9. Fai clic su Salva.

Dopo la riapertura, 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 oggetto 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 legacy personalizzato per ciascuna 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", "bedrooms", "address", "country". ", "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ù efficaci, puoi stabilire una relazione tra il tuo 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 proprietà a meno che non siano associate a ticket inviati dagli ospiti per quella proprietà. Tieni presente che i ticket sono solo un altro tipo di oggetto in Zendesk.

Gli oggetti personalizzati supportano diverse relazioni tra i tipi di oggetti:

  • Uno a uno : entrambi i tipi di oggetti possono avere un solo record su ciascun lato 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 opzione non è praticabile nell’esempio delle case vacanza. A una proprietà in affitto possono essere associati più ticket.

  • Uno a molti : ogni oggetto del primo tipo è correlato a nessuno, a uno o a più oggetti del secondo tipo. 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 è correlato a nessuno, a uno o più oggetti del secondo tipo e ogni oggetto del secondo tipo è correlato a nessuno, uno o più oggetti del primo tipo. . Puoi definire un tipo di relazione molti a molti con due tipi di relazione uno a molti.

Una relazione può essere tra:

  • due tipi di oggetti personalizzati legacy (ad esempio, tra il tipo di oggetto "rental_property" e "guest_contract")
  • un tipo di oggetto personalizzato legacy e uno qualsiasi 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 di una casa vacanza, devi definire un tipo di relazione “proprietà in affitto con molti ticket” tra il tipo di oggetto “proprietà_affitto” personalizzato e il tipo di oggetto ticket Zendesk standard.

Se usi Zendesk Sell, puoi anche creare una relazione tra oggetti Zendesk Sell come cliente potenziale, trattativa o contatto.

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 associa un ticket specifico a una specifica proprietà in affitto. Man mano che questi record di relazione si accumulano, con ogni record che 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 per proprietà in affitto in base al tipo di relazione definita: una proprietà in affitto ha molti ticket.

Per creare un tipo di relazione legacy

  1. Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Relazioni.
  2. Fai clic su Aggiungi tipo di relazione.
  3. 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 (-)
    • Deve contenere un minimo di 2 e un massimo di 32 caratteri
  4. Seleziona i seguenti valori dai menu:
    • Origine - rental_property
    • Tipo - 1:Molti
    • Destinazione - zen:ticket

    La pagina dovrebbe apparire come segue:

  5. Fai clic su Salva.
Nota: Non puoi modificare il tipo di relazione una volta creato. Se devi modificarlo, devi eliminarlo e crearne un altro.

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 della proprietà in affitto. Sunshine usa questi ID per recuperare i record correlati.

Il record di relazione è regolato da un tipo di relazione 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"
  }
}
Nota: Una volta creato, il record di relazione non può essere modificato a causa del tipo di relazione sottostante. Lo sviluppatore deve eliminare il record di relazione e crearne un altro.

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 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, la proprietà in affitto ha due ticket, 35438118 e 35437746, associati. Puoi usare le informazioni per visualizzare i ticket.

Riassumendo

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 team potrebbe usare l’oggetto personalizzato della proprietà in affitto per creare un’app Zendesk che mostra 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 a 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 oggetti legacy

Quando crei un oggetto personalizzato legacy, puoi impostare le autorizzazioni dopo aver salvato lo schema dell'oggetto. Dopo aver salvato lo schema di 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

  1. Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Oggetti legacy.
  2. Fai clic su Aggiungi tipo di oggetto o seleziona un oggetto esistente da modificare.
  3. Fai clic sulla scheda Autorizzazioni .
  4. Seleziona il ruolo Agenti o Utenti finali per definire le autorizzazioni.
  5. 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.

  6. Fai clic su Salva.

Riceverai un messaggio che ti informa che l’oggetto legacy è stato salvato e puoi vedere le autorizzazioni aggiornate nella tabella.

Eliminazione di tipi di oggetti personalizzati e di relazioni

Puoi eliminare un tipo di oggetto personalizzato o di relazione nel Centro amministrativo, ma non un record oggetto personalizzato o un record di relazione. Questa sezione descrive come eliminare un tipo di oggetto personalizzato o un tipo di relazione nel Centro amministrativo. Non puoi eliminare un tipo di oggetto o una relazione a cui sono associati delle relazioni o dei record. Per eliminare un record oggetto personalizzato o eliminare un record di relazione, usa l’API Sunshine.

Per eliminare un tipo di oggetto personalizzato

  1. Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Oggetti.
  2. Posiziona il cursore del mouse sul tipo di oggetto personalizzato da eliminare, quindi fai clic sull’icona del cestino accanto al tipo.

  3. Quando viene visualizzato un messaggio di conferma, fai clic su Elimina per confermare l’eliminazione.

Per eliminare un tipo di relazione

  1. Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Oggetti personalizzati > Relazioni.
  2. Posiziona il cursore del mouse sul tipo di relazione da eliminare, quindi fai clic sull’icona del cestino accanto al tipo.

  3. 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.

Powered by Zendesk