Darwin AI — Contatos (Contacts)

URL: https://app.getdarwin.ai/ou/{orgId}/contacts

---

1. Estrutura da Página

1.1 Cabeçalho

• Título: "Contatos" (heading nível 5)

---

2. Barra de Ações Superior

2.1 Filtros e Busca

Elemento	Tipo	Descrição
Buscar conversas...	Textbox	Campo de busca textual (placeholder: "Buscar conversas...")
Seletor de período	Button dropdown	Filtro por intervalo de datas (ex: "Apr 15, 2026 – Jul 14, 2026") com ícone de calendário
Atividade do lead	Dropdown	Filtro por nível de atividade do lead
Filtros	Button com badge	Abre painel de filtros avançados. Badge mostra contagem de filtros ativos (ex: "0")

2.2 Filtros Ativos (Chips)

Quando um filtro está ativo, aparece como chip removível abaixo da barra:

Elemento	Descrição
Intervalo de Datas de Atividade	Chip mostrando o range de datas aplicado (ex: "4/15/2026 – 7/14/2026") com botão (x) para remover

2.3 Ações em Lote

Ação	Tipo	Descrição
Visualizações Salvas	Button	Abre dropdown com visualizações de filtros salvas anteriormente
Exportar CSV	Button	Exporta a lista de contatos visível para arquivo CSV
Reprocessar campos personalizados	Button (desabilitado)	Exclusivo para usuários Darwin. Reprocessa campos personalizados dos contatos
Columns	Button	Gerencia visibilidade das colunas da tabela (mostrar/ocultar)

---

3. Tabela de Contatos

3.1 Colunas Padrão

Coluna	Descrição
Checkbox	Selecionar contato(s) para ações em lote. Checkbox no cabeçalho seleciona todos
Nome	Nome ou identificador do contato (ex: número de telefone) com ícone de plataforma
Tipo	Tipo de interação: Inbound (entrante) ou Outbound (campanha)
Status	Status atual do contato (ex: "FECHADO")
Canal	Canal de comunicação + usuário atribuído (ex: "Raphael Porto [ChatUI]")
Lead	Identificador do lead no canal
Pipeline	Pipeline associado ao contato (ou "-" se nenhum)
Etapa	Etapa atual do pipeline (número da etapa)
Criado em	Data/hora de criação do contato
Transferido para	Para quem o contato foi transferido (ou "-")
Transferido em	Data/hora da transferência (ou "-")
Próximo acompanhamento	Data/hora do próximo follow-up agendado (ou "-")
Última resposta do lead	Data/hora da última interação do lead
Origem	Fonte do lead: Orgânico, Campanha, etc.

3.2 Colunas Customizadas (Custom Fields)

Colunas com prefixo ✨ indicam campos personalizados definidos pelo usuário:

Exemplos de Custom Fields
✨ nombre del cliente
✨ Client ID
✨ Inmueble
✨ Email

3.3 Linha de Contato (Estrutura)

Cada linha da tabela é clicável e contém:

• Checkbox de seleção
• Ícone de plataforma + nome/ID
• Tipo com badge visual (Inbound/Outbound)
• Status em texto
• Canal com avatar do usuário + nome
• Identificador do lead
• Pipeline (ou "-")
• Etapa numérica
• Datas formatadas (DD/MM/AAAA HH:mm)
• Origem
• Campos personalizados (ou "-" quando vazios)

3.4 Tipos de Interação

Tipo	Descrição
Inbound	Lead que iniciou contato com a empresa (entrada espontânea)
Outbound	Lead contatado proativamente via campanha

---

4. Paginação (Rodapé da Tabela)

Elemento	Descrição
Total de conversas	Exibe contagem total (ex: "Total de conversas: 1")
Range atual	Faixa exibida (ex: "1–1 de 1")
Página anterior	Button (desabilitado se na primeira página)
Próxima página	Button (desabilitado se na última página)

---

5. Ações Disponíveis

Por Contato Individual

Ação	Descrição
Clicar na linha	Abre o detalhe do contato
Selecionar checkbox	Seleciona para ações em lote

Ações em Lote

Ação	Descrição
Exportar CSV	Exporta contatos selecionados/filtrados
Alterar colunas	Personalizar quais colunas são visíveis

Filtros Salvos

Ação	Descrição
Salvar visualização	Salva combinação de filtros para uso futuro
Carregar visualização	Aplica uma visualização salva anteriormente

---

6. Relacionamentos com Outros Módulos

Módulo	Relação
Conversas	Cada contato tem conversas associadas
Pipelines	Contatos podem estar em etapas de pipelines
Canais	Origem do canal pelo qual o contato entrou
Campanhas	Contatos de outbound originam-se de campanhas
Workforce	Workers gerenciam as interações com contatos
Relatórios	Dados de contatos alimentam métricas