Skip to main content

​
Gerenciamento de contatos

​
Visão geral

A seção Contatos é seu banco de dados unificado de clientes dentro do ZappWay. Cada vez que um usuário inicia uma conversa, preenche um formulário ou interage com um de seus agentes, um registro de contato é criado ou atualizado automaticamente. Arquitetura:
O que você pode fazer em Contatos:
  • Navegue e pesquise todo o seu banco de dados de contatos
  • Visualize variáveis e dados personalizados coletados durante os fluxos
  • Acesse o histórico completo de conversas por contato
  • Exporte sua base de contatos para CSV
  • Exclua contatos individualmente ou em massa

​
Lista de Contatos

A página principal de Contatos exibe todos os contatos capturados em todos os canais e fluxos da sua organização. Opções de pesquisa:
  • Pesquise por nome, e-mail ou número de telefone usando a barra de pesquisa superior
  • Os resultados são atualizados em tempo real enquanto você digita
  • Correspondências parciais são suportadas (por exemplo, pesquisar “john” retorna “John Smith”, “Johnny Doe”)

​
Filtros

Limite sua lista de contatos usando o painel de filtros: Exemplo de filtro:

​
Classificação

Clique em qualquer cabeçalho de coluna para classificar por esse campo:
  • Nome (A – Z ou Z – A)
  • Data de criação (mais recente ou mais antigo primeiro)
  • Última atividade (mais ou menos recente)

​
Detalhes de contato

Clique em qualquer contato na lista para abrir sua página de perfil completa.

​
Dados Pessoais

A seção superior exibe os principais campos de identidade coletados durante as interações:
As fotos do perfil são extraídas automaticamente dos canais que as fornecem (por exemplo, WhatsApp). Para contatos de bate-papo na web, um avatar padrão é usado, a menos que o usuário forneça um.

​
Variáveis ​​personalizadas

Abaixo da seção de dados pessoais, você encontrará todas as variáveis ​​coletadas de seus fluxos ZappFlux durante conversas com este contato. Exemplos de variáveis personalizadas:
  • Nome da empresa, cargo, setor
  • Interesse do produto, tipo de plano, faixa de orçamento
  • Pontuação CSAT, classificação NPS
  • Qualquer campo personalizado definido em seus fluxos usando o bloco Set Variable
As variáveis ​​são exibidas como pares de valores-chave e são atualizadas automaticamente sempre que uma nova interação coleta novos dados.

​
Histórico de conversas

A guia Histórico em um perfil de contato mostra um resumo cronológico de todas as interações anteriores:
  • Data e hora de cada conversa
  • Canal utilizado (WhatsApp, Web, etc.)
  • Fluxo que foi executado
  • Status final (Resolvido, Solicitado Humanamente, etc.)
  • Agente designado (se aplicável)
Clique em qualquer entrada para ir diretamente para essa conversa na Caixa de entrada.

​
Etiquetas

Você pode aplicar tags manualmente a um contato para organizar e segmentar seu banco de dados:
  1. Click Add Tag in the contact detail panel
  2. Type a new tag name or select an existing one
  3. Tags appear on the contact card in the list view
  4. Use tags as filters to create dynamic segments

​
Ações em massa

Gerencie vários contatos de uma vez sem abrir cada um individualmente. Como usar:
  1. Ative as caixas de seleção por meio do botão Selecionar na barra de ferramentas
  2. Verifique os contatos individuais ou use Selecionar todos visíveis
  3. Escolha uma ação em massa na barra de ação
Ações em massa disponíveis:
A exclusão em massa é irreversível. A exclusão de um contato também remove permanentemente todo o histórico de conversas, variáveis e dados de interação associados a esse contato. Esta ação não pode ser desfeita.

​
Exportar

​
Exportar para CSV

Baixe seu banco de dados de contatos para uso em ferramentas externas de CRM, plataformas de marketing ou análise de dados. Os campos exportados incluem:
  • ID de contato
  • Nome, e-mail, telefone
  • URL da foto do perfil
  • Canal de origem
  • Nome do fluxo de origem
  • Data de criação
  • Data da última atividade
  • Todas as variáveis personalizadas coletadas
  • Tags aplicadas
Como exportar:
  1. Aplique todos os filtros desejados (período, canal, fluxo, tags)
  2. Clique em Exportar na barra de ferramentas superior direita
  3. Escolha Exportar para CSV
  4. Downloads de arquivos para o seu navegador automaticamente
As exportações respeitam seus filtros ativos. Para exportar todo o seu banco de dados de contatos, limpe todos os filtros antes de exportar.
Casos de uso para exportação de CSV:
  • Importe para HubSpot, Salesforce ou outros CRMs
  • Execute campanhas de e-mail via Mailchimp, ActiveCampaign, etc.
  • Crie relatórios no Planilhas Google ou Excel
  • Auditorias de conformidade e retenção de dados

