Contatos

Visão Geral

A tela de Contatos da Paralela é o banco de dados central de todos os clientes atendidos pela plataforma. Cada contato armazena informações como nome, telefone, e-mail, documento (CPF/CNPJ), endereço, data de nascimento e dados personalizados.

Contatos são criados automaticamente quando uma nova conversa chega pelo WhatsApp ou outro canal. Também podem ser criados manualmente ou importados em massa.

A lista de contatos exibe uma tabela com as seguintes colunas:

Coluna	Descrição
ID	Identificador único do contato
Avatar	Foto do perfil (quando disponível)
Nome	Nome do contato
WhatsApp	Número de telefone
Status	Ativo (verde) ou bloqueado (vermelho)
Ações	Botões para enviar mensagem, editar, bloquear e excluir

O número total de contatos aparece ao lado do título da página.

---

Gerenciando Contatos

Criar um contato manualmente

1. Na tela de Contatos, clique no ícone de menu (três pontos) no canto superior direito.
2. Selecione Adicionar contato.
3. Preencha os campos do formulário:

Campo	Obrigatório	Descrição
Nome	Sim	Nome completo do contato
Telefone	*	Número com código do país (preenchido automaticamente)
E-mail	*	Endereço de e-mail
Documento (CPF/CNPJ)	Não	Formatado automaticamente conforme a quantidade de dígitos
Endereço de entrega	Não	Em campos separados: CEP, rua, número, bairro, cidade, UF e complemento
Data de nascimento	Não	Selecionável por calendário
Expiração de mensagens	Não	Tempo limite para mensagens (desativado, 1 dia, 7 dias ou 90 dias)
Responsável	Não	Atendente responsável pelo contato

*É necessário informar pelo menos telefone ou e-mail.

4. Clique em Salvar.

Editar um contato

1. Na lista de contatos, localize o contato desejado.
2. Clique no ícone de lápis (editar) na coluna de ações.
3. Altere os campos necessários no formulário.
4. Clique em Salvar.

Padronização automática do nome

A Paralela normaliza automaticamente o nome dos contatos para a forma capitalizada (title case). Por exemplo, MARIA DA SILVA e maria da silva viram Maria da Silva. A regra vale para contatos criados a partir de mensagens recebidas (WhatsApp, Instagram, Facebook, webchat), de importações e do cadastro manual. Conectores em português (de, da, do, dos, das, e) permanecem em minúsculo após a primeira palavra, e acentos são preservados. Isso também melhora o uso da variável {{firstName}} em mensagens automáticas, evitando que o primeiro nome seja exibido em caixa alta.

Visualizar histórico de conversas

1. Na lista de contatos, clique no ícone de mensagem na coluna de ações.
2. Um novo ticket será criado ou a conversa existente será aberta.
3. Na barra lateral do ticket, o painel do contato exibe todas as informações, tags, notas e campos personalizados.

Fazer uma chamada de voz

1. Localize o contato pelo nome ou telefone usando a busca.
2. Clique no ícone de telefone: no computador, na coluna de ações; no celular, no menu ⋮ do contato (opção Ligar).
3. Se houver mais de um número de chamadas conectado, escolha de qual número ligar.

O ícone só aparece para contatos ativos (não bloqueados), não aparece para grupos, e depende de ter permissão para chamadas e uma conexão de chamadas conectada. Consulte Chamadas de Voz para detalhes.

Bloquear ou desbloquear um contato

1. Na coluna de ações, clique no ícone de bloqueio.
2. Confirme a ação na janela de confirmação.
3. Contatos bloqueados aparecem com status vermelho e não podem receber novas mensagens.
4. Para desbloquear, clique no mesmo ícone (que agora mostra um símbolo de desbloqueio) e confirme.

Atribuir um responsável

1. Edite o contato clicando no ícone de lápis.
2. No campo Responsável, selecione o atendente desejado na lista.
3. Clique em Salvar.

