Pesquisa de usuários, grupos e organizações

Qual é o meu plano?

Os dados nos usuários finais, membros da equipe, grupo e objetos da organização podem ser pesquisados em suas respectivas páginas.

Este artigo abrange os seguintes tópicos:

• Sobre pesquisas
• As palavras-chave user e type
• Pesquisa de usuários
• Pesquisa de usuários por domínio de e-mail
• Pesquisa de grupos
• Pesquisa de organizações
• Pesquisa por campos personalizados de usuário e de organização

Sobre pesquisas

No topo de cada página relacionada ao gerenciamento e organização dos usuários, há uma barra de pesquisa. As pesquisas nessas páginas são limitadas ao escopo da página. Ou seja, uma pesquisa na página Membros da equipe retorna apenas os membros da equipe que atendem aos critérios de pesquisa e, da mesma forma, uma pesquisa na página das Organizações retorna apenas as organizações que atendem aos critérios de pesquisa.

Se você pesquisar usando a ferramenta de pesquisa global, precisará também usar a palavra-chave type, caso queira restringir os resultados a tipos específicos de dados. Se você não fizer isso, os resultados da pesquisa incluirão correspondências de todos os dados em sua instância do Zendesk Support.

type:organization tags:premium

Para obter mais informações sobre como usar a pesquisa, consulte Pesquisa por dados em seu Zendesk. As propriedades dos dados do usuário que podem ser pesquisadas são descritas nas tabelas abaixo. Todos os dados que podem ser pesquisados em sua instância do Zendesk Support (incluindo dados de ticket) são descritos em Referência de pesquisas no Zendesk.

As palavras-chave user e type

Para pesquisar dados de perfil do usuário, você tem as duas opções a seguir.

Uso da palavra-chave user:

user:amy

Ou uso da palavra-chave type:user:

type:user amy

Qual a diferença entre as duas? A palavra-chave user quando não associada a type é apenas um atalho para encontrar usuários por ID, nome e endereço de e-mail. A palavra-chave user, assim como as palavras-chave de função de usuário de ticket (atribuído, solicitante, emissor), aceita ID, nome e endereço de e-mail como identificadores de usuário válido.

user:52789480
user:amy
user:"amy moore"
user:[e-mail]

Se deseja pesquisar outros dados do usuário, como número de telefone, organização a que ele pertence e assim por diante, você precisará usar type:user.

type:user tags:beta_user organization:customers

Esse exemplo também ilustra a utilidade da palavra-chave type. Com ela você pode pesquisar dados do usuário que são compartilhados por mais de um usuário. Você pode pesquisar os usuários que estão na mesma organização ou grupo, ou qualquer um dos outros dados do usuário que possam ser pesquisados. Para obter mais informações sobre a palavra-chave type, consulte Uso da palavra-chave type.

A palavra-chave type também é usada para pesquisar objetos de dados de grupos e organizações. Por exemplo:

• type:group name:"level 2"

• type:organization name:customers

Pesquisa de usuários

O objeto de dados do usuário contém todas as propriedades de usuário que você pode definir no perfil de usuário para usuários finais e membros da equipe. Nem todos os dados de perfil de usuário podem ser pesquisados; as propriedades que podem ser pesquisadas são descritas na tabela a seguir.

Tabela 1. Palavras-chave de propriedade do usuário

Palavra-chave	Descrição
name	O nome parcial ou completo do usuário. name:"alex anderson"
role	A função designada do usuário. role:admin
email	Especifique o endereço de e-mail do usuário ou especifique “none” para pesquisar usuários sem um endereço de e-mail. email:[e-mail] email:"none" Dica: os curingas não funcionam para pesquisas de endereço de e-mail. Por exemplo, a pesquisa a seguir não retorna resultados: email:dwight*
group	O nome do grupo do usuário. Aplica-se apenas ao administrador e aos usuários agentes. group:"Level 2"
organization	Especifique o nome ou a ID da organização do usuário, ou especifique none para pesquisar usuários sem uma organização. Se o usuário pertencer a mais de uma organização, pesquisar qualquer uma dessas organizações retornará o perfil dele. organization:mondocam
created	A data em que o usuário foi adicionado ao seu Zendesk. created<2011-05-01 Para obter mais informações sobre como usar data e hora na sua pesquisa, consulte Pesquisa por data e hora.
notes	Todo o texto no campo de observações do perfil do usuário. notes:"manager"
details	Todo o texto no campo de detalhes do perfil do usuário. details:"madison, wi"
external_id	Especifique a ID externa do usuário, se usada, ou especifique none para pesquisar usuários sem uma ID externa. external_id:0098884412
phone	Especifique o número de telefone do usuário, ou especifique none para pesquisar usuários sem número de telefone. phone:[phone]
tags	Especifique tags no perfil do usuário, ou especifique none para pesquisar usuários sem tags. tags:premium tags:wholesale Para obter mais informações sobre a marcação de usuários e organizações com tags, consulte Inclusão de tags em usuários e organizações.
customfield	Campos de usuário personalizados. plan_type:platinum Para obter mais informações, consulte Pesquisa por campos personalizados de usuário e organização.
is_verified	Indica se o endereço de e-mail principal do usuário foi confirmado. is_verified:false Sunita retorna todos os usuários com o nome Sunita que possuem um endereço de e-mail principal não confirmado. is_verified:true retorna todos os usuários que possuem um endereço de e-mail principal confirmado.
is_suspended	Indica se o usuário foi suspenso. is_suspended:true Sunita retorna todos os usuários com o nome Sunita que foram suspensos. is_suspended:true retorna todos os usuários que foram suspensos.
whatsapp	Pesquisa por usuários com base em um número de telefone do WhatsApp. Para obter mais informações, consulte Pesquisa por tickets por número do WhatsApp.

