> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisar contatos e histórico de conversas

> Guia de uso da função de pesquisa de histórico de conversas do Inbox

### Apresentação da funcionalidade

O Inbox adicionou uma nova função de pesquisa para ajudar a equipe de atendimento ao cliente a localizar rapidamente conversas históricas e informações de contato. Ela oferece suporte a dois modos de pesquisa:

* **Pesquisa global**: Pesquise em todas as conversas e contatos
* **Pesquisar na conversa**: Pesquise mensagens históricas na conversa individual aberta no momento

### 1. Pesquisa global (Web)

#### Como acessar

Clique no ícone de pesquisa ao lado de **Conversa** e escolha um modo de pesquisa.

<Frame caption="Click the search icon and choose Contact or Message.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/inbox-search-menu.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=3ebb880ae6f0528a30b2ccb8c2d1a1a8" alt="Menu de pesquisa de contatos e mensagens do Inbox" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/inbox-search-menu.png" />
</Frame>

#### Pesquisa de contatos

Selecione **Contato** no menu de pesquisa. **Pesquisas suportadas:**

* Nome do contato (pesquisa aproximada, não diferencia maiúsculas de minúsculas)
* Número de telefone do contato (correspondência exata)

**O cartão de resultados inclui:** iniciais do avatar, nome, número de telefone, prévia da última mensagem, horário da mensagem e atendente associado

**Clicar no resultado:** Vá diretamente para a conversa correspondente.

**Nova conversa:** Independentemente de os resultados da pesquisa estarem vazios ou não, a página sempre exibe o botão "+ Criar nova conversa". Ao clicar nele, a janela pop-up de nova conversa será aberta e o número inserido será preenchido automaticamente.

<Frame caption="Search for a contact or create a new conversation from the results.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/inbox-contact-search-annotated.svg?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=4a84cb73111d55572145a71baa7732d4" alt="Pesquisa por telefone de contato no espaço de trabalho completo do Inbox" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/inbox-contact-search-annotated.svg" />
</Frame>

#### Pesquisa de mensagens

Abra o menu de pesquisa no Inbox e selecione **Mensagem** para pesquisar o histórico de mensagens.

**Pesquisas suportadas:**

* Conteúdo de mensagens de texto
* Parte de texto de mensagens com imagem/gráficas

**Intervalo de tempo da pesquisa:** Por padrão, suporta registros de mensagens do último 1 ano.**Critérios de filtro:**

* **Atendente**: Suporta pesquisa aproximada, seleção múltipla disponível
* **Horário**: Selecione a data/hora de início e término

**O cartão de resultados inclui:** iniciais do avatar do remetente, nome do remetente, informações de contato, trecho do conteúdo da mensagem (palavra-chave destacada), horário da mensagem

<Frame caption="Enter a keyword and use Agent or Time Range to narrow message history. This view is shown before a search is run.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/inbox-message-search-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=12c62ea54d8dfa4ed0c3630a1938f647" alt="Pesquisa de histórico de mensagens no Inbox com filtros de atendente e intervalo de tempo." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/inbox-message-search-annotated.svg" />
</Frame>

**Clicar no resultado:**

* Clicar na linha do título da conversa: Expande ou recolhe a lista de mensagens desta conversa
* Clicar no botão "Ir para": Vai para a conversa correspondente
* Clicar no lado direito da linha de uma mensagem específica: Um painel de pré-visualização será exibido, mostrando o contexto dentro de 24 horas antes e depois daquela mensagem
* Clicar no botão "Ir para" de uma mensagem específica: Vai para a posição dessa mensagem na conversa correspondente, onde a mensagem será destacada por 2 segundos e depois voltará ao normal

#### Fechar pesquisa

Clique no **X** ao lado da pesquisa de contatos ou em **Fechar** na caixa de diálogo de pesquisa de mensagens para retornar ao Inbox.

<Frame caption="Select the X in the search dialog to close message search.">
  <img src="https://mintcdn.com/lchnan/INCfGITGB_rYG20v/product-assets/inbox/message-search-results-dialog.png?fit=max&auto=format&n=INCfGITGB_rYG20v&q=85&s=9a93ab8839a476dd8cbe321a7e7ccb13" alt="Caixa de diálogo de pesquisa de mensagens do Inbox mostrando mensagens correspondentes, uma prévia da conversa e o botão fechar" width="1919" height="953" data-path="product-assets/inbox/message-search-results-dialog.png" />
</Frame>

<Frame caption="Closing search returns you to the open Inbox conversation.">
  <img src="https://mintcdn.com/lchnan/INCfGITGB_rYG20v/product-assets/inbox/message-search-closed-conversation.png?fit=max&auto=format&n=INCfGITGB_rYG20v&q=85&s=4401a3dc01d39188a396166e48102dfb" alt="Conversa do Inbox exibida após fechar a caixa de diálogo de pesquisa de mensagens" width="1917" height="957" data-path="product-assets/inbox/message-search-closed-conversation.png" />
