Contatos


Contatos


📘 Gestão de Contatos — Guia Passo a Passo (Chat-Bot)

Organize e gerencie contatos provenientes de diferentes canais (ex.: WhatsApp, plataformas SaaS). Este guia explica, passo a passo, como adicionar, editar, filtrar, importar, exportar e gerenciar contatos de forma eficiente.


1 — Visão geral: Lista de Contatos 🗂️

Todos os contatos criados aparecem na Lista de Contatos (tabela). Cada coluna tem um propósito — conheça cada uma:

Colunas da Lista de Contatos

  • Nº SR. — Número de série do contato na lista.

  • Nome — Nome completo (clique para ver detalhes).

  • Tipo — Classificação: Lead ou Customer.

  • Telefone — Número de telefone (parcialmente oculto por privacidade).

  • Atribuído — Usuário ou equipe responsável.

  • Status — Status atual (ex.: New, In Progress).

  • Fonte — Origem do contato (ex.: Facebook, WhatsApp).

  • Ativo — Interruptor para ativar/desativar visibilidade do contato.

  • Criado em — Data de criação do registro.

Ações e controles disponíveis na lista

  • Interruptor de ativação: ligar/desligar contato (visibilidade).

  • Pesquisar: caixa de busca para localizar contatos rapidamente.

  • Exclusão em massa: selecione múltiplos registros e use Bulk Delete.

  • Ocultar campos: mostrar/ocultar colunas da tabela conforme necessidade.

  • Importar contatos: upload em massa via CSV/Excel.

⚠️ Apenas contatos ativos aparecem em fluxos de trabalho e relatórios subsequentes.


2 — Adicionando novos contatos ➕

Siga estes passos para criar um contato usando o formulário Adicionar Novo Contato.

Passo 1 — Abrir o formulário

  • Clique no botão + New Contact na página de Contatos.

  • O formulário Adicionar novo contato será exibido.

Passo 2 — Preencher Dados Obrigatórios (aba Detalhes de Contato)

Campos obrigatórios (marcados com *):

CampoDescrição
Status*Selecione: New, In Progress, Contacted, Qualified, Closed.
Fonte*Escolha a origem: Facebook, WhatsApp.
Primeiro nome*Primeiro nome do contato.
Sobrenome*Sobrenome do contato.
Tipo*Lead ou Customer.
E-mail*E-mail válido.
Telefone*Número com código do país.

Campos opcionais (mesma aba)

  • Atribuído — equipe ou usuário responsável (ex.: Staff members).

  • Empresa — nome da empresa (se aplicável).

  • Site — URL do site (se aplicável).

Passo 3 — Outros detalhes (opcional)

Na aba Outros Detalhes você pode incluir:

  • Cidade, Estado, País, CEP, Endereço, Descrição (notas internas, histórico).

Passo 4 — Salvar

  • Clique em Add para salvar o contato.

  • Clique em Cancel para descartar.


3 — Notas do Contato 📝

  • A aba Notas só fica disponível após a criação do contato.

  • Não é possível adicionar notas durante a criação inicial — primeiro salve o contato.

Como adicionar notas após criação

  1. Abra o contato em modo edição.

  2. Vá para a aba Notas.

  3. Escreva no campo Adicionar notas (comentários, histórico, follow-ups).

  4. Clique em Add para salvar.

Lista de notas

  • Exibe notas em ordem cronológica com data e hora.

  • Cada nota pode ser excluída com o ícone da lixeira.

⚠️ Importante: crie o contato primeiro para habilitar a aba de notas.


4 — Exportar contatos 📤

Exporte a base para backup, relatórios ou processamento externo.

Como exportar

  • Clique em Export (canto superior direito da lista de contatos).

  • Um arquivo CSV será gerado para download.

Opções de exportação

  • Exportar tudo: sem filtros — baixa todos os contatos.

  • Exportar resultados filtrados: aplique filtros e depois exporte apenas a seleção exibida.

Formato do arquivo

  • CSV com colunas típicas: Nome, E-mail, Telefone, Tipo, Fonte, Status, Atribuído, Criado em, Status ativo e quaisquer campos personalizados visíveis.

✅ Dica: abra o CSV no Excel ou Google Sheets para analisar.


5 — Filtrar contatos 🔎

Filtre a lista para localizar grupos específicos.

Como usar

  1. Clique no ícone Filtro na barra de ferramentas dos Contatos.

  2. Escolha os critérios disponíveis nos menus suspensos.

  3. A tabela exibirá apenas os resultados que correspondem aos filtros.

Opções de filtro comuns

  • Tipo: Lead ou Customer.

  • Atribuído: por usuário/equipe.

  • Status: New, In Progress, Contacted, Qualified, Closed.

  • Fonte: Facebook, WhatsApp, etc.

  • Criado em: data específica ou intervalo.

Dicas rápidas

  • Use Clear all para remover filtros.

  • Combinações de filtros permitem segmentações muito precisas.

  • Exportar respeita filtros aplicados (exporta somente os resultados filtrados).


6 — Importar contatos em massa 📥

Importe múltiplos contatos carregando um arquivo CSV corretamente formatado.

Como importar

  1. Clique em Import na tela de Contatos.

  2. No painel Importar Contato, arraste e solte o arquivo .csv ou selecione manualmente.

Pré-visualização

  • O sistema mostrará uma pré-visualização antes da importação.

IDs obrigatórios e formatação

  • Alguns campos exigem IDs numéricos (não rótulos/texto). Esses IDs aparecem no lado direito da tela de importação e devem ser usados no CSV.

Campo no CSVExemploObservação
status_id131Ex.: 131 = New, 132 = In Progress
source_id54Ex.: 54 = Facebook, 55 = WhatsApp
assigned_id41Ex.: 41 = Drashti Mehta

✅ Importante: insira os IDs numéricos corretos para status_id, source_id, assigned_id.

Modelo de arquivo

  • Mantenha cabeçalhos compatíveis com o modelo exigido pela tela de importação.


7 — Quadro Kanban de Contatos (Visão visual) 🗂️➡️

O Quadro Kanban é uma interface arrastar-e-soltar que facilita o gerenciamento do fluxo de contatos pelos estágios.

Principais recursos

  • Arrastar e soltar contatos entre colunas de status.

  • Feedback visual instantâneo ao mover cartões.

  • Atualização automática do status ao soltar o cartão.

  • Design responsivo (desktop e mobile).

  • Estágios de status totalmente personalizáveis.

Colunas de status (exemplo padrão)

  • Contatado — contato já com primeiro contato realizado.

  • Qualificado — atende aos critérios desejados.

  • Em andamento — processo/negociação em curso.

  • Em Configuração (anteriormente “Em s”) — fase preparatória antes do fechamento.

  • Fechado — negócio concluído / processo finalizado.

Como usar

  • Cada contato é um cartão — arraste para outra coluna para atualizar o status.

  • O sistema salva alterações em tempo real e reflete em relatórios.


8 — Pré-visualização e verificações finais 👀

  • Use a pré-visualização da lista e do contato individual para confirmar campos antes de exportar, filtrar ou iniciar automações.

  • Garanta que contatos importados tenham status_id, source_id e assigned_id válidos.

  • Somente contatos ativos serão usados em campanhas, fluxos e relatórios.


Navegação rápida

  • Página anterior: Faturas

  • Próxima página: Modelo

** O tempo é base no fuso horário America/New_York