Como Usar a Sintaxe KQL na Barra de Pesquisa do Outlook na Web

O Outlook na Web inclui uma barra de pesquisa que vai além de buscas simples por palavras-chave. Você pode usar a Keyword Query Language (KQL) para criar pesquisas precisas filtrando por remetente, data, tipo de anexo e outras propriedades da mensagem. Muitos usuários digitam termos básicos e rolam os resultados, mas o KQL permite encontrar qualquer e-mail em segundos. Este artigo explica as regras de sintaxe KQL que funcionam no Outlook na Web e mostra como criar consultas de pesquisa eficazes.

O que a Sintaxe KQL Faz no Outlook na Web

A Keyword Query Language é uma sintaxe de consulta estruturada usada por tecnologias de busca da Microsoft, incluindo SharePoint, Exchange e Outlook na Web. Quando você digita uma consulta na barra de pesquisa do Outlook na Web, o servidor analisa o texto e aplica filtros de propriedade antes de retornar os resultados. Diferentemente da pesquisa de texto simples, que verifica cada palavra no corpo da mensagem e metadados, o KQL limita a varredura a campos específicos. Isso reduz o número de resultados irrelevantes e acelera o processo de busca.

O Outlook na Web suporta propriedades KQL para campos comuns de e-mail. Isso inclui from para o remetente, to para o destinatário, subject para o assunto, hasattachment para presença de anexo e received para filtragem por data. Você pode combinar vários filtros de propriedade em uma única consulta usando os operadores AND, OR e NOT. A barra de pesquisa também suporta aspas para correspondência exata de frases e parênteses para agrupar condições.

Nenhuma configuração especial ou complemento é necessário. O KQL funciona na barra de pesquisa padrão no topo da interface do Outlook na Web. A sintaxe não diferencia maiúsculas de minúsculas, então FROM:joão e from:João retornam os mesmos resultados. Valores de data devem usar um formato específico, e filtros de anexo usam valores booleanos true ou false.

Como Criar Consultas de Pesquisa KQL no Outlook na Web

Abra o Outlook na Web em qualquer navegador moderno. A barra de pesquisa está localizada no centro superior da janela. Clique dentro da barra de pesquisa e digite sua consulta KQL. Pressione Enter para executar a pesquisa. Os resultados aparecem na lista de mensagens principal abaixo da barra de pesquisa.

As etapas a seguir cobrem os filtros de propriedade KQL mais comuns que você pode usar. Cada etapa mostra a sintaxe e um exemplo.

1. Pesquisar por remetente usando a propriedade from
   Digite from:nome ou endereço de e-mail na barra de pesquisa. Por exemplo, from:maria.silva@empresa.com retorna todas as mensagens enviadas por Maria Silva. Você também pode usar um nome de exibição parcial, como from:Maria, para corresponder a qualquer remetente cujo nome de exibição comece com Maria. O filtro from corresponde ao nome de exibição e ao endereço de e-mail armazenados no campo De.
2. Pesquisar por destinatário usando a propriedade to
   Digite to:nome ou endereço de e-mail. Por exemplo, to:suporte@empresa.com retorna mensagens onde o endereço especificado aparece no campo Para. O filtro to não inclui destinatários nos campos CC ou BCC. Para pesquisar destinatários em CC, use a propriedade cc:nome.
3. Pesquisar por assunto usando a propriedade subject
   Digite subject:palavra-chave ou frase. Por exemplo, subject:orçamento retorna mensagens com a palavra orçamento no assunto. Para corresponder a uma frase exata, use aspas: subject:”revisão trimestral” retorna mensagens com exatamente revisão trimestral no assunto.
4. Filtrar por anexo usando hasattachment
   Digite hasattachment:true para mostrar apenas mensagens com anexos. Digite hasattachment:false para mostrar apenas mensagens sem anexos. Este filtro é booleano e não aceita outros valores.
5. Filtrar por data usando a propriedade received
   Digite received:data em um destes formatos: received:2024-01-15 para uma data específica, received:>2024-01-01 para mensagens após uma data, received:<2024-06-01 para mensagens antes de uma data, ou received:2024-01-01..2024-01-31 para um intervalo de datas. O formato da data é AAAA-MM-DD. Você também pode usar datas relativas como received:today, received:yesterday ou received:this week.
