As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Pesquisar contatos concluídos e em andamento no Amazon Connect
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. Depois de 20 de maio de 2026, você não poderá mais acessar o Voice ID no console do Amazon Connect, acessar os recursos do Voice ID no site do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Este tópico é para administradores e gerentes de contact center que precisam pesquisar contatos usando o site Amazon Connect administrativo. Para saber APIs como pesquisar contatos programaticamente, consulte. [APIs para pesquisar contatos](#apis-search-contacts)
**Topics**
+ [O que é importante saber](#important-contact-search)
+ [Principais recursos de pesquisa](#key-search-features)
+ [Gerenciar quem pode pesquisar contatos e acessar informações detalhadas](#required-permissions-search-contacts)
+ [Como pesquisar um contato](#how-to-search-contacts)
+ [Campos adicionais: adicionar colunas aos resultados de pesquisa](#additional-fields)
+ [Baixar resultados da pesquisa](#download-search-results)
+ [APIs para pesquisar contatos](#apis-search-contacts)
+ [Pesquisar contatos em andamento no Amazon Connect](search-in-progress-contacts.md)
+ [Pesquisar contatos no Amazon Connect usando atributos de contato personalizados ou atributos de segmento de contato](search-custom-attributes.md)
## O que é importante saber
+ É possível pesquisar contatos de até dois anos atrás.
+ Você pode pesquisar contatos concluídos e em andamento. Para contatos tratados por agentes, um contato só é marcado como concluído após o agente ter concluído o After Contact Work (ACW).
+ A capacidade de pesquisar contatos em andamento varia de acordo com o canal (consulte [Modelo de dados de eventos de contato](contact-events.md#contact-events-data-model) para referência):
+ **Voz**
+ Você pode pesquisar retornos de chamada em andamento depois que eles estiverem na fila, conectados a um agente ou desconectados.
+ Para outros contatos de voz, você pode pesquisá-los somente depois que eles estiverem conectados a um agente ou terem sido desconectados. **Os contatos de voz em andamento na fila (com exceção dos retornos de chamada) não são exibidos na página de pesquisa de contatos.**
+ **Chat**: você pode pesquisar contatos depois que eles estão conectados ao sistema, na fila, conectados a um atendente ou desconectados.
+ **Tarefas** e **E-mail**: é possível pesquisar todas as tarefas em andamento depois que elas são iniciadas.
+ Os resultados da pesquisa para uma determinada consulta são limitados aos primeiros 10 mil resultados retornados.
+ Você não pode pesquisar vários contatos IDs ao mesmo tempo.
## Principais recursos de pesquisa
+ [Pesquise por atributos de contato personalizados](search-custom-attributes.md) (atributos definidos pelo usuário).
+ [Pesquise contatos que estão em andamento](search-in-progress-contacts.md) ou foram concluídos usando o filtro **Status do contato**.
+ Pesquise um intervalo de tempo de até oito semanas. No filtro Período, você pode especificar o tipo de **Tipo de timestamp**. Isso permite que você especifique o intervalo de tempo. É possível escolher entre carimbos de data e hora iniciados, conectados ao atendente, desconectados e programados.
**Importante**
O filtro Período na pesquisa de contatos tem o tipo de carimbo de data e hora definido como “Iniciado” por padrão. Antes da introdução da seleção do tipo de carimbo de data/hora, o tipo usado pelo filtro Intervalo de tempo era “Desconectado”.
As pesquisas salvas em Pesquisa de contato criadas antes do lançamento do recurso de pesquisa de contatos em andamento (lançada em setembro de 2023) foram atualizadas com os filtros Status do contato igual a “Concluído” e Tipo de timestamp = “Desconectado”. Essas seleções estavam implícitas antes do lançamento de contatos em andamento.
+ Filtros de seleção múltipla para nomes de atendentes, filas de contatos e o nome do fluxo inicial do contato.
+ Filtro para hierarquia de atendentes. É possível aplicar filtros progressivamente para detalhar os níveis da hierarquia de atendentes.
**nota**
Ao selecionar vários valores em qualquer nível hierárquico, você não pode filtrar nos próximos níveis hierárquicos.
+ Filtre contatos por canal e subtipo de canal, como SMS.
+ Filtre para pesquisar contatos de e-mail usando endereço de e-mail (Para, De e CC) e assunto. A pesquisa por assunto de e-mail não diferencia maiúsculas de minúsculas. Além disso, pesquisar um subconjunto de palavras em um assunto de e-mail fornece resultados de pesquisa. Por exemplo, se você inserir uma **consulta**, o Amazon Connect exibirá e-mails com o assunto **Consulta do cliente**.
+ Filtros para [análise de conversas](analyze-conversations.md). Você pode pesquisar contatos que tenham a análise conversacional ativada. Por exemplo, análise **conversacional: a interação entre voz e agente** retorna contatos em que a interação do agente foi analisada pela análise conversacional. Você pode [search for Contact categories](search-conversations.md#contact-category-search)especificando o nome completo da categoria. Escolha pesquisar usando **Corresponder a qualquer item** ou **Corresponder a todos** ou **Corresponder nenhum**. Por exemplo, você pode pesquisar contatos com “categoria A” e “categoria B”, ou com qualquer uma das duas categorias.
Você pode consultar a lista completa de filtros [here](search-conversations.md)de análise conversacional. Você pode aplicar esses filtros somente se sua organização tiver habilitado o Contact Lens.
Na caixa suspensa **Adicionar filtro**, os filtros do Contact Lens têm **CL** ao lado deles. Você poderá aplicar esses filtros somente se sua organização tiver habilitado o Contact Lens.
![\[A página Pesquisa de contato, a seção Filtros e o menu suspenso Adicionar filtro.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-lens-search-contact-category-1.png)
Se você quiser remover os filtros do Contact Lens da lista suspensa de um usuário, remova as seguintes permissões do perfil de segurança:
+ **Pesquisar contatos por conversa**: essa opção controla o acesso às pontuações de sentimentos, ao tempo sem conversa e às pesquisas por categoria.
+ **Pesquisar contatos por palavras-chave**: essa opção controla o acesso à pesquisa por palavras-chave.
+ **Contact Lens - analytics de conversação**: na página **Detalhes do contato**, são exibidos grafos que resumem a analytics de conversação.
+ Filtros para gravações. Usando o filtro de **gravação**, você pode filtrar os contatos com uma gravação de tela (vídeo) ou gravação de áudio (voz).
+ Filtro por região ativa. Pesquise contatos pela região da AWS em que eles foram tratados. Esse filtro está disponível para instâncias do Amazon Connect usando resiliência global, onde os contatos podem ser tratados em uma região da AWS diferente da região em que você está conectado.
**Importante**
Alguns recursos do Amazon Connect podem estar indisponíveis ao acessar dados de contato entre regiões. Para obter detalhes completos, consulte [Como configurar o Amazon Connect Global Resiliency](setup-connect-global-resiliency.md) o.
+ Filtros para o [Voice ID](voice-id.md). É possível pesquisar o status dos contatos com a autenticação e detecção de fraudes do Voice ID, se sua organização o tiver habilitado. Para acessar essa funcionalidade, no perfil de segurança, você precisa da permissão **Análise e otimização**, **Voice ID - atributos e pesquisa**, **Visualizar**.
A imagem a seguir mostra os filtros disponíveis para pesquisar o Voice ID: **Resultado da autenticação**, **Resultado da detecção de fraudes**, **Ações do palestrante**.
![\[O menu suspenso do filtro e os filtros para o Voice ID.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-search-filters.png)
## Gerenciar quem pode pesquisar contatos e acessar informações detalhadas
Antes que os usuários possam pesquisar contatos no Amazon Connect ou acessar informações detalhadas de contato, eles precisam ser atribuídos ao perfil de **CallCenterManager**segurança ou ter as seguintes permissões de **análise e otimização**:
+ É necessária pelo menos uma das seguintes permissões para visualizar os contatos nas páginas **Pesquisa de contato** e **Detalhes de contato**:
+ **Pesquisa de contato - Visualizar**: permite que o usuário acesse todos os contatos nas páginas **Pesquisa de contato** e **Detalhes de contato**.
+ **Visualizar meus contatos - Visualizar**: nas páginas **Pesquisa de contato** e **Detalhes de contato**, essa opção permite que os atendentes visualizem somente os contatos com os quais eles lidaram.
+ **Restrinja o acesso do contato** (opcional): gerencie o acesso de um usuário aos resultados na página **Pesquisa de contato** com base no grupo hierárquico do atendente. Por exemplo:
+ Os agentes atribuídos a AgentGroup -1 só podem visualizar registros de contatos gerenciados por agentes nesse grupo hierárquico e em qualquer grupo abaixo deles. (Se eles tiverem permissões para **Conversas gravadas**, também poderão ouvir gravações de chamadas e visualizar transcrições.)
+ Agentes atribuídos a AgentGroup -2 só podem acessar registros de contatos gerenciados por seu grupo e quaisquer grupos abaixo deles.
+ Gerentes e outras pessoas que estão em grupos de nível superior podem visualizar registros de contatos gerenciados por todos os grupos abaixo deles, como AgentGroup -1 e 2.
Para essa permissão, **Tudo** = **Visualizar** por **Visualizar** é a única ação concedida.
Para obter mais informações sobre grupos hierárquicos, consulte [Organizar atendentes em equipes e grupos para geração de relatórios e acesso por meio da criação de hierarquias](agent-hierarchy.md).
**Importante**
A exclusão de um nível hierárquico rompe o vínculo com os contatos existentes. Essa ação não pode ser desfeita.
Quando você altera o grupo hierárquico de um usuário, pode levar alguns minutos para que os resultados da pesquisa de contatos reflitam as novas permissões.
A tabela a seguir lista as permissões típicas e quais contatos podem ser visualizados nas páginas **Pesquisa de contato** e **Detalhes do contato**.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/contact-search.html)
**Importante**
Não recomendamos atribuir permissões em nenhuma outra combinação além da mostrada na tabela anterior.
+ **Contact Lens - analytics de conversação**: na página **Detalhes do contato** de um contato, você pode visualizar grafos que resumem a analytics de conversação: tendência de sentimento do cliente, sentimento e tempo sem conversa.
+ **Gravações de chamadas (editadas) - Acessar**: se sua organização usa o Contact Lens, você pode atribuir essa permissão para que os atendentes acessem somente as gravações de chamadas de atendentes nas quais houve edição de dados sensíveis.
+ **Transcrições de contato (editadas) - Acessar**: se sua organização usa o Contact Lens, você pode atribuir essa permissão para que os atendentes acessem somente as transcrições de contato nas quais houve edição de dados sensíveis.
+ **Gravações de chamadas (não editadas) - Acessar**: use essa permissão para gerenciar quem pode acessar as gravações nas páginas **Pesquisa de contatos** e **Detalhes do contato**. Se desejar, você pode usar **Restrinja acesso do contato** para garantir que eles tenham acesso somente às informações detalhadas dos contatos atendidos pelo grupo hierárquico.
+ **Transcrições de contato (não editadas) - Acessar**: use essa permissão para gerenciar quem pode visualizar conversas de chat e e-mail e transcrições de voz não editadas produzidas pelo Contact Lens nas páginas **Pesquisa de contato** e **Detalhes do contato**. Se desejar, você pode usar **Restrinja acesso do contato** para garantir que eles tenham acesso somente às informações detalhadas dos contatos atendidos pelo grupo hierárquico.
+ **Formulários de avaliação - realizar avaliações**: permite que os usuários [pesquisem avaliações por](search-evaluations.md) formulário de avaliação, pontuação, data/intervalo da última atualização, avaliador e status.
+ **Voice ID - atributos e pesquisa**: se sua organização usa o Voice ID, os usuários com essa permissão podem pesquisar e visualizar os resultados do Voice ID na página **Detalhes de contato**.
+ **Usuários - Visualizar**: você deve ter essa permissão para usar o filtro **Atendente** na página **Pesquisa de contato**.
Por padrão, o **administrador** e os perfis de **CallCenterManager**segurança do Amazon Connect têm essas permissões.
Para obter informações sobre como adicionar mais permissões a um perfil de segurança existente, consulte [Atualizar perfis de segurança no Amazon Connect](update-security-profiles.md).
## Como pesquisar um contato
1. Faça login no Amazon Connect com uma conta de usuário que tenha [permissões para acessar gravações](#required-permissions-search-contacts).
1. No Amazon Connect, escolha **Análise e otimização**, **Pesquisa de contato**.
1. Use os filtros na página para restringir sua pesquisa. Para data, você pode pesquisar até oito semanas por vez.
**dica**
Para ver se uma conversa foi gravada, você precisa ser atribuído a um perfil que tenha permissões de **Manager monitor (Monitor de gerente)**. Se uma conversa foi gravada, por padrão, o resultado da pesquisa indicará isso com um ícone na coluna **Recording (Gravação)**. Você não verá esse ícone se não tiver permissão para revisar as gravações.
## Campos adicionais: adicionar colunas aos resultados de pesquisa
Use as opções em **Campos adicionais** para adicionar colunas aos resultados de pesquisa. Essas opções não são usadas para filtrar a pesquisa.
Por exemplo, se você quiser incluir colunas para **Nome completo do agente** e **Perfil de roteamento** na saída da pesquisa, escolha essas colunas aqui.
**dica**
A opção **Foi transferido para fora** indica se o contato foi transferido para um número externo. Sobre a data e hora (no horário UTC) em que a transferência foi conectada, consulte `TransferCompletedTimestamp` em [ContactTraceRecord](ctr-data-model.md#ctr-ContactTraceRecord).
## Baixar resultados da pesquisa
Você pode baixar até três mil resultados de pesquisa por vez.
## APIs para pesquisar contatos
Use o seguinte APIs para pesquisar contatos programaticamente:
+ [SearchContacts](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html)
+ [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)
+ [DescribeContactEvaluation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContactEvaluation.html)
# Pesquisar contatos em andamento no Amazon Connect
Quando um contato é processado por um atendente, ele é considerado **Em andamento** enquanto o atendente não concluir o trabalho pós-atendimento. Com relação a um contato que nunca é processado por um atendente, ele é considerado **Em andamento** até o momento em que o contato for desconectado.
**Topics**
+ [Permissões necessárias para pesquisar contatos em andamento](#permissions-inprogress)
+ [Estados de contato aceitos pela pesquisa de contato](#contactstates-inprogress)
+ [Como pesquisar contatos em andamento](#howto-search-inprogress)
+ [Filtrar contatos usando tipos de carimbo de data e hora](#filter-by-timestamp)
+ [Visualizar contatos em andamento](#view-inprogress-contacts)
+ [Analisar transcrições em tempo real](#review-realtime-transcripts)
## Permissões necessárias para pesquisar contatos em andamento
As permissões necessárias para pesquisar contatos em andamento são as mesmas para pesquisar contatos concluídos. Para obter mais informações, consulte [Gerenciar quem pode pesquisar contatos e acessar informações detalhadas](contact-search.md#required-permissions-search-contacts).
## Estados de contato aceitos pela pesquisa de contato
A capacidade de pesquisar contatos em andamento varia de acordo com o canal (consulte [Modelo de dados de eventos de contato](contact-events.md#contact-events-data-model) para referência):
+ **Voz**
+ Você pode pesquisar retornos de chamada em andamento depois que eles estiverem na fila, conectados a um agente ou desconectados.
+ Para outros contatos de voz, você pode pesquisá-los somente depois que eles estiverem conectados a um agente ou terem sido desconectados. **Os contatos de voz em andamento na fila (com exceção dos retornos de chamada) não são exibidos na página de pesquisa de contatos.**
+ **Chat**: você pode pesquisar contatos depois que eles estão conectados ao sistema, na fila, conectados a um atendente ou desconectados.
+ **Tarefas** e **E-mail**: é possível pesquisar todas as tarefas em andamento depois que elas são iniciadas.
## Como pesquisar contatos em andamento
1. Faça login no Amazon Connect com uma conta de usuário que tenha [permissões para acessar gravações](contact-search.md#required-permissions-search-contacts).
1. No Amazon Connect, escolha **Análise e otimização**, **Pesquisa de contato**.
1. Selecione o filtro **Status do contato** e altere o valor selecionado para **Em andamento**. O status padrão do contato é **Concluído**.
![\[O filtro Em andamento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-in-progress-filter.png)
## Filtrar contatos usando tipos de carimbo de data e hora
Você pode pesquisar contatos em determinado estado de contato usando **Tipo de timestamp** dentro do filtro **Período**. Por exemplo, você pode pesquisar contatos de tarefas programados para o dia seguinte selecionando **Status do contato = Em andamento**, **Tipo de timestamp = Programado** e a data apropriada dentro do **Período**.
Os seguintes tipos de carimbo de data e hora são aceitos: iniciado, conectado (ao atendente), desconectado e programado. Quando você pesquisa contatos usando determinado **Tipo de timestamp**, os resultados da pesquisa não contêm contatos que não tenham esse carimbo de data e hora preenchido; por exemplo, se pesquisar um contato com **Tipo de timestamp = Desconectado** e e **Status do contato = Em andamento**, você só visualizará os contatos que estão no estado de trabalho pós-atendimento.
**Importante**
O filtro **Intervalo de tempo** na página **Pesquisa de contato** tem o **Tipo de carimbo de data/hora** definido como **Iniciado** por padrão. Antes da introdução da seleção do tipo de carimbo de data e hora, o tipo usado pelo filtro **Período** era **Desconectado**.
As pesquisas salvas em **Pesquisa de contato** criadas antes do lançamento do recurso de pesquisa de contatos em andamento (lançada em setembro de 2023) foram atualizadas com os filtros **Status do contato = Concluído** e**Tipo de timestamp = Desconectado**. Essas seleções estavam implícitas antes do lançamento de contatos em andamento.
## Visualizar contatos em andamento
Você pode clicar em um ID de contato nos resultados de **Pesquisa de contato** para ver os detalhes de um contato em andamento.
![\[Exiba um contato em andamento.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-in-progress-view.png)
### O que é importante saber
+ A página **Detalhes de contato** de um contato em andamento mostra os dados disponíveis no momento em que a página **Detalhes de contato** foi aberta. Ela não é atualizada automaticamente à medida que o contato progride. É necessário atualizar manualmente o navegador usando o navegador.
+ Alguns campos em **Pesquisa de contato** e **** podem conter informações ausentes ou inconsistentes enquanto o contato está em andamento. Após a conclusão de um contato é concluído, as informações acabam ficando consistentes com o registro de contato subjacente, depois que a página é atualizada manualmente.
+ Pode haver um atraso entre o momento em que um contato é **Concluído** e o momento em que é marcado como **Concluído** no registro do contato.
## Analisar transcrições em tempo real
Para contatos de voz, com a analytics de chamadas em tempo real habilitada, é possível visualizar as transcrições de um contato em tempo real na página **Detalhes do contato**, se tiver a permissão do perfil de segurança **Conversas gravadas (não editadas) - Acessar**.
**nota**
A redação não é compatível para contatos de voz em andamento. Usuários com a permissão **Transcrições de contato (não editadas) - Acessar** não podem visualizar contatos de voz em andamento.
Escolha o ícone de atualização na parte inferior da transcrição para obter os últimos turnos disponíveis da conversa. A imagem a seguir mostra a localização do ícone de atualização na página.
![\[Uma transcrição, o ícone de atualização na parte inferior da página.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-real-time-transcripts.png)
# Pesquisar contatos no Amazon Connect usando atributos de contato personalizados ou atributos de segmento de contato
Você pode criar filtros de pesquisa com base em atributos de contato personalizados (também chamados de [atributos de contato definidos pelo usuário](connect-attrib-list.md#user-defined-attributes)) ou atributos de segmento de contato.
Por exemplo, se você adicionar `AgentLocation` e `InsurancePlanType` aos registros de contato como atributos personalizados, poderá pesquisar contatos com valores específicos nesses atributos, como chamadas atendidas por atendentes localizados em Seattle ou chamadas feitas por clientes que compraram seguro residencial.
**Topics**
+ [Permissões necessárias para configurar atributos de contato pesquisáveis](#permissions-search-custom-attributes)
+ [Configurar atributos de contato personalizados pesquisáveis](#configure-search-custom-attributes)
+ [Editar, adicionar ou remover atributos de contato](#edit-add-remove-attribute-keys)
+ [Filtrar os resultados da pesquisa de contatos nos respectivos atributos](#howto-search-for-custom-attributes)
+ [Filtrar os resultados da pesquisa de contatos nos atributos do segmento](#filter-contact-search-segment)
## Permissões necessárias para configurar atributos de contato pesquisáveis
Por padrão, um atributo personalizado não é indexado enquanto alguém com as permissões apropriadas, como um administrador ou gerente, não especificar que ele deve ser pesquisável. Você concede permissões para selecionar usuários para que eles possam configurar quais atributos de contato personalizados podem ser adicionados como filtro de pesquisa.
Atribua as seguintes permissões ao perfil de segurança deles:
+ Habilite uma das seguintes permissões para acessar a página **Pesquisa de contato**:
+ **Pesquisa de contato**. Permite pesquisar todos os contatos.
+ **Visualizar meus contatos**: permite que os atendentes visualizem somente os contatos com quais eles lidaram.
+ **Atributos do contato**: permite que os usuários visualizem os atributos de contato. Também controla o acesso aos filtros de pesquisa com base nos atributos do contato.
+ **Configurar atributos de contato pesquisáveis**, **Tudo**: as pessoas que têm essa permissão determinam quais dados personalizados serão pesquisáveis (por pessoas que têm a permissão **Atributos do contato**). Isso permite acesso à seguinte página de configuração:
![\[A página Atributos de contato personalizados pesquisáveis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-custom-attributes-configuration-page.png)
## Configurar atributos de contato personalizados pesquisáveis
1. Na página **Pesquisa de contato**, escolha **Adicionar filtro**, **Atributo de contato personalizado**. Somente pessoas com permissões **Configurar atributos de contato pesquisáveis** em seus perfis de segurança veem essa opção.
![\[A página Pesquisa de contato, o menu suspenso Filtros e a opção Atributo de contato personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-custom-attributes-specify1.png)
1. Na primeira vez que você escolhe **Atributo de contato personalizado**, a caixa a seguir é exibida, indicando que nenhum atributo foi configurado para essa instância do Amazon Connect. Escolha **Especificar chaves de atributos pesquisáveis**.
![\[A opção Adicionar filtro e uma mensagem informando que nenhuma chave foi especificada para pesquisa.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-custom-attributes-specify2.png)
1. Na caixa **Chave de atributo**, digite o nome do atributo personalizado e escolha **Adicionar chave**.
**Importante**
Você deve digitar o nome exato da chave. Há diferenciação entre letras maiúsculas e minúsculas.
1. Quando terminar, escolha **Save (Salvar)**.
Os usuários poderão pesquisar essas chaves para qualquer contato futuro.
## Editar, adicionar ou remover atributos de contato
Para editar, adicionar ou remover chaves, escolha **Atributo**, **Configurações**. Caso não veja a opção **Configurações**, isso significa que não há permissões obrigatórias.
![\[A guia Adicionar filtro e a engrenagem de configurações no canto superior direito da página.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-search-custom-attributes-settings.png)
## Filtrar os resultados da pesquisa de contatos nos respectivos atributos
Os usuários que têm a permissão **Atributos do contato** nos perfis de segurança podem encontrar contatos usando os filtros de atributos de contato.
1. Na página **Pesquisa de contato**, escolha **Adicionar filtro**, **Atributo de contato personalizado** e selecione **Especificar chaves de atributos pesquisáveis**.
1. Na página **Atributos de contato personalizados pesquisáveis**, na caixa **Chave de atributo**, insira a chave de atributo e escolha **\$1Adicionar chave** e selecione **Salvar**.
1. Volte para a página **Pesquisa de contato**. Use **Adicionar filtro** para escolher no menu suspenso o atributo que você acabou de adicionar. Na caixa **Valor do atributo**, insira o valor que você deseja encontrar.
## Filtrar os resultados da pesquisa de contatos nos atributos do segmento
Depois de criar atributos predefinidos e anexá-los a um segmento de contato (explicado em [Usar atributos de segmento de contato](use-contact-segment-attributes.md)), você pode filtrar os resultados da pesquisa de contatos com base nos valores dos atributos do segmento.
A imagem a seguir mostra a página **Pesquisa de contato** e a opção de filtrar os resultados da pesquisa de contatos com base nos valores personalizados dos atributos do segmento.
![\[A página Pesquisar contato e o filtro Atributos de segmentos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/attribute-management-4.png)
1. Na página **Pesquisa de contato**, na lista suspensa **Adicionar filtro**, selecione **Atributos personalizados de segmentos de contato**.
1. Selecione o atributo predefinido que você deseja aplicar aos critérios de filtragem. Por exemplo, as imagens anteriores são exibidas Business-unit-name como o **nome do atributo**.
1. Se o atributo predefinido selecionado tiver valores estabelecidos, eles serão listados em **Valor(es) de atributo** como uma opção de seleção múltipla. Por exemplo, a imagem anterior mostra Contas, Faturamento, Atendimento ao cliente e Marketing como opções.
1. Escolha **Aplicar**.