Observação: atribuir responsável requer a permissão de alterar o responsável do contato. Usuários sem essa permissão verão o campo desabilitado.

Para atribuir responsável em massa, consulte a seção Operações em massa abaixo.

Ativar ou desativar o bot para um contato

1. Edite o contato clicando no ícone de lápis.
2. No formulário, localize o interruptor Desativar bot para este contato.
3. Ative o interruptor para desabilitar o atendimento automático (IA/chatbot) para aquele contato específico.
4. Clique em Salvar.

Quando o bot está desativado, o contato será atendido apenas por atendentes humanos.

---

Importação em Massa

Existem três formas de importar contatos:

Importar de arquivo (CSV/Excel)

1. No topo da lista de contatos, clique no botão Importar / Exportar (ícone de nuvem).
2. Você será direcionado para a tela de importação.
3. Arraste um arquivo ou clique para selecionar. Formatos aceitos: .xls, .xlsx, .csv, .txt.
4. A planilha será exibida na tela. Para cada coluna, selecione o campo correspondente na Paralela:

Campo disponível	Descrição
Nome	Campo obrigatório
Número	Telefone do contato
E-mail	E-mail do contato
Tags (separadas por vírgula)	Tags para categorizar
Responsável pelo Contato (nome)	Nome do atendente responsável
Documento (CPF/CNPJ)	Documento do contato
Data de Nascimento (DD/MM/AAAA)	Data no formato brasileiro
Informação Extra	Campos adicionais (pode mapear várias colunas)

5. Marque as linhas que deseja importar usando as caixas de seleção. Use a caixa no cabeçalho para selecionar todas.
6. Opcionalmente, ative Validar contatos no WhatsApp para verificar se os números existem no WhatsApp antes de importar.
7. Clique em Importar contatos.
8. Ao final, o sistema informa quantos contatos foram criados e quantos foram ignorados.

Importar do dispositivo (agenda do WhatsApp)

1. No menu de opções, selecione Importar do dispositivo.
2. Selecione a conexão de WhatsApp de onde deseja importar os contatos.
3. Os contatos da agenda do dispositivo serão importados automaticamente.

Operações em massa

Ao selecionar contatos na lista (usando as caixas de seleção), botões de ação em massa aparecem:

Ação	Descrição
Adicionar tags	Com contatos marcados, as tags escolhidas substituem as tags atuais deles. Na seleção de todos os contatos filtrados, as tags são somadas às atuais
Definir responsável	Define um atendente responsável para os selecionados
Excluir selecionados	Remove permanentemente os contatos selecionados, junto com os pedidos e o histórico de conversas
Limpar seleção	Desmarca todos os contatos

Quando você seleciona todos os contatos da página atual, um botão adicional aparece permitindo selecionar todos os contatos filtrados (incluindo os que não estão visíveis na tela). Isso permite aplicar ações em massa a centenas ou milhares de contatos de uma vez.

Com filtros avançados ativos, a seleção de todos os contatos filtrados permite apenas exportar. Adicionar tags, definir responsável e excluir ficam desativados nesse modo. Para aplicar essas ações, marque os contatos na lista ou use apenas a busca por texto.

---

Exportação de Contatos

Para exportar a lista de contatos para uma planilha do Excel:

1. Na tela de Contatos, use a busca e os filtros para deixar na lista só os contatos que deseja exportar. Para exportar todos, deixe a busca e os filtros vazios.
2. Se quiser exportar apenas alguns contatos, marque-os na lista usando as caixas de seleção.
3. No topo da lista, clique no botão Importar / Exportar (ícone de nuvem).
4. Na janela que abrir, clique em Exportar Contatos para o Excel.
5. Aguarde a mensagem de exportação concluída. O arquivo backup_contatos_<data>.xlsx é baixado pelo navegador.

O que entra no arquivo:

• Com contatos marcados na lista: só os contatos marcados.
• Sem contatos marcados: todos os contatos que correspondem à busca e aos filtros atuais.

