Appearance
Clientes
Clientes representam as pessoas ou empresas atendidas. Owner, admin, manager e operators que não estejam no modo campo podem consultar e manter clientes.
Antes de cadastrar
Defina quem é o cliente contratante e quais contatos serão usados para operação, portal e WhatsApp. Um cliente pode possuir vários projetos.
Campos
- Nome obrigatório, até 255 caracteres.
- CPF ou CNPJ opcional; a validação atual confere 11 ou 14 dígitos e armazena somente números.
- Até dez contatos: e-mail, celular, telefone residencial, comercial ou outro.
- Um contato pode ser marcado como principal.
- Observações internas de até 2.000 caracteres.
E-mail e telefone principais são derivados dos contatos sincronizados. Preencha-os corretamente quando automações ou WhatsApp dependerem dessas informações.
Cadastrar
- Abra Clientes e selecione criar.
- Informe nome e documento, quando aplicável.
- Adicione contatos, tipo e valor.
- Marque o contato principal.
- Use observações apenas para contexto interno.
- Salve e abra o detalhe para conferir os projetos associados.
Ao criar o cliente, o sistema emite customer.created, que pode iniciar flows ativos e publicados.
Busca e exclusão
A busca considera ID, nome, documento, e-mail, telefone e valores dos contatos. Um cliente com projetos não pode ser excluído; preserve a relação ou trate os projetos antes.
Como validar
- O cliente aparece na lista e na busca.
- Documento foi normalizado.
- Contatos estão na ordem correta e o principal está identificado.
- O cliente aparece como opção ao criar projeto.
- Um flow de cliente criado, se ativo, recebeu o contexto esperado.
Erros comuns
- Documento inválido: informe CPF com 11 dígitos ou CNPJ com 14, com ou sem máscara.
- Não consigo excluir: ainda existem projetos vinculados.
- WhatsApp não identifica o cliente: revise o telefone e o tipo de contato.
- Cliente não aparece no portal: o portal é acessado pelo token do projeto, não por uma página pública geral do cliente.
Segurança
Cadastre somente dados necessários. Não use observações ou contatos para guardar senhas, tokens ou documentos além do escopo operacional.