Clientes (CRM)

Os Clientes são o núcleo do CRM integrado ao TropiCall. Cada registro agrupa dados de contato, histórico de interações e posição em pipelines — e se conecta automaticamente às sessões de voz (inbound, campanhas, discador).

---

​

O que é um Cliente?

Um cliente é uma entidade da sua organização com:

• Identificadores: ID interno (UUID) e código único de 12 dígitos gerado automaticamente pela plataforma (ex.: 847291038456) — útil para busca e referência.
• Dados principais: nome, empresa, notas e tags para segmentação.
• Contatos: vários telefones e vários e-mails, cada um com valor e rótulo opcional (ex.: “Principal”, “Comercial”).
• Pipeline: opcionalmente vinculado a uma pipeline e a uma etapa (stage), com posição no quadro.
• Campos do card: valores alinhados ao esquema de campos da pipeline (card_fields_schema), quando aplicável.
• Campos customizados: objeto JSON livre para dados extras (ex.: CPF, RG, ou qualquer informação do seu processo).

---

​

Origem do cliente

Cada cliente possui uma origem que indica como entrou no sistema:

---

​

Relação com sessões de voz

Toda sessão registrada na plataforma pode estar vinculada a um cliente (client_id):

• Em chamadas inbound, o sistema tenta localizar um cliente pelo telefone do chamador; se não existir, cria um novo (e pode colocá-lo na pipeline configurada no número — veja Números de Telefone e Board).
• Em campanhas e no discador, a sessão fica associada ao contato/cliente correspondente quando aplicável.

Isso permite ver o histórico de ligações na ficha do cliente e alimenta a classificação automática de etapa após conversas com IA (quando o cliente está em uma pipeline).

---

​

Campos customizados da organização

Sua organização pode definir esquemas de campos (texto, número, data, seleção, etc.) para padronizar dados além dos campos básicos. Eles aparecem nos formulários e podem ser usados no mapeamento de importação.

---

​

Importação em lote

​

Importação JSON (POST /clients/import)

• Até 10.000 registros por requisição.
• Opcionalmente informe pipeline e etapa; se a pipeline for informada sem etapa, o cliente entra na primeira etapa (por posição).
• Deduplicação por telefone principal normalizado: linhas com telefone já existente na base são ignoradas conforme a regra do backend.

​

Importação Excel

• Envio de arquivo .xlsx ou .xls com cabeçalhos mapeáveis (nome, telefones, e-mails, empresa, tags, notas, JSON de custom fields ou colunas alinhadas ao esquema da org).
• Em caso de erros de validação, a API pode devolver um arquivo Excel de erros para correção.

---

​

Ações em lote na lista

Na tabela de Clientes, ao selecionar uma ou mais linhas, a barra de ações permite:

• Criar campanha — abre o fluxo de campanha com os clientes selecionados como base.
• Discador — envia os clientes para a fila do discador (usa o primeiro telefone de cada um) e redireciona para Operação > Discador. Detalhes em Discador.

A mesma barra existe no Board ao selecionar cartões.

---

​

Boas práticas

• Mantenha telefones no padrão E.164 (+55…) quando possível para cruzamento correto com inbound e campanhas.
• Use tags e notas para contexto que a equipe e relatórios possam aproveitar.
• Para a IA mover cartões automaticamente, configure pipelines e descrições de etapas com cuidado — veja Board.

---

​

Próximos passos