A planilha traz as colunas nome, número, e-mail, documento, endereço (CEP, rua, número, complemento, bairro, cidade e UF), data de nascimento e responsável. As colunas são as mesmas do modelo de importação, então o arquivo exportado pode ser editado e importado de volta.

A opção Exportar Contatos para o Excel aparece apenas para usuários com permissão de excluir contatos. Se ela não aparecer, peça acesso ao administrador.

---

Campos Personalizados

Campos personalizados permitem armazenar informações além dos campos padrão do contato.

Criar campos personalizados

1. Abra Campos Personalizados no menu lateral (ou pelo ícone de engrenagem na seção de campos personalizados ao editar um contato). Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em Campos Personalizados para mostrá-lo no menu (ou procure "Campos Personalizados" na lupa do topo).
2. Crie novos campos definindo:
   • Nome do campo
   • Tipo do campo (texto, número, data, seleção, etc.)
   • Máscara de formatação (opcional, para campos como CEP ou telefone alternativo)
   • Se o campo é obrigatório

Onde os campos aparecem

• No formulário de criação e edição do contato, na seção Campos Personalizados
• No painel lateral do ticket, ao visualizar o perfil do contato
• Os valores podem ser usados em automações e fluxos

Preencher campos personalizados

1. Edite o contato (ícone de lápis).
2. Role até a seção Campos Personalizados.
3. Preencha os valores de acordo com o tipo de cada campo.
4. Clique em Salvar.

---

Tags e Categorias

Tags são marcadores coloridos que ajudam a organizar e segmentar contatos e tickets.

Gerenciar tags

1. Abra Tags no menu lateral. Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em Tags para mostrá-lo no menu (ou procure "Tags" na lupa do topo).
2. Para criar uma nova tag, clique no botão de adicionar.
3. Defina:
   • Nome da tag
   • Cor
   • Categoria (opcional, para agrupar tags relacionadas)
4. Clique em Salvar.

Aplicar tags a contatos

Individualmente:

1. Edite o contato (ícone de lápis).
2. No formulário, use a seção de tags para adicionar ou remover tags.
3. Clique em Salvar.

Em massa:

1. Na lista de contatos, selecione os contatos desejados.
2. Clique no botão Adicionar tags.
3. Selecione as tags. Atenção: com contatos marcados, as tags escolhidas substituem as tags atuais deles. Inclua também as que eles já tinham e que devem continuar. Na seleção de todos os contatos filtrados, as tags são somadas às atuais.
4. Confirme.

Filtrar contatos por tags

1. Na tela de contatos, clique no ícone de filtro.
2. No painel de filtros, selecione uma ou mais tags.
3. A lista será atualizada para exibir apenas contatos que possuem as tags selecionadas.

Categorias de tags

Categorias agrupam tags relacionadas, facilitando a organização quando há muitas tags. Por exemplo, uma categoria "Interesse" pode conter as tags "Produto A", "Produto B" e "Produto C".

Tags em automações

Tags podem ser adicionadas ou removidas automaticamente por fluxos de automação. Isso permite, por exemplo, marcar um contato como "Lead Qualificado" ao final de um fluxo de atendimento.

---

Lead Tracker

O Lead Tracker captura leads de fontes externas (como formulários no seu site) e os centraliza na Paralela.

Como funciona

A funcionalidade possui duas abas: Configurações (trackers) e Leads Capturados.

Criar um tracker

1. Acesse Lead Tracker no menu lateral.
2. Na aba Configurações, clique no ícone de adicionar.
3. Preencha as configurações:

Campo	Descrição
Nome	Nome identificador do tracker
Ativo	Se o tracker está recebendo leads
Domínios permitidos	Sites autorizados a enviar leads (deixe vazio para todos)
Exigir e-mail	Se o e-mail é obrigatório no formulário
Criar contato automaticamente	Converte o lead em contato automaticamente
Limite por minuto	Proteção contra abuso (padrão: 60)
Honeypot	Campo invisível para detectar bots
Detecção de duplicados	Evita leads duplicados em um intervalo de tempo

