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 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:
## 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.
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**.
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.
## 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 **\+Adicionar 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.
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**.