Contatos

Visao Geral

A tela de Contatos e o banco de dados central de todos os clientes atendidos pela plataforma. Cada contato armazena informacoes como nome, telefone, e-mail, documento (CPF/CNPJ), endereco, data de nascimento e dados personalizados.

Contatos sao criados automaticamente quando uma nova conversa chega pelo WhatsApp ou outro canal. Tambem podem ser criados manualmente ou importados em massa.

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

Coluna	Descricao
ID	Identificador unico do contato
Avatar	Foto do perfil (quando disponivel)
Nome	Nome do contato
WhatsApp	Numero de telefone
Status	Ativo (verde) ou bloqueado (vermelho)
Acoes	Botoes para enviar mensagem, editar, bloquear e excluir

O numero total de contatos aparece ao lado do titulo da pagina.

---

Gerenciando Contatos

Criar um contato manualmente

1. Na tela de Contatos, clique no icone de menu (tres pontos) no canto superior direito.
2. Selecione Adicionar contato.
3. Preencha os campos do formulario:

Campo	Obrigatorio	Descricao
Nome	Sim	Nome completo do contato
Telefone	*	Numero com codigo do pais (preenchido automaticamente)
E-mail	*	Endereco de e-mail
Documento (CPF/CNPJ)	Nao	Formatado automaticamente conforme a quantidade de digitos
Endereco	Nao	Com sugestoes automaticas baseadas em contatos existentes
Data de nascimento	Nao	Selecionavel por calendario
Expiracao de mensagens	Nao	Tempo limite para mensagens (desativado, 1 dia, 7 dias ou 90 dias)
Responsavel	Nao	Atendente responsavel pelo contato

*E necessario 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 icone de lapis (editar) na coluna de acoes.
3. Altere os campos necessarios no formulario.
4. Clique em Salvar.

Visualizar historico de conversas

1. Na lista de contatos, clique no icone de mensagem na coluna de acoes.
2. Um novo ticket sera criado ou a conversa existente sera aberta.
3. Na barra lateral do ticket, o painel do contato exibe todas as informacoes, tags, notas e campos personalizados.

Bloquear ou desbloquear um contato

1. Na coluna de acoes, clique no icone de bloqueio.
2. Confirme a acao na janela de confirmacao.
3. Contatos bloqueados aparecem com status vermelho e nao podem receber novas mensagens.
4. Para desbloquear, clique no mesmo icone (que agora mostra um simbolo de desbloqueio) e confirme.

Atribuir um responsavel

1. Edite o contato clicando no icone de lapis.
2. No campo Responsavel, selecione o atendente desejado na lista.
3. Clique em Salvar.

Observacao: atribuir responsavel requer a permissao contacts:update_responsible. Usuarios sem essa permissao verao o campo desabilitado.

Para atribuir responsavel em massa, consulte a secao Operacoes em massa abaixo.

Ativar ou desativar o bot para um contato

1. Edite o contato clicando no icone de lapis.
2. No formulario, localize o interruptor Desativar bot para este contato.
3. Ative o interruptor para desabilitar o atendimento automatico (IA/chatbot) para aquele contato especifico.
4. Clique em Salvar.

Quando o bot esta desativado, o contato sera atendido apenas por atendentes humanos.

---

Importacao em Massa

Existem tres formas de importar contatos:

Importar de arquivo (CSV/Excel)

1. No menu de opcoes (tres pontos), selecione Importar/Exportar.
2. Voce sera direcionado para a tela de importacao.
3. Arraste um arquivo ou clique para selecionar. Formatos aceitos: .xls, .xlsx, .csv, .txt.
4. A planilha sera exibida na tela. Para cada coluna, selecione o campo correspondente no Paralela:

Campo disponivel	Descricao
Nome	Campo obrigatorio
Numero	Telefone do contato
E-mail	E-mail do contato
Tags (separadas por virgula)	Tags para categorizar
Responsavel pelo Contato (nome)	Nome do atendente responsavel
Documento (CPF/CNPJ)	Documento do contato
Data de Nascimento (DD/MM/AAAA)	Data no formato brasileiro
Informacao Extra	Campos adicionais (pode mapear varias colunas)

5. Marque as linhas que deseja importar usando as caixas de selecao. Use a caixa no cabecalho para selecionar todas.
6. Opcionalmente, ative Validar contatos no WhatsApp para verificar se os numeros 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 opcoes, selecione Importar do dispositivo.
2. Selecione a conexao de WhatsApp de onde deseja importar os contatos.
3. Os contatos da agenda do dispositivo serao importados automaticamente.

Operacoes em massa

Ao selecionar contatos na lista (usando as caixas de selecao), botoes de acao em massa aparecem:

Acao	Descricao
Adicionar tag	Aplica uma ou mais tags aos contatos selecionados
Atribuir responsavel	Define um atendente responsavel para os selecionados
Excluir selecionados	Remove permanentemente os contatos selecionados

Quando voce seleciona todos os contatos da pagina atual, um botao adicional aparece permitindo selecionar todos os contatos filtrados (incluindo os que nao estao visiveis na tela). Isso permite aplicar acoes em massa a centenas ou milhares de contatos de uma vez.

