Contatos, Tags, CRM e Data Intelligence

O Dexter mantém uma agenda de contatos sincronizada com seu WhatsApp. Cada contato possui campos personalizados, tags, histórico de conversas e score de qualificação — tudo centralizado em um só lugar para que você tenha visibilidade completa sobre cada lead e cliente.

Gerenciar contatos

Visualizar e buscar contatos

No dashboard, acesse Contatos para ver a lista completa de contatos da sua instância. Use a barra de busca para localizar contatos por nome, telefone ou tag.

Filtros disponíveis

  • Por tag — exibe apenas contatos com a tag selecionada.
  • Por status — filtre por contatos ativos, inativos ou todos.
  • Por instância — se você tem mais de um número conectado, escolha qual consultar.

Detalhes do contato

Ao clicar em um contato, você acessa a ficha completa:

  • Histórico de conversas recentes
  • Tags atribuídas
  • Campos personalizados (nome, empresa, e-mail, dados customizados)
  • Score de qualificação e sinais detectados pelo assistente
  • Agente responsável (SDR, CS, Onboarding)

Tags

Criar e gerenciar tags

Tags são rótulos que você aplica aos contatos para organizar sua base e segmentar audiências. No dashboard, acesse Contatos para visualizar as tags existentes e suas contagens.

Adicionar ou remover tags

  • Individual: na ficha do contato, adicione ou remova tags diretamente.
  • Em lote: ao importar contatos via planilha, inclua uma coluna de tags para aplicar automaticamente a todos os registros.

Tags para segmentar campanhas

Ao criar uma campanha, você pode usar tags como filtro de audiência. Apenas contatos com a tag selecionada serão incluídos na campanha.

Tags automáticas

O assistente de IA pode adicionar tags automaticamente com base na conversa. Por exemplo, se o lead demonstrar interesse em um produto específico, o assistente pode aplicar uma tag correspondente sem intervenção manual.

Via MCP
Use dexter_contacts_tag para adicionar ou remover tags de um contato e dexter_contact_tags_list para listar todas as tags disponíveis com suas contagens.

Campos personalizados

Além de nome e telefone, cada contato pode ter campos adicionais: empresa, e-mail, cidade, CNPJ, cargo e campos customizados definidos por você.

Configurar campos

1
No dashboard, acesse Contatos → Campos.
2
Crie novos campos personalizados ou ative/desative os campos padrão.
3
Os campos ativos serão coletados automaticamente pelo assistente durante as conversas e estarão disponíveis para personalização de mensagens em campanhas.

Uso dos campos

  • Segmentação: filtre contatos por qualquer campo personalizado.
  • Personalização: use campos como variáveis em mensagens de campanha (ex.: nome, empresa).
  • Coleta automática: o assistente extrai dados da conversa e preenche os campos habilitados na configuração.

Importação de contatos

Importe contatos em lote enviando uma planilha CSV pelo dashboard.

Formato esperado

Coluna Obrigatória Descrição
telefone Sim Número com DDI. Ex.: 5511999999999
nome Não Nome do contato
tags Não Tags separadas por vírgula
empresa Não Nome da empresa
email Não E-mail de contato
Formato do telefone
Sempre use o formato internacional com DDI (código do país). Para números brasileiros, inclua 55 seguido do DDD e número com 9 dígitos. Exemplo: 5511999999999.

Passo a passo

1
No dashboard, acesse Contatos → Importar.
2
Selecione o arquivo CSV e escolha a instância (número de WhatsApp) de destino.
3
Mapeie as colunas da planilha para os campos do Dexter. O sistema sugere o mapeamento automaticamente.
4
Confirme a importação. Os contatos serão criados ou atualizados (merge) sem sobrescrever dados já existentes.

CRM Kanban

O CRM Kanban oferece uma visão de pipeline para acompanhar a jornada dos seus leads e clientes por estágios de vendas.

Estágios do pipeline

Estágio Descrição
Novo leadContato recém-chegado, sem interação comercial
Em contatoConversa iniciada com o lead
QualificadoLead com perfil e interesse confirmados
Reunião agendadaReunião marcada com o lead
Proposta enviadaProposta comercial já enviada
GanhoVenda concluída
PerdidoLead não converteu (com motivo registrado)

Como usar

  • Acesse CRM no dashboard para ver o quadro Kanban.
  • Arraste os cards entre colunas para mover contatos entre estágios.
  • Filtre o quadro por instância ou por tag.
  • Clique em um card para ver os detalhes do contato, histórico de movimentações e valor da oportunidade.
  • Ao mover para "Perdido", selecione o motivo (sem resposta, sem orçamento, escolheu concorrente, sem fit ou outro).

Integração com o assistente SDR

O assistente SDR pode mover contatos automaticamente entre estágios conforme a conversa avança — por exemplo, de "Novo lead" para "Em contato" ao iniciar uma conversa, ou para "Reunião agendada" quando um agendamento é confirmado.

Cards ganhos e perdidos permanecem visíveis no quadro por 30 dias para referência, depois são arquivados automaticamente.

