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.
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).