​
Como os contatos são criados

Compreender quando e como os contatos são criados ajuda a evitar duplicatas e a manter a qualidade dos dados. Acionadores de criação de contato:
  • O usuário envia sua primeira mensagem em qualquer canal conectado
  • O usuário preenche um formulário ZappFlux com pelo menos um e-mail ou telefone
  • O contato é criado manualmente através do botão Adicionar contato
  • O contato é importado via upload de CSV
Lógica de desduplicação:
  • ZappWay desduplica contatos por e-mail e número de telefone
  • Se um usuário interage através de dois canais diferentes com o mesmo e-mail, um único contato é atualizado em vez de dois criados
  • Os contatos manuais não são desduplicados automaticamente — verifique antes de importar
Comportamento de atualização de dados:
  • Cada nova interação pode sobrescrever valores de variáveis se o fluxo coletar os mesmos campos
  • Para preservar os valores históricos das variáveis, use variáveis com nomes exclusivos (por exemplo, last_purchase_date vs. purchase_date)

​
Solução de problemas

​
Problema: os contatos não aparecem

Sintomas:
  • A lista de contatos está vazia apesar das conversas ativas
  • Contatos específicos parecem estar faltando
Soluções:
  1. Verifique os filtros ativos – um filtro de data ou canal pode estar ocultando os resultados
  2. Verifique se o fluxo tem um bloco de entrada válido que captura dados do usuário (os contatos exigem pelo menos um ponto de dados)
  3. Confirme se o canal está conectado corretamente em Configurações → Canais
  4. Atualize a página e tente novamente
  5. Verifique se o contato foi excluído – os contatos excluídos não podem ser recuperados

​
Problema: variáveis ​​personalizadas estão faltando

Sintomas:
  • O perfil de contato não mostra variáveis
  • Os campos esperados estão em branco
Soluções:
  1. Verifique se o fluxo usa um bloco Set Variable após o bloco de entrada relevante
  2. Verifique se o nome da variável no bloco corresponde ao que você espera ver
  3. Confirme se o usuário concluiu essa etapa do fluxo (verifique o histórico da conversa)
  4. As variáveis só aparecem se aquele ramo do fluxo foi executado

​
Problema: contatos duplicados

Sintomas:
  • O mesmo usuário aparece várias vezes na lista
  • O histórico de conversas é dividido em vários perfis
Soluções:
  1. Verifique se as duplicatas têm e-mails ou números de telefone diferentes – a desduplicação depende desses campos
  2. Se existirem duplicatas, mescle-as manualmente exportando, consolidando e reimportando (a mesclagem nativa ainda não está disponível)
  3. Garanta que seus fluxos sempre capturem um identificador consistente (e-mail ou telefone) para permitir a desduplicação

​
Melhores práticas

1. Sempre capture um identificador exclusivo Projete seus fluxos para coletar no mínimo um endereço de e-mail ou número de telefone. Sem um identificador exclusivo, o ZappWay não pode desduplicar contatos, levando a perfis fragmentados. 2. Use nomes de variáveis consistentes Padronize a nomenclatura de variáveis em todos os fluxos (por exemplo, sempre use user_email em vez de misturar email, Email e user_email). Nomes inconsistentes criam campos variáveis ​​separados no mesmo contato. **3. Identifique estrategicamente ** Use tags para segmentar contatos por campanha, intenção, interesse no produto ou estágio do ciclo de vida. As tags potencializam a filtragem e podem ser usadas em ações em massa para atingir segmentos específicos. 4. Exporte regularmente A seção Contatos não garante retenção permanente além dos limites do seu plano. Agende exportações regulares para manter seu próprio backup dos dados de contato. 5. Revise a qualidade variável Abra periodicamente uma amostra de contatos e verifique se as variáveis contêm valores esperados e limpos. Se os usuários estiverem inserindo dados inúteis, adicione validação aos seus blocos de entrada no ZappFlux.
Dica profissional: use o filtro Fluxo de origem para ver quais fluxos estão gerando mais contatos. Vale a pena otimizar fluxos de alto volume – pequenas melhorias na qualidade da captura de dados têm um efeito composto em todo o seu banco de dados.

​
Apoiar

Precisa de ajuda com Gerenciamento de contatos? Entre em contato com o suporte ZappWay:
  • E-mail: support@zappway.ai
  • Incluir: capturas de tela, IDs de contato e uma descrição do problema
Forneça estes detalhes ao relatar problemas:
  • Filtros ativos no momento do problema
  • Canal e fluxo de onde veio o contato
  • Se o problema afeta um contato ou vários
  • Sua função de usuário (Administrador, Operador, Visualizador)
Última atualização: março de 2026 Plataforma: ZappWay Dashboard — Gerenciamento de contatos