6. Combinar várias propriedades com operadores booleanos
   Use AND, OR e NOT para unir condições. Por exemplo, from:maria AND hasattachment:true retorna mensagens de Maria que têm anexos. subject:relatório OR subject:resumo retorna mensagens com qualquer uma das palavras no assunto. from:maria NOT hasattachment:true retorna mensagens de Maria sem anexos. Os operadores devem estar em maiúsculas. Você pode usar parênteses para agrupar: (from:maria OR from:joão) AND hasattachment:true.
7. Pesquisar frases exatas com aspas
   Coloque uma frase de várias palavras entre aspas duplas para pesquisar essa sequência exata. Por exemplo, “reunião cancelada” retorna mensagens contendo a frase exata reunião cancelada. Isso funciona no corpo, assunto e outros campos de texto.

Erros Comuns ao Usar KQL no Outlook na Web

Consulta KQL não retorna resultados

A causa mais comum é um erro de digitação no nome da propriedade ou no valor. Verifique se o nome da propriedade está em minúsculas e seguido por dois pontos sem espaço. Por exemplo, from :maria com espaço antes dos dois pontos é inválido. Confirme também que o formato da data é AAAA-MM-DD e que o endereço de e-mail ou nome de exibição está correto. Se você usar um nome parcial, certifique-se de que ele corresponde ao início do nome de exibição ou endereço de e-mail.

Operadores booleanos não funcionam como esperado

Os operadores booleanos devem estar em maiúsculas e colocados entre os filtros de propriedade. A consulta from:maria and hasattachment:true falha porque and está em minúsculas. Use from:maria AND hasattachment:true em vez disso. Evite também misturar texto simples com filtros de propriedade sem operadores. Por exemplo, from:maria orçamento pode tratar orçamento como um termo de pesquisa de texto separado. Use from:maria AND orçamento para combiná-los corretamente.

Filtro hasattachment retorna resultados inconsistentes

O filtro hasattachment detecta apenas arquivos anexados à mensagem. Ele não detecta imagens inline incorporadas no corpo da mensagem ou anexos em itens de calendário. Se você precisar encontrar mensagens com tipos de arquivo específicos, não pode usar uma propriedade KQL para extensão de arquivo no Outlook na Web. Use a pesquisa de texto geral com a extensão do arquivo, como .pdf.

Consulta de intervalo de datas retorna mensagens fora do intervalo

A sintaxe de intervalo com dois pontos usa dois pontos sem espaços. A consulta received:2024-01-01 .. 2024-01-31 com espaços ao redor dos pontos é inválida. Escreva como received:2024-01-01..2024-01-31. Observe também que o intervalo é inclusivo em ambos os extremos.

Filtros de Propriedade KQL vs Pesquisa de Texto Simples no Outlook na Web

Item	Filtros de Propriedade KQL	Pesquisa de Texto Simples
Escopo da pesquisa	Campos específicos como De, Assunto ou Data de recebimento	Todos os campos indexados, incluindo corpo, assunto, remetente e anexos
Precisão	Alta — retorna apenas itens que correspondem ao campo especificado	Baixa — retorna qualquer item que contenha a palavra-chave em qualquer lugar
Filtragem por data	Suportada com a propriedade received e sintaxe de intervalo	Não suportada nativamente sem clicar no botão de filtro
Filtragem por anexo	Suportada com hasattachment:true ou false	Não suportada nativamente
Operadores booleanos	AND, OR, NOT suportados	Não suportados — todos os termos são implicitamente AND
Correspondência exata de frases	Suportada com aspas duplas	Suportada com aspas duplas
Curva de aprendizado	Moderada — requer memorizar nomes de propriedades e sintaxe	Baixa — funciona como qualquer mecanismo de busca na web

Agora você pode usar a sintaxe KQL no Outlook na Web para encontrar e-mails por remetente, destinatário, assunto, status de anexo e intervalo de datas. Tente combinar a propriedade from com hasattachment:true para localizar arquivos de uma pessoa específica. Para filtragem avançada, use a propriedade received com um intervalo de datas e o operador AND para refinar ainda mais os resultados. Lembre-se de que os nomes das propriedades não diferenciam maiúsculas de minúsculas, mas devem ser seguidos por dois pontos sem espaço.