Toda interação na Kontato (agendamento, conversa, cobrança) precisa ter um cliente associado. Esse cliente pode ser criado de várias formas.
Como o cliente é criado
| Forma | Quando acontece |
|---|---|
| Manual | Você clica "Adicionar cliente" em /clientes e preenche o formulário |
| Bot na primeira msg | Cliente novo manda WhatsApp; bot pede o nome e cria automaticamente |
| Agendamento manual | Você cria agendamento e o cliente não existe → wizard inline cria na hora |
Campos do cadastro
Obrigatórios:
- Nome (até 80 chars)
- Telefone (com DDD, formatado automaticamente)
Opcionais (mas valiosos):
- CPF — necessário pra cobranças via Asaas
- Aniversário — para campanhas de aniversário
- Email — backup de contato
- Endereço — útil pra serviços de campo
- Observações — campo livre, só você vê
Telefone — chave principal
O telefone é a identidade primária do cliente na Kontato:
- Bot encontra o cliente pelo telefone do WhatsApp
- Buscas usam últimos 8 dígitos (cobre formatos
(11) 99928-5362,+5511999285362,11999285362) - Mudança de telefone do cliente: edita o cadastro normalmente
CPF — chave secundária (Asaas)
Sem CPF, não dá pra cobrar via Asaas (Pix e cartão). Por isso:
- Quando bot vai cobrar e cliente não tem CPF → bot pede ("Pra finalizar o Pix preciso do seu CPF, pode me mandar?")
- Você também pode adicionar manualmente em qualquer momento
- CPF passa por validação de dígito verificador antes de salvar
Duplicatas — permitidas (de propósito)
A Kontato não bloqueia clientes duplicados (mesmo telefone ou mesmo CPF). Por quê:
- Cliente pode ter 2 números (pessoal + trabalho)
- 2 pessoas podem dividir um celular
- Negócio pode ter cliente "Maria do salão Maria" e "Maria da padaria Maria" com mesmo nome
Mas duplicata vira problema
Se o mesmo cliente aparece 2x com mesmo telefone, o bot pode confundir. Como resolver hoje: identifique manualmente em /clientes (busca por telefone) e atualize/delete o registro errado. Ferramenta nativa de deduplicar/mesclar clientes ainda não existe (ver Cliente trocou de número pro workaround manual).
Editar cliente
Em /clientes/[id], click no botão de editar (ou direto em qualquer campo, dependendo da UX). Salva inline.
Mudanças que cliente vê: mudança de nome aparece no nome em conversas futuras. Mudanças em telefone (raríssimo) podem desconectar conversas antigas.
De onde vem o nome (e o ~ de provisório)
O nome do contato vem, nesta ordem de prioridade:
- O nome que você editou à mão — sempre vence. Depois que você edita o nome de um contato, ele não muda mais sozinho.
- O nome salvo na sua agenda do WhatsApp — se você tem o contato salvo, a Kontato usa esse nome.
- O nome de perfil do WhatsApp (o que a própria pessoa pôs) — quando você ainda não salvou o contato. Esse aparece com um
~na frente (ex:~João), sinalizando que é provisório — vale confirmar/ajustar.
A Kontato revalida o nome (e a foto) na primeira mensagem do dia de cada contato. Então, se você salvar o contato na sua agenda do WhatsApp hoje, o nome provisório vira o nome salvo no dia seguinte.
Atualizar nome e foto do WhatsApp
No detalhe do contato, o botão Atualizar do WhatsApp (ícone de atualizar na foto) busca na hora o nome salvo e a foto de perfil do WhatsApp.
- Se o contato tem foto pública, ela aparece (pode levar um instante).
- Se o nome no WhatsApp estiver diferente de um nome que você editou à mão, a Kontato pergunta antes de trocar — sua edição manual nunca é sobrescrita sem você confirmar.
Soft delete
Clicar em "Excluir cliente" faz soft delete — o registro permanece no banco mas é marcado como deletado. RLS filtra automaticamente, então some das listas. Vantagem: nenhum dado vinculado (agendamentos antigos, conversas, cobranças) se perde.
Se precisar restaurar, hoje só via suporte (não tem botão de "lixeira" público ainda).