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.
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
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 |
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
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 lead | Contato recém-chegado, sem interação comercial |
| Em contato | Conversa iniciada com o lead |
| Qualificado | Lead com perfil e interesse confirmados |
| Reunião agendada | Reunião marcada com o lead |
| Proposta enviada | Proposta comercial já enviada |
| Ganho | Venda concluída |
| Perdido | Lead 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.
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
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.
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 |
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) ouunknown(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.
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"]
})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 |