4. Configure o mapeamento de campos para associar os dados recebidos do formulário aos campos do contato (nome, e-mail, telefone, documento, endereço, data de nascimento, campo personalizado).
5. Clique em Salvar.

Obter o script de integração

1. Na lista de trackers, clique no ícone de código (</>) do tracker desejado.
2. Copie o script gerado e cole no HTML do seu site.
3. O script enviará os dados do formulário para a Paralela automaticamente.

Gerenciar leads capturados

1. Na aba Leads Capturados, visualize todos os leads recebidos.
2. Use a busca e o filtro por tracker para localizar leads específicos.
3. Cada lead exibe: e-mail, nome, telefone, status, origem, tracker e data.

Status	Descrição
Novo	Lead recém-capturado
Contatado	Lead que já foi abordado
Convertido	Lead transformado em contato
Descartado	Lead considerado inválido

Converter lead em contato

1. Na lista de leads, clique no ícone de conversão (pessoa com sinal de mais).
2. O lead será transformado em um contato na Paralela, com os campos mapeados preenchidos automaticamente.

---

Bairros/Regiões

A funcionalidade de Gestão de Bairros permite organizar contatos por região geográfica.

Gerenciar bairros

1. Abra Entrega e Taxas no menu lateral (é onde ficam os bairros). Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em Entrega e Taxas para mostrá-lo no menu (ou procure "bairros" na lupa do topo).
2. A tela exibe uma lista de bairros cadastrados com filtros por cidade, estado e status.

Criar um bairro

1. Clique no botão de adicionar.
2. Preencha as informações do bairro:
   • Nome
   • Cidade
   • Estado
   • Valores associados (quando aplicável, como taxa de entrega)
3. Clique em Salvar.

Importar bairros

1. Clique no botão de importação.
2. Faça upload de um arquivo com a lista de bairros.
3. O sistema importará os registros automaticamente.

Editar bairros em massa

1. Selecione os bairros desejados usando as caixas de seleção.
2. Clique no botão de edição em massa.
3. Aplique as alterações desejadas a todos os bairros selecionados.

Filtrar bairros

Use os filtros disponíveis no cabeçalho da página:

Filtro	Descrição
Busca	Pesquisa por nome do bairro
Cidade	Filtra por cidade
Estado	Filtra por estado
Status	Filtra por ativo ou inativo

Endereço de entrega

O endereço do contato fica em campos separados — CEP, rua, número, bairro, cidade, UF e complemento —, e não numa linha de texto só. A diferença não é organização: é o que decide se o pedido consegue ser lançado no seu sistema de gestão. Sistemas que despacham entrega exigem cada peça num campo próprio, e uma linha única não pode ser cortada com segurança: "Rua 14, Jardim, Bairro Centro, Cidade/UF" tem quatro vírgulas e cinco leituras possíveis, e a errada põe o entregador na porta de outra pessoa.

O CEP preenche o resto — e, se você não souber, ele se preenche sozinho. Digite o CEP e a cidade, a UF e, quando os Correios souberem, a rua e o bairro vêm junto. O caminho contrário também vale: preencha rua, bairro e cidade e deixe o CEP em branco, que a Paralela pergunta aos Correios e completa. É por isso que a IA não pede o CEP ao cliente — ninguém sabe o próprio CEP de cor, e o sistema descobre. Um CEP que não existe não é salvo; no lugar dele entra o que a rua responde.

Um contato pode ter mais de um endereço, com rótulo ("casa", "trabalho") e um marcado como padrão. O padrão é o que vai no pedido. É a mesma lista que o cliente gerencia sozinho pela loja virtual, então o endereço que ele salvou comprando aparece aqui, e vice-versa.

Contatos antigos. Quem foi cadastrado antes disso pode ter o endereço numa linha de texto só — importação de planilha, formulário ou webhook ainda entregam assim. Essa linha continua aparecendo, do jeito que veio; nada é cortado em pedaços por conta própria. Para lançar pedido no seu sistema de gestão, preencha os campos separados uma vez.

