O Cliente é a entidade central da Tropicall. Cada ficha é um hub vivo: dados de contato, pipeline, tags, custom fields, anexos, tarefas vinculadas, calendário de atividades, documentos com assinatura digital e ações rápidas em todos os canais — tudo numa tela só. A diferença para um CRM tradicional: a ficha do cliente é onde você vê o que aconteceu, dispara o próximo passo e aprende o estado real do relacionamento. E é onde a IA escreve em tempo real (chamadas do agente de voz, conversas do agente WhatsApp, mudanças automáticas de etapa, automações). Acesse em CRM > Clientes. Para visualizar em funil Kanban, use CRM > Board.Documentation Index
Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
Use this file to discover all available pages before exploring further.
O que tem na ficha do cliente
A página/clients/[id] é organizada em layout de cards em duas colunas (não tabs no nível da página):
Coluna esquerda
- Anexos — upload de documentos do cliente
- Tarefas — embed das tarefas vinculadas (Tarefas)
- Atividades — alterna entre Calendário mensal e Lista cronológica
Coluna direita
- Informações — dados básicos
- Pipeline / Etapa — posição no funil
- Ações rápidas — discador, e-mail, SMS, WhatsApp, gerar documento
- Compartilhamento — permissões para outros usuários da equipe
Informações básicas
- Identificação — nome, código do cliente (12 dígitos auto-gerado), empresa e notas.
- Múltiplos contatos — vários telefones e e-mails, cada um com rótulo opcional (ex: “Principal”, “Comercial”).
- Origem — Manual / Inbound / Campanha / Importação / API — indica como entrou na base.
- Tags — lista de strings para segmentação. Disparam triggers de Automação (
tag_added). - Notas — campo livre para contexto que não cabe em campos estruturados.
Campos customizados
Sua organização define os custom fields no editor inline da ficha (sem sair da tela). Disponíveis em 9 tipos:| Tipo | Uso comum |
|---|---|
| Texto | Notas curtas, identificadores |
| Número | Quantidades |
| Data | Vencimentos, datas-chave |
| Seleção | Lista de opções fixa |
| Multi-seleção | Múltiplas opções |
| URL | Links externos |
| Telefone | Telefones extras |
| E-mails extras | |
| Moeda | Valores monetários |
{{cliente_cpf}}) e disparam triggers de Automação (custom_field_changed).
Anexos
Cada cliente tem uma seção dedicada para arquivos vinculados — contratos, comprovantes, documentos de identidade, planilhas de proposta, screenshots de conversas, etc.Tipos suportados
PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, TXT, CSV, JPEG, PNG, WebP, ZIP
Limite por arquivo
15 MB
Upload
Drag-and-drop ou botão “Adicionar”
Audit trail
attachment_uploaded e attachment_deleted na timelineOs anexos ficam no Supabase Storage (bucket
client-attachments), particionado por organização e cliente. Sem preview inline ainda — o arquivo é baixado pelo link assinado.Tarefas embutidas
A seção Tarefas mostra as últimas 50 tarefas vinculadas ao cliente, ordenadas com abertas primeiro. Ações inline:- Marcar concluída
- Cancelar
- Reabrir
- Editar prazo
/tasks (mesma fonte). Toda mudança reflete em tempo real nas duas telas. Eventos de criação e conclusão também viram atividades task_created / task_completed na timeline.
Calendário de atividades (timeline)
A seção de atividades tem duas visões alternáveis:- Calendário
- Lista
Grade mensal com pontos coloridos nos dias que têm evento. Click no dia abre popover listando o que aconteceu.Ideal para entender padrões: quando o cliente costuma responder, há quantos dias está parado, distribuição de envios.
25+ tipos de evento rastreados
| Categoria | Eventos |
|---|---|
| Comunicação | email_sent, sms_sent, whatsapp_sent |
| Voz | call_inbound, call_outbound, call_campaign, call_attempt, call_failed, call_voicemail, call_dialer |
| Pipeline | stage_change (manual), auto_stage_change (IA pós-call), pipeline_change |
| Documentos | document_generated, document_signature_requested, document_signed |
| Tarefas | task_created, task_completed |
| Anexos | attachment_uploaded, attachment_deleted |
| Retornos | callback_scheduled, callback_cancelled |
| Agendamento (Calendar) | scheduling, rescheduling, cancellation |
| Tags / outros | tag_change, note, created, updated, imported |
Toda atividade carrega
metadata.source (manual / agente / automation / campanha) — feed humano único para qualquer cenário. Um e-mail enviado por automação aparece junto de um e-mail enviado pelo time, com a origem clara.Adicionar nota
O botão Nota abre um formulário rápido para registrar qualquer informação manual. Notas viram atividadenote na timeline e são úteis para contexto que não cabe em campos estruturados.
Pipeline e etapa
- Stepper visual que mostra a etapa atual com cor da stage.
- Quick-add se o cliente ainda não está em pipeline (popover lista pipelines + stages disponíveis).
- Toggle “Classificação automática por IA” — habilita/desabilita classificação pós-chamada para esse cliente específico.
Cada cliente fica em no máximo 1 pipeline/stage por vez. Para detalhes sobre classificação automática e descrições de stage, veja Board e Pipelines.
stage_entry).
Ações rápidas
No cabeçalho/lateral da ficha, um conjunto de botões usa templates e plugins conectados:Discador
Envia o cliente para a fila do discador. Se houver múltiplos telefones, pergunta qual usar.
Envia e-mail com template. Exige Gmail conectado em Plugins.
SMS
Envia SMS com template ou texto livre. Exige Twilio SMS conectado.
Envia WhatsApp com template. Exige WhatsApp conectado.
Gerar documento
Gera PDF a partir de template, com 3 destinos: Baixar / WhatsApp / ClickSign.
Abrir conversa WhatsApp
Abre o chat dentro da plataforma usando o número do cliente que casa com integração ativa.
Botões dependentes de plugin ficam habilitados somente quando a integração correspondente está Ativa em Plugins. SMS/WhatsApp ficam desabilitados se o cliente não tiver telefone cadastrado.
Fluxo de envio (e-mail / SMS / WhatsApp / documento)
Preencher variáveis
A plataforma lista os campos do template com badge de origem — Do cliente, Customizado, Sistema ou Manual. Os automáticos vêm preenchidos; os Manual você completa na hora.
Enviar ou gerar
A ação é executada e registrada na Atividade e na timeline do cliente.
Geração de documento + ClickSign
A geração de documento é integrada com ClickSign — você pode gerar um PDF a partir de template e mandar para assinatura digital sem trocar de ferramenta.Os 3 destinos
Ao gerar o documento, antes do “gerar” final você escolhe a aba:Baixar
PDF é baixado direto no navegador.
PDF é enviado direto no chat do cliente. Escolha integração + legenda opcional.
Assinatura (ClickSign)
PDF é enviado para envelope com signatários e ordem definidas.
Fluxo ClickSign — do template à assinatura
Template
Em Arquivos > Templates de Documentos, crie template em HTML (editor) ou faça upload de DOCX. Use placeholders
{{chave}} para variáveis dinâmicas.Geração na ficha
Clique em Gerar documento na ficha do cliente. Escolha o template; as variáveis aparecem com badges. Preview ao vivo.
Render para PDF
HTML vira PDF via render headless; DOCX vira PDF via LibreOffice. O arquivo é salvo no storage da organização.
Configurar envelope
Adicione signers (cliente, empresa, signatários adicionais), define a ordem:
- Sequencial — cada signer só recebe quando o anterior assinou.
- Paralela — todos recebem ao mesmo tempo.
Pré-requisitos
- ClickSign conectado em Plugins com Access Token + ambiente (Sandbox para testes; Produção para uso real).
- Signatários padrão da empresa podem ser pré-configurados no plugin para reuso.
Compartilhamento
Cada cliente pode ter resource grants — permissões para usuários específicos da equipe verem/editarem aquele cliente, mesmo que não sejam admins. Acesse via dialog Compartilhar no cabeçalho da ficha.Importação em lote
Importe clientes em Excel (.xlsx / .xls) com colunas mapeáveis para nome, telefones, e-mails, empresa, tags, notas e campos customizados. Durante a importação, opcionalmente informe pipeline e etapa; sem etapa, o cliente entra na primeira da pipeline.
Ações em lote na lista
Na tabela de Clientes (e no Board), ao selecionar múltiplas linhas/cartões, a barra de ações permite:- Criar campanha — abre o fluxo de campanha com os clientes selecionados já como base.
- Discador — envia os clientes para a fila do discador e redireciona para Operação > Discador.
- Disparar automação (gatilho
manual) — escolhe automação e dispara para os selecionados.
Relação com ligações
Toda sessão (ligação) registrada na plataforma pode ficar vinculada a um cliente:- Em chamadas inbound, a plataforma tenta localizar um cliente pelo telefone do chamador; se não existir, cria um novo e, se houver pipeline configurada no número, coloca na primeira etapa (veja Números e Board).
- Em campanhas de voz, discador e bloco Ligar de automações, a sessão é associada automaticamente ao cliente.
Cliente como hub central
Toda feature da Tropicall escreve no cliente:| Feature | Como se conecta |
|---|---|
| Agente de voz | Liga/atende, escreve atividades, classifica intent |
| Agente WhatsApp | Identifica pelo telefone, escreve atividades |
| Tools (CRM Action) | Movem cliente, criam tarefa, agendam retorno, adicionam tag |
| Automações | Run é por cliente; cada bloco lê/muta o cliente |
| Campanhas | Itera lista de clientes; cada item vira call/envio com contexto |
| Tarefas | Vinculadas via client_id, embed na ficha |
| Retornos | Run aponta para o cliente; aparecem na timeline |
| Documentos | Geração linkada via client_id |
| ClickSign | Envelope linkado via documento |
| Anexos | Storage particionado por cliente |
Princípio de design: nada vive isolado. Toda ação grava emclient_activitiescommetadata.source(manual / agente / automação / campanha) — feed humano único para qualquer cenário.
Próximos passos
Board e Pipelines
Organize clientes em funis e ative classificação automática
Tarefas
Trabalho humano vinculado ao cliente, com prazo e responsável
Retornos
Callbacks que o agente IA agenda durante a conversa
Automações
Réguas reativas que disparam quando o cliente avança
Templates
Crie templates usados pelos botões de envio e Gerar documento
Plugins
Conecte Gmail, WhatsApp, Twilio, ClickSign e Google Calendar