Contatos

Estrutura do módulo

O gerenciamento de contatos é dividido em três áreas:

Área	Descrição
Contatos	Base geral de todos os contatos
Listas de Contatos	Grupos/segmentos para campanhas
Lista de Bloqueio	Números bloqueados que não recebem mensagens

Contatos (Base Geral)

Dados de um contato

Cada contato possui os seguintes campos:

Campo	Descrição	Obrigatório
Nome	Nome do contato (2-50 caracteres).	Sim
WhatsApp	Número de telefone no formato internacional (ex: 5511999998888).	Sim
Email	Endereço de email.	Não
Documento	CPF ou CNPJ.	Não
Ações	Edital ou Excluir o contato.	Não
Campos extras	Informações personalizadas (chave-valor).	Não

Ações disponíveis

Ação	Descrição
Adicionar contato	Adicionar novo contato manualmente.
Editar contato	Alterar dados de um contato existente
Excluir contato	Remover um ou vários contatos (com checkbox)
Exportar	Baixar contatos em CSV
Importar	Carregar contatos via arquivo CSV

Busca e filtros

Pesquisa por nome ou número de telefone
Busca em tempo real (ao digitar)
Scroll infinito para carregar mais contatos

Importação de contatos

Para importar contatos em massa:

Prepare um arquivo CSV com as colunas: nome;telefone;cpf;email
Use ponto e vírgula (;) como separador
Clique em "Importar" e selecione o arquivo
Máximo de 5MB por arquivo

Exemplo de arquivo:

nome;telefone;cpf;email
João Silva;5511999998888;12345678900;[email protected]
Maria Santos;5511988887777;98765432100;[email protected]

Exportação de contatos

Clique em "Exportar" para baixar um CSV com todos os contatos filtrados. O arquivo terá as colunas: nome, telefone, cpf, email.

Listas de Contatos

Listas permitem organizar contatos em grupos para envio de campanhas segmentadas.

Criando uma lista

Acesse Contatos > Listas de Contatos
Clique em "Nova Lista"
Digite um nome para a lista
Salve

Adicionando contatos à lista

Existem duas formas:

Manualmente:

Abra a lista criada
Clique em "Adicionar Contato"
Preencha os dados

Via importação:

Abra a lista
Clique em "Importar"
Selecione um arquivo Excel/CSV
Baixe o modelo de exemplo se precisar

Validação de WhatsApp

Contatos em listas mostram um indicador de validação:

✓ (verde) = Número válido no WhatsApp
✕ (cinza) = Número não existe no WhatsApp

Diferença entre Contatos e Listas

Contatos (Base Geral)	Listas de Contatos
Todos os contatos da empresa	Grupos específicos para campanhas
Criados automaticamente ao receber mensagem	Criados manualmente para segmentação
Compartilhados entre toda a operação	Podem ter contatos exclusivos
Usados no atendimento	Usados principalmente em campanhas

Histórico do contato

Ao abrir um contato (no atendimento ou cadastro), você tem acesso ao histórico:

Conversas anteriores - Todos os tickets/atendimentos
Campanhas recebidas - Mensagens de campanhas enviadas
Tags aplicadas - Classificações de atendimentos
Notas internas - Observações da equipe

Campos personalizados (Extras)

Você pode adicionar informações extras aos contatos:

Ao editar um contato, vá para "Informações Extras"
Adicione pares de chave-valor
Exemplos: Empresa: ABC Ltda, Segmento: Varejo, Preferência: Email

Esses campos ficam visíveis no painel do contato durante o atendimento.

Atualização em tempo real

O módulo atualiza automaticamente quando:

Novo contato é criado (por mensagem ou cadastro)
Contato é editado por outro usuário
Contato é excluído

Permissões

Ação	Permissão necessária
Visualizar contatos	Acesso básico.
Criar/Editar contatos	Acesso básico.
Excluir contatos	Admin.
Importar/Exportar	Acesso básico.

Boas práticas

Mantenha a base atualizada.

Remova contatos duplicados.
Atualize números inválidos.
Use a validação de WhatsApp nas listas.

Organize com listas

Crie listas por segmento (clientes, leads, região).
Facilita envio de campanhas direcionadas.
Mantenha listas separadas por interesse.

Respeite a blocklist

Nunca reimporte contatos que pediram descadastro.
Monitore pedidos de bloqueio nas campanhas.
Atualize a blocklist regularmente.