Questo articolo include tabelle che elencano e descrivono valori e parole chiave di proprietà di dati che possono essere usati, insieme a operatori di ricerca comuni, per limitare i risultati delle ricerche. Sono inoltre presenti sezioni che descrivono metodi di ricerca e formattazione più avanzati.
Questo articolo è destinato agli amministratori e ai responsabili dell’assistenza che hanno accesso completo ai dati in Zendesk Support. Se sei un agente, leggi dapprima Ricerca di dati in Zendesk Support e consulta quindi questo articolo per effettuare ricerche più avanzate.
Questo articolo include i seguenti argomenti su metodi di ricerca avanzati:
Questo articolo include le tabelle di riferimento seguenti:
- Operatori di ricerca
- Parole chiave di proprietà per ticket
- Parole chiave di proprietà per utenti
- Parole chiave di proprietà per organizzazioni
- Parole chiave di proprietà per gruppi
- Valori di valutazione della soddisfazione che è possibile cercare
Terminologia e termini di ricerca
Termini di ricerca
I termini di ricerca sono parole, frasi o valori definiti dall’utente. Esempi:
- 3245227
- Greenbriar
- numero di serie
- "Jane Doe"
Per i termini di ricerca non viene fatta la distinzione tra maiuscole e minuscole. Ad esempio, "App" e "app" restituiscono gli stessi risultati.
Un termine di ricerca composto da una singola parola restituisce un risultato se appare nei dati come:
- singola parola
- singola parola in una frase più lunga
- prefisso di una parola più lunga
Il termine di ricerca non restituisce un risultato se appare:
- in mezzo a una parola
- alla fine di una parola
Ad esempio, il termine di ricerca "top" potrebbe restituire "top", "top tier", "Top Ten Trucking", "Tip-Top Mops", "Big Top Entertainment" e "Dessert Toppings, Inc". Non restituirebbe "Desktop Solutions" e "One-Stop Publishing".
Please upgrade my account
Parole chiave di proprietà
Puoi limitare i risultati della ricerca combinando parole chiave di proprietà con termini di ricerca e operatori. Esempio:
status<solved
Una parola chiave di proprietà è il nome di una proprietà in un ticket, in un utente, in un’organizzazione o in un gruppo. Esempi:
- assignee
- created
- name
Consulta le sezioni seguenti relative alle parole chiave di proprietà per informazioni dettagliate su tutte le proprietà:
Esempi di ricerche con proprietà:
Ricerca | Parola chiave di proprietà | Restituisce |
---|---|---|
priority>normal | priority | I ticket con priorità alta o urgente |
subject:2fa | subject | I ticket con il termine di ricerca 2fa nell’oggetto |
email:jdoe@example.com | L’utente con l’indirizzo email jdoe@example.com |
Alcune proprietà hanno valori predefiniti. Ad esempio, la proprietà relativa allo stato dei ticket ha i seguenti valori predefiniti: new, open, pending, hold, solved, closed. Puoi effettuare la ricerca solo in base a questi valori. Esempio di ricerca: status:open
. Per dettagli su ogni proprietà, consulta le informazioni di riferimento sulle parole chiave di proprietà.
Altre proprietà accettano termini di ricerca definiti dall’utente. Esempio: subject:2fa
. Consulta Termini di ricerca. Le stesse regole di corrispondenza si applicano alle ricerche di proprietà, ad eccezione di quelle relative ai prefissi. I risultati non vengono restituiti se il termine di ricerca appare come prefisso di una parola più lunga. Ad esempio, il termine di ricerca "tier" restituirebbe risultati per "tier 1" e "tier 2" ma non per "tiered".
Puoi cercare più valori di una singola proprietà includendo la parola chiave di proprietà più volte in una query. Esempio:
tags:silver tags:bronze
In questo caso, la ricerca usa la logica OR per la corrispondenza. L’esempio precedente restituisce risultati che contengono il tag "silver" o il tag "bronze".
Esempio di ricerca
L’espressione di ricerca seguente cerca qualsiasi cosa con il tag "vip" creata prima del 1 maggio 2019:
tags:vip created<2019-05-01
- tags è una parola chiave di proprietà che indica che stai effettuando la ricerca solo in una specifica proprietà di dati, in questo caso un tag.
- : è l’operatore "uguale a" che indica che il valore della proprietà tag deve essere uguale al termine di ricerca successivo. Nota che non ci sono spazi prima o dopo :.
- vip è il termine di ricerca.
- created è una parola chiave di proprietà che indica che stai cercando elementi creati in relazione a una determinata data nella proprietà dei dati created.
- < è l’operatore "minore di" che indica che stai cercando record creati prima di una determinata data.
- 2015-05-01 è un termine di ricerca che indica la data che intendi usare.
Ricerca di proprietà che non contengono dati
none
come termine di ricerca, insieme alle parole chiave group, tags, via, organization o assignee:assignee:none
L’esempio sopra restituisce tutti i ticket non assegnati.
Ricerca per data e ora
Le parole chiave di proprietà di data, ovvero created, updated, solvede due date, possono essere combinate con operatori di ricerca per restituire dati di una data specifica, anteriori a una determinata data e posteriori a una determinata data. Per cercare date qualunque sia la lingua o il Paese, usa il formato AAAA-MM-GG. Puoi anche usare formati specifici, come MM/GG/AAAA negli Stati Uniti.
created<2011-05-01
due_date>2010-01-10
solved:2010-01-10
Puoi anche usare gli operatori <= o >= per indicare rispettivamente minore o uguale a e maggiore o uguale a.
Ricerca con una combinazione di data e ora
created>2015-09-01T12:00:00-08:00 updated<2015-09-01T12:00:00Z
Il primo esempio qui sopra cerca tutto ciò che è stato creato dopo il 1° settembre 2015 alle 12:00 (fuso orario del Pacifico).
Il secondo esempio qui sopra cerca tutto ciò che è stato aggiornato prima del 1° settembre 2015 alle 12:00 (UTC).
Ricerca in un intervallo di date/ore
created>2014-08-01 created<2014-08-05
Puoi anche includere ore specifiche nell’intervallo di ricerca. L’esempio seguente cerca tutto ciò che è stato creato tra le 23:59 del 1° agosto 2014 (UTC) e la mezzanotte del 4 agosto 2014 (UTC):
created>2014-08-01T23:59:00Z created<2014-08-04T23:59:59Z
Ricerca con tempi relativi
Puoi cercare un tempo relativo al tempo corrente usando le unità di tempo hours, minutes, days, weeks, months o years. La ricerca seguente restituisce tutto ciò che è stato creato nelle ultime quattro ore:
created>4hours
Ordinamento dei risultati della ricerca
order_by:field
-
sort:asc
oppuresort:desc
created
commented
priority
status
ticket_type
L’uso della parole chiave order_by
e sort
è equivalente all’uso dei parametri API sort_by
e sort_order
.
Uso della parola chiave "type"
Per le ricerche API, uno degli strumenti disponibili per limitare i risultati delle ricerche è la parola chiave type
. Viene usata per dichiarare esplicitamente che si intende cercare uno dei seguenti tipi:
- ticket
- user
- organization
- group
L’uso della parola chiave type
indica che stai cercando esplicitamente il tipo specificato. Ad esempio, con l’istruzione di ricerca seguente puoi cercare tutti gli utenti che appartengono all’organizzazione Customers:
type:user organization:customers
Utilizzando invece l’istruzione organization:customers
, si otterrebbero anche tutti i ticket i cui richiedenti appartengono a tale organizzazione. Questo perché le ricerche che non specificano in modo esplicito il tipo restituiscono risultati per tutti i tipi, inclusi i ticket (e organization è una proprietà di ticket).
Se usi type:user
, la ricerca restituisce tutti gli utenti che appartengono all’organizzazione Customers. In questo modo, limiti la ricerca al tipo user escludendo i ticket.
Sebbene organizzazioni e gruppi siano proprietà dell’oggetto user, includono proprietà che è possibile usare per la ricerca. La query seguente consente di cercare solo tag di organizzazione, escludendo i tag con lo stesso nome che possono essere usati in altri elementi dell’istanza di Zendesk Support, come ticket e argomenti dei forum.
type:organization tags:premium
Uso della parola chiave "user"
Per cercare i dati del profilo di un utente, sono disponibili le due opzioni seguenti.
user
:user:amyoppure la parola chiave
type:user
:type:user amy
Per maggiori informazioni sulla parola chiave user
e sulle differenze tra questa e la parola chiave type:user
, consulta Parole chiave user e type in Ricerca di utenti, gruppi e organizzazioni.
Domande frequenti sulla ricerca
-
Dopo quanto tempo è possibile cercare nuovi dati?
Quando si aggiungono nuovi dati a Zendesk Support, è in genere necessario circa un minuto prima che vengano indicizzati e che possano essere disponibili per la ricerca.
-
In che modo la punteggiatura influisce sulla ricerca?
I caratteri di punteggiatura in genere non sono inclusi nelle ricerche.
-
Esistono limitazioni per le ricerche con caratteri jolly?
Puoi eseguire ricerche con caratteri jolly solo se abbinate a parole chiave di proprietà (
subject:photo*
). -
Chi può cercare cosa?
Gli amministratori possono cercare tutti i dati in Zendesk Support. Gli agenti possono effettuare ricerche nei dati a cui sono autorizzati ad accedere. Gli utenti finali possono effettuare ricerche full-text nella Knowledge base.
-
Quali lingue sono supportate?
È disponibile un supporto specifico per la ricerca nelle lingue seguenti:- Inglese
- Francese
- Tedesco
- Giapponese
- Portoghese
- Spagnolo
Il supporto include la tokenizzazione basata su dizionari per il giapponese, in quanto le parole non sono separate da spazi in quella lingua. Per le altre lingue, il supporto specifico per la lingua è essenzialmente lo stemming. Ciò significa che è possibile abbinare forme diverse della stessa parola. Ad esempio, in genere vengono restituite la forma singolare e quella plurale di una parola. Inoltre, se usi il plurale tra virgolette (ad esempio, "gatti"), la ricerca restituirà comunque risultati sia per "gatto" che per "gatti".
Operatori di ricerca
Puoi usare i seguenti operatori di ricerca per creare istruzioni di ricerca.
Operatore | Descrizione |
---|---|
: | I due punti indicano che il campo specificato deve essere uguale al valore specificato.status:open |
< | Minore di status<closed |
> | Maggiore di priority>normal |
<= | Minore o uguale a status<=pending |
>= | Maggiore o uguale a priority>=normal |
" " | Virgolette doppie. In una ricerca con parole chiave semplice, si tratta di una ricerca di frase e restituisce le parole esatte nell’ordine esatto; tuttavia, i caratteri di punteggiatura non sono inclusi."Please upgrade my account"
Nota: nella versione giapponese di Support, questa funzionalità non funziona come previsto. Una ricerca con parola chiave semplice che include virgolette doppie restituisce dei risultati, ma non sono parole esatte nell’ordine esatto.
In una ricerca che include proprietà di dati, usa le virgolette doppie per eseguire una ricerca inclusiva con AND e ottenere risultati che includono tutte le proprietà nella ricerca. tags:"superman is_awesome" |
- | Segno meno. Esclude gli elementi contenenti una parola (o un valore di proprietà) dai risultati della ricerca. Ad esempio, l’istruzione seguente cerca i ticket il cui stato è "pending", ma esclude dai risultati della ricerca i ticket contenenti il tag "invoice":
status:pending -tags:invoice |
* | L’operatore jolly è utile quando si intende cercare varie forme di una parola. Ad esempio, photo* restituisce risultati che includono photography, photographer, photograph e qualsiasi altra parola che inizia con "photo". Tuttavia, poiché le ricerche con caratteri jolly presentano problemi di prestazioni, non sono attualmente supportate le ricerche con caratteri jolly non qualificate. In altre parole, devi usare una parola chiave di proprietà per rendere la ricerca specifica per i dati che stai cercando.
subject:photo* |
Parole chiave di proprietà per ticket
Puoi effettuare ricerche in base alle proprietà per ticket seguenti.
Per maggiori informazioni sulla ricerca di ticket, consulta Ricerca di ticket.
Parola chiave | Descrizione |
---|---|
ID ticket | Non esiste una parola chiave di proprietà per l’ID ticket. Devi cercare il ticket in base al relativo numero ID nel formato seguente:233 |
created |
La data o la data e l’ora in cui il ticket è stato creato. Immetti la data nel formato aaaa-mm-gg. created:2011-05-01 Effettua la ricerca in un intervallo di date o di ore. Inserisci gli orari usando la sintassi ISO 8601. Ad esempio, per cercare un ticket creato tra le 10:30 e la mezzanotte (UTC) del 1 agosto 2014: created>2014-08-01T10:30:00Z created<2014-08-01T12:00:00Z Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
updated |
La data dell’ultimo aggiornamento del ticket. updated>2011-05-15 Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
solved |
La data di soluzione del ticket. solved<2011-06-01 Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
due_date |
La data di scadenza dei ticket. due_date:2011-06-01 Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
assignee |
L’agente o altra entità assegnata. Puoi specificare "none", "me", il nome utente (completo o parziale), l’indirizzo email, l’ID utente o il numero di telefono (consulta phone proprietà utente per ricevere assistenza nella ricerca in base al numero di telefono).assignee:"Susan Warren" |
submitter |
Il mittente del ticket. Può essere diverso dal richiedente se il ticket è stato inviato da un agente per conto del richiedente. Puoi specificare "none", "me", il nome utente (completo o parziale), l’indirizzo email, l’ID utente o il numero di telefono (consulta phone proprietà utente per ricevere assistenza nella ricerca in base al numero di telefono). Consulta Ricerca di ruoli utente nei ticket. submitter:me |
requester |
Il richiedente del ticket. Puoi specificare "none", "me", il nome utente (completo o parziale), l’indirizzo email, l’ID utente o il numero di telefono (consulta phone proprietà utente per ricevere assistenza nella ricerca in base al numero di telefono).requester:amy@mondocam.com |
subject |
Il testo nell’oggetto del ticket. subject:"upgrade account" |
description |
Il testo della descrizione e dei commenti del ticket.description:defective |
custom_status_id |
Se gli stati ticket personalizzati sono attivati, cerca uno stato di sistema o ticket personalizzato specifico. Specifica lo stato in base al relativo ID numerico, che puoi trovare nella pagina Stati ticket durante la modifica dello stato di un ticket.
|
status |
Valori possibili: new, open, pending, hold, solved, closed. status<closed |
ticket_type |
Valori possibili: question, incident, problem, task. ticket_type:problem |
priority |
Valori possibili: low, normal, high, urgent.
priority>low |
group |
Specifica il nome o l’ID di un gruppo. Restituisce i ticket assegnati agli agenti membri del gruppo. Esempi:group:"Level 2" group:20663166 |
organization |
Specifica il nome o l’ID di un’organizzazione. Restituisce i ticket dei richiedenti che sono membri dell’organizzazione. Esempi:organization:customers organization:22989442 Puoi anche specificare "none" per restituire i ticket dei richiedenti che non sono membri di alcuna organizzazione. organization:none |
tags |
Specifica i tag che sono stati aggiunti al ticket oppure "none".tags:premium Per trovare ticket che includono uno dei due tag usa: tags:important tags:urgent Per trovare ticket che includono entrambi i tag: tags:"important urgent" |
via |
L’origine del ticket, ad esempio:
via:phone Per un elenco completo delle origini, consulta Informazioni di riferimento sui tipi di Via nella documentazione per sviluppatori Zendesk. |
commenter |
Le persone che hanno aggiunto commenti a ticket. Puoi specificare "none", "me", il nome utente (completo o parziale), l’indirizzo email, l’ID utente o il numero di telefono (consulta phone proprietà utente per ricevere assistenza nella ricerca in base al numero di telefono).commenter:"Mike" |
cc |
Le persone che sono state incluse in CC nei ticket. Puoi specificare "none", "me", il nome utente (completo o parziale), l’indirizzo email, l’ID utente o il numero di telefono (consulta phone proprietà utente per ricevere assistenza nella ricerca in base al numero di telefono).cc:amanda@mondocam.com |
fieldvalue |
Cerca un valore specifico in qualsiasi campo ticket personalizzato usando la parola chiave fieldvalue. Ad esempio:fieldvalue:12345 Restituisce tutti i ticket che hanno un campo personalizzato con il valore "12345". Per i campi personalizzati con menu a discesa, cerca tag associati al valore del campo che intendi trovare. Per i campi personalizzati con casella di spunta, puoi cercare i biglietti con il campo selezionato o deselezionato. Ad esempio: custom_field_<Field ID>:checked |
custom_field_{id} |
Cerca il valore di uno specifico campo ticket personalizzato. Specifica il campo in base al relativo ID numerico che può essere ottenuto dall’URL della pagina Campi ticket nell’interfaccia di amministrazione o tramite l’API Campi ticket. La sintassi è custom_field_ . Esempio:
Consulta Ricerca di campi ticket personalizzati. |
brand |
Cerca un brand specifico in un ticket usando il nome o l’ID del brand. Un brand avente due o più parole deve essere racchiuso tra virgolette. Ad esempio:brand:Nordstrom oppure
brand: "Banana Republic" oppure brand:<ID number> |
has_attachment |
Cerca tutti i ticket con o senza allegati usando true oppure false . Per cercare ticket con allegati:
Per cercare tutti i ticket senza allegati:
|
form |
Cerca tutti i ticket creati con un particolare modulo ticket. Se il nome del modulo ticket include più parole, usa le virgolette. Ad esempio:
Se il nome del modulo ticket è composto da una sola parola, non è necessario usare le virgolette. Ad esempio:
|
recipient |
Cerca tutti i ticket creati con un particolare destinatario. Funziona solo con gli indirizzi di assistenza Zendesk (la destinazione finale) delle email inoltrate da indirizzi esterni.
|
comment |
Cerca il testo all’interno del commento di un ticket.
Per cercare una corrispondenza esatta nei commenti di un ticket, usa le virgolette doppie.
Nota: vengono cercati solo i primi 500 commenti in un ticket.
|
Parole chiave di proprietà per utenti
Di seguito è riportato l’elenco delle proprietà per gli utenti che possono essere utilizzate per la ricerca.
Per ulteriori informazioni sulla ricerca di utenti, consulta Ricerca di utenti, gruppi e organizzazioni.
Parola chiave | Descrizione |
---|---|
name |
Il nome completo o parziale dell’utente.
name:"alex anderson" |
role |
Il ruolo designato dell’utente.role:admin role:light agent role:role IDdove roleID viene sostituito con l’ID di un ruolo. |
email |
Specifica l’indirizzo email dell’utente oppure none per cercare utenti senza indirizzo email.
email:alex@mondocam.com email:"none" L’uso delle virgolette doppie per cercare un indirizzo email non restituisce una corrispondenza esatta come le altre ricerche con parole chiave. Ad esempio, se cerchi quanto segue, i risultati potrebbero restituire qualsiasi utente il cui indirizzo email inizia con "dwight":
Suggerimento: i caratteri jolly non sono utilizzabili per le ricerche di indirizzi email. Ad esempio, la ricerca seguente non restituisce risultati:
email:dwight* |
group |
Il nome di gruppo dell’utente. È valido solo per amministratori e agenti.
group:"Level 2" |
organization |
Specifica il nome o l’ID organizzazione dell’utente oppure none per cercare utenti senza organizzazione. Se l’utente appartiene a più organizzazioni, la ricerca in una di quelle organizzazioni restituisce il profilo dell’utente.organization:mondocam |
created |
La data in cui l’utente è stato aggiunto a Zendesk.
created<2011-05-01 Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
notes |
Tutto il testo nel campo delle note nel profilo dell’utente.
notes:"manager" |
details |
Tutto il testo nel campo dei dettagli nel profilo dell’utente.
details:"madison, wi" |
external_id |
Specifica l’ID esterno dell’utente, se usato, oppure none per cercare utenti senza ID esterno. external_id:0098884412 |
phone |
Specifica il numero di telefono dell’utente oppure none per cercare utenti senza numero di telefono.
phone:+555-111-2222 Quando effettui una ricerca in base al numero di telefono, dovrai includere un segno più (+) prima del numero. Quando effettui una ricerca in base al numero di telefono usando l’API, devi includere %2B (la versione codificata URL di +) prima del numero (ad esempio, |
tags |
Specifica i tag nel profilo dell’utente, oppure none per cercare utenti senza tag.
tags:premium tags:wholesalePer ulteriori informazioni sull’aggiunta di tag a utenti e organizzazioni, consulta Aggiunta di tag a utenti e organizzazioni. |
customfield |
I campi utente personalizzati.plan_type:platinumPer maggiori informazioni, consulta Ricerca di campi utente e organizzazione personalizzati. |
is_verified |
Indica se le identità di un utente sono state verificate.
Qualsiasi utente creato tramite la condivisione di ticket viene verificato automaticamente. |
is_suspended |
Indica se l’utente è stato sospeso.
|
Cerca utenti in base al numero di telefono WhatsApp. Per maggiori informazioni, consultaRicerca di ticket in base al numero WhatsApp. |
Parole chiave di proprietà per organizzazioni
Di seguito è riportato l’elenco delle proprietà per le organizzazioni che possono essere utilizzate per la ricerca. Per ulteriori informazioni, consulta Ricerca di utenti, gruppi e organizzazioni.
Parola chiave | Descrizione |
---|---|
name |
Il nome completo o parziale dell’organizzazione.name:mondocam |
created |
La data in cui è stata aggiunta l’organizzazione. created<2011-05-01 Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
notes |
Tutto il testo nel campo delle note nel profilo dell’utente. notes:EMEA |
details |
Tutto il testo nel campo dei dettagli nel profilo dell’organizzazione.details:london |
tags |
Specifica i tag che sono stati aggiunti all’organizzazione oppure none per cercare organizzazioni senza tag. tags:premium Per ulteriori informazioni sull’aggiunta di tag a utenti e organizzazioni, consulta Aggiunta di tag a utenti e organizzazioni. |
customfield |
I campi organizzazione personalizzati.plan_type:platinumPer maggiori informazioni, consulta Ricerca di campi utente e organizzazione personalizzati. |
external_id |
L’ID esterno dell’organizzazione oppure specifica none per cercare utenti senza ID esterno.external_id:00112345 |
Parole chiave di proprietà per gruppi
Di seguito è riportato l’elenco delle proprietà per gruppi che è possibile utilizzare per la ricerca. Per ulteriori informazioni, consulta Ricerca di utenti, gruppi e organizzazioni.
Parola chiave | Descrizione |
---|---|
name |
Il nome del gruppo.name:"level 2" |
created |
La data in cui il gruppo è stato aggiunto. created<2011-05-01 Per maggiori informazioni sull’uso di date e ore nelle ricerche, consulta Ricerca per data e ora. |
Valori di valutazione della soddisfazione che è possibile cercare
Puoi usare la parola chiave satisfaction
con valori di valutazione per cercare valutazioni della soddisfazione del cliente. Per ulteriori informazioni sulla soddisfazione del cliente, consulta Uso della valutazione della soddisfazione del cliente.
Valore | Descrizione |
---|---|
bad |
I ticket la cui valutazione è negativa.
|
badwithcomment |
I ticket la cui valutazione è negativa che includono anche un commento del richiedente del ticket.
|
good |
I ticket la cui valutazione è positiva.
|
goodwithcomment |
I ticket la cui valutazione è positiva che includono anche un commento del richiedente del ticket.
|
offered |
Quando richiedi una valutazione della soddisfazione del cliente, lo stato della valutazione della soddisfazione del ticket diventa "offered". La notifica seguente viene aggiunta al ticket: È stato offerto feedback sulla soddisfazione del cliente. Ciò significa che hai chiesto ma non ancora ottenuto una risposta alla richiesta di valutazione.
|