Associar bairros a contatos

O bairro do endereço pode ser ligado a um bairro cadastrado, que é o que carrega a taxa de entrega. Ver Loja Virtual.

---

Busca e Filtros

A tela de contatos oferece opções de busca e filtragem:

1. Clique no ícone de filtro no cabeçalho.
2. No painel que aparece, utilize:
   • Campo de busca: pesquisa por nome, número ou e-mail
   • Filtro por tags: selecione tags para refinar os resultados
   • Filtros dinâmicos: combine quantas regras desejar, escolhendo campo, condição e valor (veja abaixo)
3. Os resultados são atualizados automaticamente conforme você digita ou seleciona filtros.

A busca, os filtros dinâmicos e a ordenação ficam guardados: atualizar a página (F5) ou voltar depois mantém tudo como estava. Eles também vão no endereço da página (?s=...), então copiar o link leva o colega para a mesma lista filtrada. Limpar os filtros limpa o endereço. O mesmo vale para as listas de Campanhas, Campanhas recorrentes, Agendamentos, Prospecção e Produtos.

A lista carrega contatos sob demanda. Role a página para baixo para carregar mais registros automaticamente.

Filtros dinâmicos

Além dos filtros rápidos, você pode montar regras personalizadas clicando em Adicionar regra. Cada regra é composta por três partes:

1. Campo — qual atributo do contato filtrar. Disponíveis: nome, número, e-mail, documento, endereço, canal, responsável, conexão (WhatsApp), tags, data de criação, última atualização, aniversário, "é grupo", "ativo", "bot desativado". Os campos personalizados cadastrados pela empresa também aparecem no seletor, abaixo dos campos padrão.
2. Condição — como comparar. As opções mudam conforme o tipo do campo:
   • Texto: Contem, Nao contem, Comeca com, Termina com, Igual a, Diferente de, Esta vazio, Nao esta vazio.
   • Número: Igual a, Diferente de, Maior que, Maior ou igual a, Menor que, Menor ou igual a, Entre, Esta vazio, Nao esta vazio.
   • Data: Igual a, Antes de, Depois de, Entre, Nos ultimos X dias, Esta vazio, Nao esta vazio.
   • Booleano: E verdadeiro, E falso.
   • Seleção única (canal, responsável, conexão): Igual a, Diferente de, E alguno de, Nao e nenhum de, Esta vazio, Nao esta vazio.
   • Seleção múltipla (tags): E alguno de, Nao e nenhum de, Esta vazio (sem tags), Nao esta vazio (com qualquer tag).
3. Valor — o que comparar. Campos de seleção abrem um dropdown com as opções disponíveis.

Datas — o que "Igual a" significa

Filtros de data são dia a dia. Quando você escolhe Igual a 16/04/2025, o sistema retorna todos os registros daquele dia (00:00 até 23:59). Antes de 16/04/2025 retorna registros estritamente anteriores ao dia. Depois de 16/04/2025 retorna registros a partir do dia seguinte. Entre 01/01/2025 e 31/12/2025 inclui todos os dias dos dois extremos. Nos ultimos X dias é relativo: mostra os registros da meia-noite de X dias atrás até agora, recalculado a cada consulta conforme o tempo avança.

Combinando regras com E / OU

Quando há mais de uma regra, um seletor E / OU aparece no canto superior direito do painel:

• E — o contato precisa atender a todas as regras para aparecer nos resultados.
• OU — o contato precisa atender a pelo menos uma das regras.

O modo OU também funciona quando você combina filtros por tags com outras regras (ex.: "tem a tag VIP OU o nome contém Maria").

Clique no ícone de lixeira ao lado de uma regra para removê-la. Use Limpar tudo para zerar os filtros dinâmicos. Os filtros rápidos (campo de busca, filtro de tags no topo) continuam aplicados em paralelo aos filtros dinâmicos — ambos precisam ser satisfeitos.