Criando e editando contatos manualmente

Embora a maior parte dos contatos seja criada automaticamente quando o cliente envia a primeira mensagem, em vários cenários é necessário cadastrar manualmente: um lead capturado por telefone, uma indicação, uma planilha pequena com poucos contatos novos.

Esta página explica os caminhos disponíveis e as regras que o sistema aplica em cada um deles.

Criando um contato do zero

1. No menu lateral, clique em Contatos.
2. No canto superior direito, clique em Novo contato.
3. Preencha o formulário:

4. Opcionalmente, escolha uma caixa de entrada para associar o contato e gerar uma fonte (source_id) já no cadastro — útil quando o atendente vai iniciar a conversa em seguida.
5. Clique em Salvar.

Importante: o telefone só é aceito se estiver no padrão internacional E.164. Valores fora desse formato são rejeitados pela validação. Padronizar +55DDDNUMERO desde o cadastro garante a identificação automática quando o contato escrever pelo WhatsApp.

Editando um contato existente

1. Abra o contato pela lista ou pela busca global.
2. Clique em Editar no cabeçalho do perfil.
3. Altere os campos desejados e salve.

Você pode editar nome, e-mail, telefone, identificador, empresa, etiquetas, atributos personalizados e notas internas a qualquer momento. As alterações são propagadas para conversas em andamento e ficam disponíveis para auditoria.

Criando contato a partir de uma conversa

Quando uma conversa chega de um canal sem identificação prévia (por exemplo, um webchat anônimo), o sistema cria um contato genérico. Para promovê-lo a um cadastro completo:

1. Abra a conversa.
2. No painel lateral direito, clique em Editar contato.
3. Preencha nome, telefone, e-mail e demais campos.
4. Salve.

Pronto: aquele visitante anônimo passa a ser um contato real e todas as conversas anteriores e futuras dele ficam vinculadas.

Vinculando uma conversa a um contato existente

Se a conversa pertence a alguém que já está na base — por exemplo, o cliente abriu o webchat numa janela anônima e voltou —, é possível mesclar:

1. No painel lateral da conversa, abra o seletor de contato.
2. Busque o contato existente pelo nome, e-mail ou telefone.
3. Confirme a vinculação.

A conversa passa a fazer parte do histórico do contato correto.

Campos avançados

Além dos básicos, todo contato pode ter:

• Atributos personalizados — definidos pela sua operação. Veja Atributos personalizados.
• Etiquetas — para classificação rápida (lead-quente, cliente-vip, inadimplente).
• Notas internas — visíveis apenas para a equipe.
• Empresa associada — útil em operações B2B.

Erros mais comuns ao salvar

• E-mail duplicado — outro contato da mesma conta já usa este endereço. Procure-o pela busca antes de duplicar.
• Telefone fora do padrão — exige + seguido do código do país.
• Identificador duplicado — o identifier é único por conta e costuma vir de um sistema externo.

Boas práticas

• Não duplique — antes de criar manualmente, busque pelo telefone, e-mail ou identificador.
• Padronize formatos — combine com a equipe um padrão único para telefone, CNPJ e nomes próprios.
• Use etiquetas para estados voláteis (lead-quente, follow-up) e atributos para dados estruturados (CNPJ, plano, MRR).
• Registre a origem — preencha um atributo origem_lead desde o cadastro para que relatórios e segmentações funcionem.

Próximos passos

• Atributos personalizados — criar campos sob medida para a sua operação.
• Importação em massa via CSV — quando há muitos contatos a cadastrar.
• Mesclar duplicatas e gerenciar direitos LGPD — corrigir registros repetidos.