Data Intelligence (DDI)

O Dexter Data Intelligence (DDI) permite enriquecer sua base de contatos com dados adicionais, validar números de WhatsApp e importar leads a partir de planilhas do Google Sheets.

Ativar o DDI

1
No dashboard, acesse Data Intelligence → Configurações.
2
Ative o módulo e configure os provedores de enriquecimento desejados.

Importação de planilhas Google Sheets

Conecte planilhas do Google Sheets como fontes de leads. O DDI sincroniza periodicamente (intervalo configurável) e importa novos registros automaticamente.

1
Cole o link da planilha Google Sheets no campo de fontes.
2
Compartilhe a planilha com o e-mail do robô indicado na tela (permissão de leitura).
3
Mapeie as colunas da planilha para os campos do Dexter (telefone, nome, empresa etc.). O sistema sugere o mapeamento automaticamente.
4
Declare a base legal (LGPD) e confirme a origem dos contatos.

Enriquecimento de dados

O DDI consulta provedores externos para completar os dados dos seus leads. Provedores disponíveis:

Provedor O que faz Chave necessária
DDD Identifica estado e região pelo DDD do telefone Nenhuma (gratuito)
Domínio do e-mail Extrai o site corporativo a partir do e-mail Nenhuma (gratuito)
CNPJ (BrasilAPI) Consulta dados da empresa pelo CNPJ Nenhuma (gratuito)
Apify (Google Maps) Busca dados do estabelecimento no Google Maps apify_api_token
Apify (Instagram) Coleta informações públicas do perfil no Instagram apify_api_token
Firecrawl Extrai informações do site da empresa firecrawl_api_key
Configure as chaves de API dos provedores pagos em Data Intelligence → Credenciais. Provedores gratuitos funcionam sem configuração adicional.

Supressão

A lista de supressão permite remover números inválidos, opt-out ou protegidos da base ativa. Motivos disponíveis:

  • Manual: você adiciona números à lista manualmente.
  • Cliente protegido: contatos que não devem receber campanhas.
  • Opt-out: contatos que pediram para não ser contatados.
  • Sem WhatsApp: detectado automaticamente pela validação (removido quando o número for revalidado).

Promoção de leads

Após enriquecer e validar os leads, promova-os para a agenda de contatos de uma instância. A promoção cria (ou atualiza) o contato no Dexter com todos os dados coletados e aplica a tag dexter-data-intelligence automaticamente.

Validação de WhatsApp

Antes de enviar mensagens, valide se os números da sua base possuem WhatsApp ativo. Isso evita envios para números inexistentes e melhora a taxa de entrega das suas campanhas.

Como funciona

  • O DDI verifica automaticamente os números durante a sincronização de planilhas, classificando cada lead como exists (tem WhatsApp), not_exists (sem WhatsApp) ou unknown (não verificado).
  • Números sem WhatsApp são automaticamente adicionados à lista de supressão para evitar tentativas de envio.
  • Configure o provedor de validação em Data Intelligence → Credenciais.
A promoção de leads para a agenda de contatos bloqueia automaticamente números classificados como not_exists. Para incluir números ainda não verificados, marque a opção "Permitir não verificados" ao promover.

Via MCP

As ferramentas MCP permitem gerenciar contatos e tags de forma programática, a partir de qualquer cliente compatível (Claude Desktop, Cursor, etc.).

dexter_contacts_search   — buscar contatos por nome, telefone ou tag
dexter_contacts_get      — detalhes completos de um contato
dexter_contacts_upsert   — criar ou atualizar um contato
dexter_contacts_tag      — adicionar ou remover tags de um contato
dexter_contact_tags_list — listar todas as tags com contagem
dexter_stale_leads       — relatório de leads inativos há N dias

Exemplos de uso

Buscar contatos com uma tag específica:

dexter_contacts_search({ "q": "tag:interessado" })

Adicionar tags a um contato:

dexter_contacts_tag({
  "phone": "5511999999999",
  "add": ["cliente-vip", "produto-x"]
})

Remover uma tag:

dexter_contacts_tag({
  "phone": "5511999999999",
  "remove": ["lead-frio"]
})
Para a referência completa de todas as tools MCP, consulte a página MCP — Referência de Tools.

Erros comuns

Erro Causa Solução
"Número inválido" Telefone sem DDI ou em formato incorreto Use o formato internacional com DDI. Ex.: 5511999999999
"Tag não encontrada" A tag referenciada ainda não existe Crie a tag antes de usá-la (no dashboard ou via dexter_contacts_tag)
"Limite de planilhas atingido" Número máximo de fontes DDI por conta Arquive fontes antigas antes de adicionar novas
"Declaração LGPD necessária" Base legal não declarada ao importar Selecione a base legal e confirme a origem dos contatos na tela de importação
"Número sem WhatsApp" O número não possui conta no WhatsApp Use a validação de WhatsApp antes de enviar. O número será reclassificado automaticamente na próxima revalidação