Principal Central de Ajuda Como criar e usar filtros compartilhados de conversas e contatos

Como criar e usar filtros compartilhados de conversas e contatos

Última atualização em May 21, 2026

Quando usar

  • Você quer salvar um filtro personalizado de conversas ou contatos para reutilizar
  • Você quer compartilhar um filtro com o time todo (público) ou mantê-lo privado
  • Você está montando dashboards ou rotinas internas que dependem do mesmo filtro

Pré-requisitos

  • Estar logado no Cloud Chat
  • Para criar filtros públicos: precisa ter permissão (admin ou supervisor) — para privados, qualquer agente

Sobre este artigo

Esta FAQ explica como funcionam os filtros personalizados compartilhados, incluindo níveis de visibilidade, atualização em tempo real e permissões envolvidas.

Conceitos

Filtro personalizado (Custom View)

Combinação de condições salvas para contatos ou conversas, exibidas na barra lateral.

Tipos de filtro

  • conversation — filtros de conversas

  • contact — filtros de contatos

A tela detecta o tipo ativo e lista os filtros correspondentes.

Visibilidade

  • Privado — visível apenas para o proprietário (quem criou)

  • Público — visível para todos os usuários logados na conta

Como criar e editar filtros

Onde criar

No Dashboard, via modal de filtros avançados — botão Adicionar Filtro.

Fluxo

  1. A tela detecta o contexto (Contatos ou Conversas) e define o tipo automaticamente

  2. A visibilidade padrão é privada

  3. Ao salvar, você pode alterar para pública

Via API

GET     /api/v1/accounts/:account_id/custom_filters
POST    /api/v1/accounts/:account_id/custom_filters
PATCH   /api/v1/accounts/:account_id/custom_filters/:id
DELETE  /api/v1/accounts/:account_id/custom_filters/:id

Onde os filtros aparecem

  • Barra lateral — ao selecionar Conversas ou Contatos, a lista de filtros do tipo correspondente é carregada e atualizada em tempo real

Boas práticas

  • Nomeação clara — escolha nomes que indiquem propósito (ex: "Conversas abertas e snoozed")

  • Evite duplicados — ao editar um filtro público, prefira atualizar o existente em vez de criar novo com nome similar

  • Visibilidade consciente — use público quando o filtro for útil pra todo o time; mantenha privado para casos pessoais ou experimentais

Observações