Pesquisa de usuários por domínio de e-mail

Todos os usuários que pertencem ao mesmo domínio de e-mail podem ser retornados com a seguinte instrução de pesquisa:

type:user mondocam.com

Para pesquisar mais de um domínio de e-mail de uma vez, basta adicionar mais domínios de e-mail à pesquisa separados por um espaço:

type:user mondocam.com zendesk.com

Pesquisa de grupos

Estas são as propriedades de grupo que podem ser pesquisadas.

Tabela 2. Palavras-chave da propriedade de grupo

Palavra-chave	Descrição
name	O nome do grupo. name:"level 2"
created	A data em que o grupo foi adicionado. created<2011-05-01 Para obter mais informações sobre como usar data e hora na sua pesquisa, consulte Pesquisa por data e hora.

Pesquisa de organizações

Estas são as propriedades de organização que podem ser pesquisadas.

Tabela 3. Palavras-chave de propriedade da organização

Palavra-chave	Descrição
name	O nome parcial ou completo da organização. name:mondocam
created	A data em que a organização foi adicionada. created<2011-05-01 Para obter mais informações sobre como usar data e hora na sua pesquisa, consulte Pesquisa por data e hora.
notes	Todo o texto no campo de observações do perfil do usuário. notes:EMEA
details	Todo o texto no campo de detalhes do perfil da organização. details:london
tags	Especifique as tags que foram adicionadas à organização, ou especifique none para pesquisar organizações sem tags. tags:premium Para obter mais informações sobre a marcação de usuários e organizações com tags, consulte Inclusão de tags em usuários e organizações.
customfield	Campos de organização personalizados. plan_type:platinum Para obter mais informações, consulte Pesquisa por campos personalizados de usuário e organização.
external_id	A ID externa da organização ou especifique none para pesquisar usuários sem uma ID externa. external_id:00112345

Pesquisa por campos personalizados de usuário e de organização

Você pode pesquisar por dados em campos personalizados de usuário e organização usando a chave que identifica o campo personalizado.

Como localizar a chave de um campo personalizado

1. Navegue até a lista de campos personalizados:
   • Na Central de administração, clique no ícone Pessoas () na barra lateral e selecione Configuração > Campos da organização.
   • Na Central de administração, clique no ícone Pessoas () na barra lateral e selecione Configuração > Campos do usuário.
2. Clique no nome de um campo personalizado.

   A chave de campo é exibida no painel de propriedades à direita.

Você pode pesquisar usuários e organizações que não possuem valor em um campo personalizado específico, ao usar "none" como termo de pesquisa junto com a chave de campo personalizado. Por exemplo, se você tem a chave do campo personalizado foo, uma pesquisa por foo:none retornará todos usuários e organizações com o campo personalizado vazio foo.

Observação: não é possível pesquisar por dados em campos personalizados de ticket da mesma maneira de campos de usuário ou organização personalizados. Para os campos personalizados de ticket, você pode pesquisar por dados em campos de lista suspensa e caixa de seleção com base em suas tags. Para obter mais informações, consulte Pesquisa por campos personalizados de ticket.

Tipo de campo	Operadores	Exemplos
Lista suspensa	:	Encontre usuários ou organizações em que plan_type é platina: plan_type:platinum Encontre usuários ou organizações em que plan_type é platina ou ouro: plan_type:platinum plan_type:gold
Texto Texto multilinha	:	Encontre usuários ou organizações em que product_name contém widget: product_name:widget
Expressão regular	:	Encontre usuários ou organizações em que product_name contém a frase com várias palavras "red widget": product_name:"red widget"
Numérico	>, <, >=, <=, :	Encontre usuários ou organizações em que num_agents é exatamente 5: num_agents:5 Encontre usuários ou organizações em que num_agents está entre 4 e 10 (incluso): num_agents>4 num_agents<10
Decimal	>, <, >=, <=, :	Encontre usuários ou organizações em que avg_score é maior que 14,5: avg_score>14.5 Encontre usuários ou organizações em que avg_score está entre 10,1 e 15,3 (excluso): avg_score>10.1 avg_score<15.3
Caixa de seleção	:	Encontre usuários ou organizações em que is_active é true: is_active:true
Data	>, <, >=, <=, :	Encontre usuários ou organizações em que subscription_date é anterior a 2013-06-23: subscription_date<2013-06-23 Encontre usuários ou organizações em que subscription_date está entre 2012-05-23 e 2013-06-23, (excluso) subscription_date>2012-05-23 subscription_date<2013-06-23
Relacionamento de pesquisa		Não há suporte para pesquisa por valores de campo de relacionamento de pesquisa.