</Frame>

### 2. Pesquisa na conversa (Web)

#### Como acessar

Após abrir qualquer conversa, clique no ícone de pesquisa no canto superior direito da área de detalhes da conversa à direita.

#### Como usar

1. Clique no ícone de pesquisa para expandir a caixa de pesquisa
2. Digite as palavras-chave e o sistema pesquisará nas mensagens históricas da sessão atual em tempo real
3. Ao passar o cursor sobre uma mensagem na lista de resultados da pesquisa, uma cor de fundo é exibida
4. Clique em uma mensagem e ela irá rolar automaticamente até a posição dessa mensagem

**Escopo da pesquisa:** Todas as mensagens históricas dentro da conversa atual (incluindo mensagens enviadas pelo atendimento ao cliente e pelo cliente)

<Frame caption="Search within the open conversation and select a result to jump to the message.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/inbox-history-search.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=cd3a2740ff3d14bd9ad48f0588db9c0d" alt="Painel de pesquisa no histórico de conversas com uma resposta de demonstração correspondente" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/inbox-history-search.png" />
</Frame>

**Critérios de filtro:**

* **Participante**: Filtre os registros de mensagens por remetente
* **Horário**: Selecione a data/hora de início e término

**Regras de destaque:**

* Item atualmente selecionado na lista de resultados: fundo cinza
* Palavras-chave correspondentes na lista: marcadas em negrito ou cor especial
* Itens correspondentes dentro da caixa de diálogo: destacados em amarelo claro

**Quando não houver resultados:** Exibe um aviso de nenhum resultado, mantém a caixa de pesquisa aberta e permite que os usuários continuem modificando as palavras-chave.

### 3. Pesquisa no celular

#### Pesquisa global

1. Clique no botão de pesquisa e, por padrão, ele entrará na pesquisa de "Contatos"
2. Clique no botão de alternância para alternar entre "Contatos" e "Mensagens"
3. A pesquisa de mensagens suporta apenas a busca aproximada do conteúdo da conversa, **não** filtrando por atendente ou horário
4. O intervalo de tempo da pesquisa é consistente com a versão Web (último 1 ano)

<Frame caption="Switch between Contacts and Messages when using global search on mobile.">
  <img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/9e49d4b04f-mobile-1-3-4-1920x1080-masked.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=fe265258724fe4e5f22ee380af58831c" alt="Pesquisa global de contatos e mensagens no aplicativo móvel YCloud Inbox" width="1920" height="1080" data-path="product-assets/9e49d4b04f-mobile-1-3-4-1920x1080-masked.webp" />
</Frame>

#### Pesquisa na conversa

1. Acesse a Página de detalhes da conversa (Detalhes)
2. Clique no botão 「Pesquisar histórico de conversas」 para entrar na página de pesquisa
3. Digite as palavras-chave para pesquisar o conteúdo da sessão atual
4. Clique em "Cancelar" para retornar à página de detalhes

<div style={{ maxWidth: "260px", margin: "0 auto" }}>
  <Frame>
    <img src="https://mintcdn.com/lchnan/Z2X3BzyqaivSGKDr/product-assets/5ca6c63a93-final.webp?fit=max&auto=format&n=Z2X3BzyqaivSGKDr&q=85&s=b0cbd78c556ab4720dec1611b9808ad7" alt="Pesquisa na conversa no aplicativo móvel YCloud Inbox" width="2160" height="4696" data-path="product-assets/5ca6c63a93-final.webp" />
  </Frame>
</div>

### Perguntas frequentes

**P: Quantos caracteres precisam ser inseridos, no mínimo, para acionar uma pesquisa?**&#x20;

R: Inserir 1 caractere é suficiente para acionar uma pesquisa em tempo real.

**P: Até quando a pesquisa de mensagens pode retroceder?**&#x20;

R: O recurso de pesquisa global suporta registros de mensagens do último 1 ano, e a página exibirá os avisos correspondentes. A pesquisa de mensagens dentro de uma conversa não tem limite de tempo.

**P: Quais campos a pesquisa de contatos suporta?**&#x20;

R: Ela suporta o nome do contato (pesquisa difusa/aproximada) e o número de telefone (correspondência exata).

**P: Quais tipos de conteúdo a pesquisa de mensagens suporta?**&#x20;

R: Suporta mensagens de texto simples e a parte de texto de mensagens com imagem e texto. No momento, o conteúdo da imagem não suporta pesquisa.

**P: Após alternar entre as abas de contato/mensagem, o conteúdo inserido anteriormente continuará lá?**&#x20;

R: Não. Após alternar as abas, o conteúdo na caixa de entrada será limpo automaticamente e você precisará inserir as palavras-chave novamente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.