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

# Filtros de Busca de Contatos

> Localize contatos no Invenio Center com filtros avançados: nome, e-mail, CPF/CNPJ, telefone, protocolo, tags, segmento e responsável. Combine critérios para buscas precisas.

O **painel de filtros** do Invenio Center permite localizar contatos cadastrados com precisão, combinando um ou mais critérios de busca simultaneamente.

**Caminho:** Invenio Center > Engajar > **Contatos**

<Tip>
  **Acesso direto:** [Contatos no Invenio Center](https://inveniocenter.robbu.global/painel/contatos)
</Tip>

<Frame caption="Tela de contatos com painel de filtros">
  <img src="https://storage.robbu.global/v2/file/86013AD5B5D939E27182C50CB63C6B97" />
</Frame>

***

## Como Realizar uma Busca

<Steps>
  <Step title="Preencher os filtros">
    No painel de filtros, preencha **um ou mais campos** com as informações do contato que deseja localizar.

    Você pode combinar quantos critérios precisar — quanto mais filtros preenchidos, mais precisa será a busca.

    <Frame caption="Painel de filtros de busca avançada de contatos">
      <img src="https://storage.robbu.global/v2/file/83E6FC6EE9A4F1BF04808D526FA723DF" />
    </Frame>
  </Step>

  <Step title="Executar a pesquisa">
    Clique em **"Pesquisar"** para exibir os resultados correspondentes aos filtros aplicados.
  </Step>

  <Step title="Limpar e reiniciar (opcional)">
    Use o botão **"Remover filtros"** para limpar todos os campos e iniciar uma nova busca do zero.
  </Step>
</Steps>

***

## Campos de Filtro Disponíveis

| Campo           | O que localiza                                                      |
| --------------- | ------------------------------------------------------------------- |
| **Nome**        | Contatos pelo nome completo ou razão social                         |
| **E-mail**      | Contatos pelo endereço de e-mail cadastrado                         |
| **CPF / CNPJ**  | Contatos pelo documento de identificação                            |
| **Código**      | Contatos pelo código do cliente (identificador único)               |
| **Protocolo**   | Contatos com base no número de protocolo de atendimentos anteriores |
| **Telefone**    | Contatos pelo número de telefone registrado                         |
| **Tags**        | Contatos agrupados por etiquetas temáticas, campanhas ou categorias |
| **Segmento**    | Contatos de uma carteira (segmento) específica                      |
| **Responsável** | Contatos vinculados a um atendente ou operador designado            |

<Tip>
  **Busca parcial:** A maioria dos campos aceita termos parciais — por exemplo, digitar parte do nome já retorna resultados correspondentes.
</Tip>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Gestão de Contatos" icon="address-book" href="https://docs.robbu.global/docs/center/contatos">
    Visualizar e editar contatos
  </Card>

  <Card title="Importação de Público" icon="users" href="https://docs.robbu.global/docs/center/publico-importacao">
    Importar contatos em massa via CSV
  </Card>

  <Card title="Criar Contato (Live)" icon="user-plus" href="https://docs.robbu.global/docs/live/criar-contato">
    Criar contato manualmente no Live
  </Card>

  <Card title="Segmentos" icon="layer-group" href="https://docs.robbu.global/docs/center/segmentos">
    Configurar e gerenciar segmentos
  </Card>
</CardGroup>

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="📍 Onde acesso os filtros de busca de contatos?">
    **Caminho:** Invenio Center > Engajar > Contatos

    Ao entrar na tela de contatos, o painel de filtros fica disponível na parte superior da listagem.

    **Acesso direto:** [Contatos](https://inveniocenter.robbu.global/painel/contatos)
  </Accordion>

  <Accordion title="🔍 Posso combinar múltiplos filtros em uma mesma busca?">
    **Sim!** O painel aceita **múltiplos critérios simultâneos**.

    **Exemplos de combinações:**

    * Nome + Segmento → encontrar contato específico em uma carteira
    * Tags + Responsável → listar todos os contatos de uma campanha com atendente específico
    * CPF + Protocolo → localizar atendimento exato de um cliente

    Quanto mais critérios, mais refinada e precisa será a busca.
  </Accordion>

  <Accordion title="🏷️ Como funciona o filtro por Tags?">
    O campo **Tags** filtra contatos que possuem uma ou mais etiquetas (hashtags) específicas cadastradas.

    **Utilidades:**

    * Agrupar contatos de uma campanha específica
    * Localizar contatos de um segmento temático (ex: "inadimplente", "VIP")
    * Filtrar públicos para exportação ou análise

    **Como adicionar tags a contatos:** As tags são atribuídas durante a importação (coluna `TAG` no CSV) ou manualmente na edição do contato.
  </Accordion>

  <Accordion title="❌ O que faz o botão 'Remover filtros'?">
    Limpa **todos os campos preenchidos** no painel de uma vez, permitindo iniciar uma nova busca do zero sem precisar apagar campo por campo.

    **Caminho:** Invenio Center > Engajar > Contatos > Botão **"Remover filtros"**
  </Accordion>

  <Accordion title="👤 Posso buscar contatos por atendente responsável?">
    **Sim!** Use o campo **Responsável** para filtrar todos os contatos vinculados a um operador específico.

    **Uso comum:** Verificar a carteira de contatos de um atendente durante monitoramento ou redistribuição de atendimentos.

    **Caminho:** Invenio Center > Engajar > Contatos > Campo **"Responsável"** > Pesquisar
  </Accordion>

  <Accordion title="📋 Posso buscar pelo número de protocolo?">
    **Sim!** O campo **Protocolo** localiza contatos com base no número de protocolo de atendimentos anteriores.

    **Útil para:**

    * Recuperar histórico de um atendimento específico
    * Localizar o contato de um protocolo informado pelo cliente
    * Auditorias e verificações de atendimento

    **Caminho:** Invenio Center > Engajar > Contatos > Campo **"Protocolo"** > Preencher > Pesquisar
  </Accordion>

  <Accordion title="📊 O que acontece se eu pesquisar sem preencher nenhum filtro?">
    Dependendo das configurações do ambiente, o sistema pode:

    * Exibir uma lista ampla de contatos cadastrados
    * Retornar uma mensagem solicitando ao menos um critério de busca

    **Boa prática:** Preencha ao menos um campo para garantir resultados relevantes e evitar lentidão ao carregar uma lista muito extensa.
  </Accordion>
</AccordionGroup>