---

Campos Personalizados

Campos personalizados permitem armazenar informacoes alem dos campos padrao do contato.

Criar campos personalizados

1. Acesse Campos Personalizados no menu lateral (ou pelo icone de engrenagem na secao de campos personalizados ao editar um contato).
2. Crie novos campos definindo:
   • Nome do campo
   • Tipo do campo (texto, numero, data, selecao, etc.)
   • Mascara de formatacao (opcional, para campos como CEP ou telefone alternativo)
   • Se o campo e obrigatorio

Onde os campos aparecem

• No formulario de criacao e edicao do contato, na secao Campos Personalizados
• No painel lateral do ticket, ao visualizar o perfil do contato
• Os valores podem ser usados em automacoes e fluxos

Preencher campos personalizados

1. Edite o contato (icone de lapis).
2. Role ate a secao Campos Personalizados.
3. Preencha os valores de acordo com o tipo de cada campo.
4. Clique em Salvar.

---

Tags e Categorias

Tags sao etiquetas coloridas que ajudam a organizar e segmentar contatos e tickets.

Gerenciar tags

1. Acesse Tags no menu lateral.
2. Para criar uma nova tag, clique no botao 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 (icone de lapis).
2. No formulario, use a secao 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 botao Adicionar tag.
3. Selecione as tags que deseja aplicar.
4. Confirme.

Filtrar contatos por tags

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

Categorias de tags

Categorias agrupam tags relacionadas, facilitando a organizacao quando ha muitas tags. Por exemplo, uma categoria "Interesse" pode conter as tags "Produto A", "Produto B" e "Produto C".

Tags em automacoes

Tags podem ser adicionadas ou removidas automaticamente por fluxos de automacao. 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 formularios no seu site) e os centraliza no Paralela.

Como funciona

A funcionalidade possui duas abas: Configuracoes (trackers) e Leads Capturados.

Criar um tracker

1. Acesse Lead Tracker no menu lateral.
2. Na aba Configuracoes, clique no icone de adicionar.
3. Preencha as configuracoes:

Campo	Descricao
Nome	Nome identificador do tracker
Ativo	Se o tracker esta recebendo leads
Dominios permitidos	Sites autorizados a enviar leads (deixe vazio para todos)
Exigir e-mail	Se o e-mail e obrigatorio no formulario
Criar contato automaticamente	Converte o lead em contato automaticamente
Limite por minuto	Protecao contra abuso (padrao: 60)
Honeypot	Campo invisivel para detectar bots
Deteccao de duplicados	Evita leads duplicados em um intervalo de tempo

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

Obter o script de integracao

1. Na lista de trackers, clique no icone de codigo (</>) do tracker desejado.
2. Copie o script gerado e cole no HTML do seu site.
3. O script enviara os dados do formulario para o 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 especificos.
3. Cada lead exibe: e-mail, nome, telefone, status, origem, tracker e data.

Status	Descricao
Novo	Lead recem-capturado
Contatado	Lead que ja foi abordado
Convertido	Lead transformado em contato
Descartado	Lead considerado invalido

Converter lead em contato

1. Na lista de leads, clique no icone de conversao (pessoa com sinal de mais).
2. O lead sera transformado em um contato no Paralela, com os campos mapeados preenchidos automaticamente.

---

Bairros/Regioes

A funcionalidade de Gestao de Bairros permite organizar contatos por regiao geografica.

Gerenciar bairros

1. Acesse Gestao de Bairros no menu lateral.
2. A tela exibe uma lista de bairros cadastrados com filtros por cidade, estado e status.

Criar um bairro

1. Clique no botao de adicionar.
2. Preencha as informacoes do bairro:
   • Nome
   • Cidade
   • Estado
   • Valores associados (quando aplicavel, como taxa de entrega)
3. Clique em Salvar.

Importar bairros

1. Clique no botao de importacao.
2. Faca upload de um arquivo com a lista de bairros.
3. O sistema importara os registros automaticamente.

Editar bairros em massa

1. Selecione os bairros desejados usando as caixas de selecao.
2. Clique no botao de edicao em massa.
3. Aplique as alteracoes desejadas a todos os bairros selecionados.

Filtrar bairros

Use os filtros disponiveis no cabecalho da pagina:

Filtro	Descricao
Busca	Pesquisa por nome do bairro
Cidade	Filtra por cidade
Estado	Filtra por estado
Status	Filtra por ativo ou inativo

Associar bairros a contatos

O campo de endereco no formulario do contato permite informar a localizacao. O sistema sugere enderecos ja cadastrados conforme voce digita, facilitando a padronizacao.

---

Busca e Filtros

A tela de contatos oferece opcoes de busca e filtragem:

1. Clique no icone de filtro no cabecalho.
2. No painel que aparece, utilize:
   • Campo de busca: pesquisa por nome, numero ou e-mail
   • Filtro por tags: selecione tags para refinar os resultados
3. Os resultados sao atualizados automaticamente conforme voce digita ou seleciona filtros.

A lista carrega contatos sob demanda. Role a pagina para baixo para carregar mais registros automaticamente.