Contatos & CRM

Visão geral de Contatos e do CRM

Visão geral A área de Contatos & CRM é onde a Conversa Labs guarda quem é o seu público e o que está acontecendo com cada oportunidade de negócio. Tudo gira em torno do contato: a pessoa com quem você conversa. A partir do contato, a plataforma conecta empresas, atributos personalizados, segmentos, históricos de conversa e os negócios (deals) no CRM. Em resumo, esta categoria reúne quatro blocos que trabalham juntos: - Contatos: cadastro central de pessoas, com importação por CSV e organização em segmentos. - Empresas: agrupam contatos que pertencem à mesma organização. - Atributos personalizados: campos extras que você cria para guardar informações próprias do seu negócio em contatos e conversas. - CRM: pipelines, kanban e negócios para acompanhar oportunidades do primeiro contato ao fechamento, com notas, anexos, checklists, itens de linha, valor e histórico de pedidos. Pré-requisitos - Uma conta Conversa Labs ativa e um usuário com acesso à área de Contatos. - Para o CRM (pipelines, kanban e negócios), o módulo de CRM precisa estar habilitado para a sua conta — em geral já vem ativo. - O módulo Empresas é opcional e pode depender do seu plano; se você não o vê, fale com um administrador. - O Registro de Pedidos (Orders Registry) é um recurso avançado que pode precisar de ativação. Confira o artigo específico. Passo a passo 1. Abra a área de Contatos pela barra lateral. 2. Crie um contato manualmente ou importe sua base por CSV. 3. Organize a base em segmentos (filtros salvos) para encontrar grupos com rapidez. 4. Defina atributos personalizados para guardar os dados que importam ao seu negócio. 5. Abra o CRM e crie ou escolha um pipeline; arraste negócios pelo kanban entre etapas. 6. Em cada negócio, registre notas, anexos, checklists e itens de linha, e acompanhe o valor. 7. Use o Registro de Pedidos para ver o histórico de compras de cada contato. Configurações & opções - Contatos: campos padrão (nome, e-mail, telefone, identificador, cidade, país) e atributos personalizados. - Segmentos: filtros salvos por critérios combinados (atributos, etiquetas, data, etc.). - CRM: pipelines com etapas próprias, probabilidade por etapa e regras de cada negócio. - Permissões: o acesso ao CRM é controlado pela permissão de gestão de CRM; administradores definem quem pode criar e mover negócios. Casos de uso - Centralizar todos os clientes e leads em um só cadastro, vindos de vários canais. - Acompanhar oportunidades de venda em um funil visual, da prospecção ao fechamento. - Segmentar a base para campanhas, follow-ups e relatórios mais precisos. - Registrar o histórico de pedidos de cada cliente para um atendimento mais contextual. Dicas, limites e boas práticas - Padronize os atributos personalizados antes de importar grandes bases — evita retrabalho. - Use segmentos em vez de etiquetas soltas para grupos que você consulta com frequência. - Comece com um pipeline simples e refine as etapas conforme a operação amadurece. - Mantenha um contato por pessoa: duplicidades poluem relatórios e o histórico. Solução de problemas - Não vejo o CRM ou Empresas: o módulo pode não estar habilitado para a conta ou para o seu perfil — fale com um administrador. - Contatos duplicados após importar: confira a coluna de identificador/e-mail no CSV antes de importar novamente. - Não consigo mover um negócio: verifique se você tem a permissão de gestão de CRM. Veja também - Contatos: criar, importar (CSV) e segmentos - Atributos personalizados de contato e conversa - Empresas (companies) e vínculo com contatos - CRM: pipelines, kanban e negócios (deals) - Registro de pedidos (Orders Registry) no CRM

Contatos: criar, importar (CSV) e segmentos

Visão geral O contato é o registro central de cada pessoa com quem você se comunica. Cada contato guarda dados de identificação (nome, e-mail, telefone, identificador), informações adicionais e os atributos personalizados que você definir. A partir do contato você abre conversas, cria negócios no CRM e acompanha o histórico. Você pode alimentar sua base de três formas: criando contatos manualmente, importando um arquivo CSV e deixando que novas conversas criem contatos automaticamente. Para encontrar grupos com rapidez, organize a base em segmentos — filtros salvos por critérios combinados. Pré-requisitos - Uma conta Conversa Labs ativa e um usuário com acesso à área de Contatos. - Para importar, um arquivo CSV com cabeçalho na primeira linha. - Defina antes os atributos personalizados que você quer preencher na importação (veja o artigo de atributos personalizados). Passo a passo Criar um contato manualmente 1. Abra a área de Contatos pela barra lateral. 2. Use a ação de novo contato e preencha pelo menos um dado de identificação (nome, e-mail ou telefone). 3. Salve. O contato fica disponível para conversas e para o CRM. Importar por CSV 1. Na área de Contatos, abra a opção de importar contatos. 2. Baixe o modelo de CSV de exemplo, se oferecido, para conhecer as colunas esperadas. 3. Preencha o arquivo: uma linha por contato, com cabeçalho de colunas na primeira linha. 4. Envie o arquivo. A importação roda em segundo plano. 5. Ao terminar, você recebe uma notificação por e-mail informando o resultado (sucesso ou falha). Criar e usar segmentos 1. Na lista de Contatos, monte um filtro combinando critérios (atributos, etiquetas, datas, etc.). 2. Salve o filtro como segmento, dando um nome claro. 3. Acesse o segmento sempre que precisar daquele grupo, sem refazer o filtro. Ações em massa 1. Na lista de contatos, use o checkbox "Selecionar todos" no topo da lista (ou passe o mouse sobre o avatar de um contato) para marcar contatos. 2. Com a página toda marcada, o botão "Selecionar todos os N contatos" estende a seleção para o conjunto inteiro da visão (todas as páginas, inclusive em visões de etiqueta). 3. Com a seleção ativa, a barra oferece as ações em massa: atribuir/remover etiquetas (com criação de etiqueta na hora, para administradores), alterar tipo (visitante, lead ou cliente), atribuir/remover responsável, bloquear/desbloquear, exportar selecionados (CSV por e-mail, administradores) e excluir (administradores). 4. As ações valem para todos os contatos marcados; a lista atualiza ao concluir. Configurações & opções - Campos padrão: nome, e-mail, telefone, identificador, cidade, país, empresa e status de bloqueio. - Atributos personalizados: colunas extras que você cria para o seu negócio. - Segmentos: salvos por usuário e reutilizáveis; cada usuário tem um limite de filtros salvos. - Deduplicação: e-mail, telefone e identificador ajudam a evitar contatos repetidos. Casos de uso - Subir uma base existente de outra ferramenta via CSV em poucos minutos. - Criar um segmento de "leads sem resposta nos últimos 7 dias" para um follow-up. - Separar clientes por cidade ou por atributo personalizado para campanhas regionais. Dicas, limites e boas práticas - Garanta que o CSV está em UTF-8 para preservar acentos e caracteres especiais. - Use uma coluna de identificador único (ou e-mail/telefone) para evitar duplicidades. - Importe primeiro um lote pequeno de teste antes da base completa. - Padronize formatos (telefone em formato internacional, datas no mesmo padrão). Solução de problemas - A importação falhou: confira o e-mail de notificação; normalmente há erro de cabeçalho, codificação ou formato de coluna. - Contatos duplicados: verifique se a coluna de identificador/e-mail está preenchida e consistente. - Acentos quebrados: salve o CSV novamente em UTF-8 e importe de novo. - Não encontro um segmento: segmentos são salvos por usuário; confirme que está no usuário certo. Veja também - Visão geral de Contatos e do CRM - Atributos personalizados de contato e conversa - Empresas (companies) e vínculo com contatos

Dados fiscais e endereço do contato (CPF/CNPJ, cobrança)

Visão geral Cada contato guarda, de forma nativa, a identidade fiscal — tipo (Pessoa Física ou Pessoa Jurídica), CPF/CNPJ e país fiscal — e o endereço completo (CEP, rua, número, complemento, bairro, cidade, UF e país). Opcionalmente, um endereço de cobrança diferente do principal. Esses dados alimentam automaticamente os módulos que precisam deles: Pagamentos preenche o pagador (documento e endereço) ao criar cobranças e assinaturas, os modelos de mensagem e automações ganham variáveis como {{contact.address_city}}, e a IA da conta enxerga o endereço para dar contexto. O documento aparece por extenso para a equipe no painel e no formulário; ele só é mascarado quando um papel de acesso manda mascarar, para bots/integrações e nas saídas externas (webhooks, exportação CSV e variáveis de mensagem). Pré-requisitos - Permissão para editar contatos. - Para o preenchimento automático de cobranças: uma conexão de gateway ativa em Pagamentos. Passo a passo 1. Abra o contato (página de Contatos ou painel da conversa) e clique em Editar. 2. Preencha o Tipo (Pessoa Física ou Jurídica), o CPF/CNPJ e o país fiscal (ex.: BR). Um documento já salvo vem preenchido com o valor real: basta editá-lo para corrigir, ou apagar o campo para removê-lo. 3. Na seção Endereço, informe o CEP: rua, bairro, cidade e UF são preenchidos automaticamente. Complete número e complemento. 4. Se a cobrança deve ir para outro endereço, marque Endereço de cobrança diferente. Use o botão Copiar do endereço principal para trazer tudo com um clique e ajustar só o que muda. 5. Salve. A partir daí, cobranças e assinaturas criadas para esse contato já vêm com documento e endereço preenchidos. Configurações & opções - Visibilidade do documento: o CPF/CNPJ é validado ao salvar (dígitos verificadores) e fica visível para a equipe. Para escondê-lo de parte do time, use Funções & acessos e defina a regra do campo tax_id como mascarado (mostra ***.***.***-09) ou oculto. O valor é sempre guardado criptografado. - Endereço de cobrança: desmarcar a opção volta a usar o endereço principal na cobrança. - Importação CSV: as colunas legal_type, tax_id, tax_country, address_zip, address_street, address_number, address_complement, address_neighborhood, address_city, address_state e address_country preenchem os campos nativos. - Exportação: o documento sai sempre mascarado; o endereço sai em colunas achatadas (address_*). - Variáveis: {{contact.masked_tax_id}}, {{contact.legal_type}}, {{contact.tax_country}} e {{contact.address_zip}} … {{contact.address_country}} funcionam em respostas prontas, macros, automações, follow-ups e no FlowBuilder. Casos de uso - Emitir boleto no Mercado Pago sem pedir endereço de novo: o contato já tem tudo. - PJ com sede (principal) e faturamento em outra unidade (cobrança). - Segmentar por cidade/país — o endereço alimenta os filtros de localização do contato. - Segmentar por tipo de pessoa (PF/PJ), tipo de documento, país fiscal e endereço (CEP, cidade, estado, país) nos filtros avançados e segmentos de contatos. - Automatizar: a ação "Definir campo do contato (fiscal/endereço)" em automações, macros e fluxos grava tipo de pessoa, documento e endereço direto nos campos nativos — por exemplo, um fluxo que pergunta o CPF/CNPJ e salva a resposta no contato. - Condicionar: automações disparadas por contato podem filtrar por tipo de pessoa, tipo de documento, país fiscal e endereço; nos fluxos, o nó de condição usa as mesmas variáveis do contato. Dicas, limites e boas práticas - Documentos brasileiros são validados por dígito verificador; um documento inválido não é salvo no campo nativo (a cobrança ainda pode ser criada com o valor digitado — o gateway decide). - Quem já usava os atributos personalizados de pagamento (payment_document, payment_address_*) não perde nada: os valores continuam sendo lidos como reserva até a migração automática, e as cobranças passam a gravar somente nos campos nativos. - O CEP com preenchimento automático cobre endereços do Brasil; para outros países, preencha manualmente. Solução de problemas - "O CPF/CNPJ não foi salvo": confira os dígitos — documentos com dígito verificador inválido são rejeitados para proteger a cobrança. - A cobrança pede documento mesmo com o contato preenchido: verifique se o documento aparece preenchido no painel do contato; se estiver vazio, salve-o novamente. - Endereço não preencheu pelo CEP: o serviço de CEP pode estar indisponível — preencha manualmente; nada é sobrescrito. Veja também - Contatos: criar, importar (CSV) e segmentos - Criar cobrança e enviar na conversa - Assinaturas e planos

Atributos personalizados de contato e conversa

Visão geral Os atributos personalizados são campos que você cria para guardar informações que a plataforma não traz de fábrica — por exemplo, CPF/CNPJ, plano contratado, origem do lead, número de pedido ou qualquer dado relevante para a sua operação. Cada atributo é definido uma vez (com um nome, uma chave e um tipo) e passa a aparecer no painel lateral das conversas e/ou no cadastro de contatos. Você pode usar atributos como critério de segmentos, em automações, em campanhas e na importação por CSV. Pré-requisitos - Uma conta Conversa Labs ativa. - Permissão de administração para criar e editar definições de atributos. - Defina o tipo de cada campo antes de criar (texto, número, data, lista, etc.). Passo a passo 1. Acesse as Configurações da conta e abra a seção de atributos personalizados. 2. Crie uma nova definição e escolha onde ela se aplica: contato ou conversa. 3. Informe um nome de exibição (o que a equipe vê) e o sistema gera uma chave estável. 4. Selecione o tipo do campo (veja a tabela abaixo). 5. Para listas, informe os valores possíveis; salve a definição. 6. Abra um contato ou conversa e preencha o novo atributo no painel lateral. Configurações & opções A plataforma oferece estes tipos de atributo: | Tipo | Para que serve | | --- | --- | | Texto | Texto livre (observações, códigos) | | Número | Valores numéricos | | Moeda | Valores monetários | | Percentual | Porcentagens | | Link | URLs clicáveis | | Data | Datas | | Lista | Escolha entre valores predefinidos | | Caixa de seleção | Verdadeiro/falso | - Modelo do atributo: contato (vale para a pessoa) ou conversa (vale para aquele atendimento). - Chave única: cada chave é única por modelo e não pode conflitar com campos padrão. - Validação opcional: alguns campos aceitam um padrão (regex) para garantir o formato. - A Conversa Labs também usa atributos personalizados em outros módulos (CRM, catálogo, tarefas, agenda, entre outros), cada um na sua área de configuração. Casos de uso - Guardar o CPF/CNPJ ou documento do cliente no contato. - Marcar a origem do lead (anúncio, indicação, site) como uma lista. - Registrar um número de pedido ou de protocolo na conversa. - Criar segmentos como "clientes do plano Pro" usando um atributo de lista. Dicas, limites e boas práticas - Escolha o tipo certo desde o início — mudar o tipo depois pode exigir reedição dos dados. - Use listas em vez de texto livre para campos com poucas opções (evita variações como "WhatsApp" e "whats"). - Padronize a nomenclatura das chaves antes de importar grandes bases por CSV. - Atributos de contato seguem a pessoa; atributos de conversa valem apenas para o atendimento. Solução de problemas - Não consigo criar o atributo: a chave pode já existir ou conflitar com um campo padrão — use outro nome. - O valor não aparece na importação: confira se o cabeçalho do CSV usa exatamente a chave do atributo. - O campo não aceita o valor: pode haver uma validação de formato (regex) definida na definição. Veja também - Contatos: criar, importar (CSV) e segmentos - Empresas (companies) e vínculo com contatos - CRM: pipelines, kanban e negócios (deals)

Empresas (companies) e vínculo com contatos

Visão geral O módulo de Empresas permite agrupar contatos que pertencem à mesma organização. Em vez de tratar cada pessoa isoladamente, você passa a enxergar a conta corporativa: quem são os contatos daquela empresa, quantos atendimentos ela gerou e quais negócios estão em andamento. É especialmente útil em operações B2B, em que vários contatos (compras, financeiro, suporte) falam com você em nome de uma mesma empresa. Pré-requisitos - O módulo de Empresas é opcional e pode depender do seu plano. Se você não o vê, ele pode estar desativado para a sua conta — fale com um administrador. - Permissão de administração para habilitar e configurar o módulo. - Tenha os contatos já cadastrados para vinculá-los à empresa. Passo a passo 1. Confirme com um administrador que o módulo de Empresas está habilitado para a conta. 2. Crie uma empresa informando ao menos o nome (e, opcionalmente, domínio e descrição). 3. Vincule contatos à empresa, associando as pessoas da mesma organização. 4. Abra a empresa para ver os contatos relacionados e o contexto agregado. 5. Use atributos personalizados de empresa para guardar dados próprios (segmento, porte, etc.). Configurações & opções - Campos da empresa: nome, domínio, descrição e contagem de contatos. - Atributos personalizados de empresa: campos extras criados na área de atributos. - Vínculo com contatos: um contato pode ser associado à sua empresa para herdar o contexto. - CRM: um negócio pode ser ligado a uma empresa (organização) além do contato, conectando a oportunidade à conta corporativa. Casos de uso - Centralizar todos os contatos de um cliente corporativo em uma única visão. - Acompanhar, em B2B, quantas oportunidades existem por empresa, não só por pessoa. - Enriquecer relatórios e segmentos com dados da organização (porte, segmento de mercado). Dicas, limites e boas práticas - Use o domínio da empresa para padronizar e evitar empresas duplicadas. - Vincule os contatos certos: o valor do módulo está na consolidação por organização. - Combine com atributos personalizados de empresa para análises mais ricas. Solução de problemas - Não vejo o módulo de Empresas: ele pode estar desabilitado para a conta ou para o seu plano — fale com um administrador. - Empresas duplicadas: padronize por domínio e una os registros repetidos. - Contato sem empresa: confirme se ele foi vinculado à organização correta. Veja também - Visão geral de Contatos e do CRM - Contatos: criar, importar (CSV) e segmentos - Atributos personalizados de contato e conversa - CRM: pipelines, kanban e negócios (deals) - Empresas & Relacionamentos: organizações, papéis e hierarquia

Empresas & Relacionamentos: organizações, papéis e hierarquia

Visão geral O módulo de Empresas & Relacionamentos transforma organizações em entidades de primeira classe na plataforma. Cada empresa reúne identidade fiscal (CPF/CNPJ, EIN, VAT), múltiplos domínios, endereço, responsável e estágio no ciclo de vida — e conecta tudo o que acontece ao redor dela: contatos com papéis (Responsável financeiro, Aluno, Corretor…), conversas, negócios do CRM e uma visão 360 com indicadores agregados. A Visão geral soma somente os registros vinculados diretamente à empresa: contatos, conversas, negócios, tarefas, contratos, pedidos, cobranças, assinaturas, reuniões e follow-ups. Isso evita misturar dados sem relação. Matriz e filiais continuam navegáveis na aba Hierarquia, cada uma com seus próprios números. Ele foi desenhado para qualquer nicho: escolas (responsável ⟷ aluno), contabilidades (contador ⟷ cliente), imobiliárias (fiador ⟷ afiançado), clínicas (responsável ⟷ paciente), agências e operações B2B com estrutura matriz/filial. Pré-requisitos - O módulo é opcional e chega desativado; um administrador precisa habilitá-lo para a conta. - Permissão de administração para configurar tipos de relacionamento e as opções do módulo. - Contatos já cadastrados para vincular às empresas (a importação de contatos ajuda aqui). Passo a passo 1. Com o módulo habilitado, abra Empresas no menu lateral. 2. Clique em Nova empresa e informe ao menos o nome. Escolha o tipo (pessoa física ou jurídica), o país e o documento fiscal — CPF e CNPJ são validados com dígitos verificadores, e o valor fica visível para a equipe (mascarado apenas se um papel de acesso mandar). 3. Preencha as inscrições fiscais (estadual e municipal) quando a empresa emitir nota — os campos ficam logo abaixo do documento. 4. Informe os domínios da empresa (o primeiro é o principal). Com a associação automática ativa, novos contatos com e-mail corporativo daquele domínio são vinculados sozinhos. 5. Escolha o responsável (o agente dono da conta), o porte e o fuso horário — os três são listas fechadas, então filtros e segmentos encontram exatamente o mesmo valor que você escolheu aqui. 6. Preencha o endereço completo: digite o CEP e os demais campos são preenchidos sozinhos; ajuste número e complemento. O endereço inteiro (logradouro, número, complemento, bairro, cidade, UF e CEP) aparece na Visão geral e é o mesmo que as cobranças PJ usam. 7. Na aba Contatos da empresa, vincule pessoas com papel e cargo; marque uma empresa como principal de cada contato. 8. Na aba Relacionamentos, conecte contatos e empresas com tipos que têm rótulo e inverso (ex.: "Responsável" ⟷ "Dependente"). Aplique um preset de nicho em Configurações para começar com o vocabulário certo. 9. Para grupos empresariais, defina a matriz no campo de hierarquia da filial — a árvore aparece na aba Hierarquia. 10. Use Carregar demonstração nas configurações para criar 10 empresas variadas e conectadas, com 20 contatos e exemplos nativos de negócios, tarefas, pedidos, pagamentos, contratos, reuniões, conversas e follow-ups. A remoção da demonstração apaga apenas esses dados marcados. Configurações & opções - Tipos de relacionamento: catálogo próprio da conta, com rótulo, inverso e categoria; presets idempotentes para escola, contabilidade, imobiliária, clínica, agência e B2B. - Associação automática por domínio: liga/desliga a associação de contatos por e-mail corporativo (domínios gratuitos como gmail.com são ignorados; vínculos manuais nunca são sobrescritos). - Atributos personalizados: crie campos próprios de empresa em Configurações → Atributos Personalizados, na aba Empresas. Eles aparecem e são editáveis no cartão Atributos personalizados da Visão geral da empresa. - Estágios do ciclo de vida: use o campo de estágio (lead, cliente…) para filtrar a lista e montar segmentos. - Relacionamentos: o botão Adicionar relacionamento aceita outra empresa ou um contato; cada item abre o cadastro correspondente para continuar a análise. - Visão 360: os cartões resumem cada módulo e preservam os vínculos para abrir o registro de origem, sem duplicar informações. - Importação e exportação: a exportação traz o endereço em colunas separadas (address_zip_code, address_street_name, …), as inscrições e os domínios — o mesmo formato que a importação lê. Um arquivo exportado volta pela importação sem perder campos. A única exceção deliberada é o documento fiscal: ele sai sempre mascarado e a importação recusa valores mascarados, para o CPF/CNPJ nunca trafegar em claro numa planilha. Casos de uso - Escola: a organização é o colégio; pais entram como "Responsável financeiro" dos alunos e a recepção enxerga a família inteira antes de responder. - Contabilidade: cada cliente PJ é uma empresa com CNPJ validado; o contador acompanha conversas e cobranças da carteira por empresa. - Grupo empresarial: matriz e filiais em hierarquia, com a visão 360 consolidando conversas e negócios de cada unidade. Dicas, limites e boas práticas - O documento fiscal fica preenchido no formulário depois de salvo, pronto para corrigir. Ele só aparece mascarado se a regra de campo tax_id do papel de acesso mandar. - A hierarquia rejeita ciclos (uma filial não pode ser matriz da própria matriz). - Cada contato tem uma empresa principal; os demais vínculos continuam valendo para busca e relacionamentos. - Automações, macros e fluxos funcionam com empresas: além de Definir a empresa do contato e Definir estágio da empresa, existem Definir campo da empresa (documento, endereço, e-mail, telefone, fuso, inscrições…) e Definir atributo personalizado da empresa. Assim, um fluxo que coletou o CNPJ ou o CEP grava direto na ficha. - As condições e os segmentos agora alcançam e-mail, telefone, site, fuso, esquema do documento e os campos de endereço (cidade, UF, bairro, logradouro, CEP) — dá para perguntar "empresas de SP sem e-mail cadastrado". - Nas mensagens, campanhas, follow-ups e fluxos, use as variáveis de empresa: {{organization.address}} (endereço completo), {{organization.address_city}}, {{organization.state_registration}} e as demais. Nos contratos essas variáveis ainda não existem: o modelo de contrato resolve contact.*, crm_item.*, conversation.*, account.* e company.* (a sua empresa emissora) — use uma variável manual para dados da empresa contratante. Solução de problemas - Não vejo o menu Empresas: o módulo está desativado para a conta — peça a um administrador. - Documento recusado: o valor não passou na validação (dígitos verificadores de CPF/CNPJ ou formato de EIN/VAT). Confira o número e o país selecionado. - Contato não foi associado sozinho: verifique se a associação automática está ativa, se o domínio do e-mail é corporativo e se o contato já não tinha vínculo manual. - Não consigo excluir um tipo de relacionamento: ele está em uso por relacionamentos existentes; remova-os primeiro. - CEP, logradouro, número ou UF apareciam vazios ao editar: era uma falha corrigida — o formulário não lia essas quatro chaves e, ao salvar, gravava os campos em branco por cima do que estava guardado. Hoje o formulário carrega o endereço inteiro e uma gravação parcial nunca apaga um campo que não foi enviado. Se algum endereço foi perdido antes da correção, basta preencher de novo. - Vejo CPF/CNPJ, CEP, Logradouro, Cidade… entre os atributos do contato: são os sete campos antigos de pagamento, hoje substituídos pelos campos fiscais e de endereço nativos do contato. Um administrador pode aposentá-los com rake "organizations:cleanup_legacy_payment_attributes[<id_da_conta>,apply]" — a tarefa migra os valores para os campos nativos e remove só as definições; nenhum dado é apagado. Veja também - Contatos: importação e segmentos - Atributos personalizados - CRM: pipelines e negócios

CRM: pipelines, kanban e negócios (deals)

Visão geral O CRM da Conversa Labs organiza suas oportunidades de venda em pipelines (funis). Cada pipeline tem etapas (por exemplo, Lead, Qualificado, Proposta, Negociação, Ganho, Perdido), e cada oportunidade é um negócio (deal) que avança pelas etapas em um quadro kanban. Um negócio reúne tudo o que importa sobre a oportunidade: título, valor, etapa atual, prioridade, responsável, contato e empresa relacionados, data prevista de fechamento e o histórico de movimentações. Quando o negócio é ganho ou perdido, você registra a data e, opcionalmente, o motivo. Pré-requisitos - O módulo de CRM (pipelines) precisa estar habilitado para a conta — em geral já vem ativo. - Permissão de gestão de CRM para criar e mover negócios. Sem ela, você pode apenas visualizar. - Contatos cadastrados para associar aos negócios. Passo a passo Criar um pipeline 1. Abra o CRM pela barra lateral. 2. Crie um novo pipeline. Você pode começar de um modelo pronto (por nicho) ou montar do zero. 3. Ajuste as etapas: nome, ordem e probabilidade de fechamento de cada uma. Criar e mover negócios 1. Dentro do pipeline, crie um negócio com título e, se quiser, valor e contato. 2. Defina prioridade, responsável e data prevista de fechamento. 3. No quadro kanban, arraste o cartão do negócio entre as etapas conforme ele evolui. 4. Ao concluir, marque o negócio como Ganho ou Perdido, informando a data e o motivo. 5. Precisa corrigir a data de abertura (por exemplo, um negócio cadastrado com atraso)? Na página do negócio, clique no selo com a data de abertura ao lado do título — ou edite o campo Data de abertura no formulário. O ciclo de venda e os relatórios passam a considerar a data corrigida. Configurações & opções - Etapas: cada etapa tem nome, cor e probabilidade (a etapa "Ganho" é 100% e "Perdido" 0%). - Modelos de pipeline: catálogo de funis prontos por nicho (vendas B2B, imobiliária, e-commerce, pós-venda, onboarding e mais) para começar rápido. - Campos do negócio: título, valor, moeda, prioridade, responsável, contato, empresa, equipe, data de abertura e data prevista de fechamento. - Saúde do negócio: a plataforma pode calcular um indicador de saúde para sinalizar negócios parados ou em risco. - Filtros e visões salvas: salve combinações de pipeline, período e filtros para reusar. Casos de uso - Acompanhar um funil de vendas visual, com cada negócio em sua etapa. - Priorizar a carteira pela data prevista de fechamento e pela saúde do negócio. - Conectar a conversa do cliente diretamente ao negócio correspondente. - Medir taxas de conversão por etapa e por pipeline nos relatórios. Dicas, limites e boas práticas - Comece com um pipeline simples; etapas demais dificultam a leitura do funil. - Mantenha a probabilidade das etapas realista — ela alimenta previsões de receita. - Use a data prevista de fechamento para priorizar e evitar negócios esquecidos. - Registre sempre o motivo de perda para aprender com as oportunidades não fechadas. Solução de problemas - Não consigo mover um negócio: confirme que você tem a permissão de gestão de CRM. - Não vejo o CRM: o módulo pode estar desabilitado para a conta — fale com um administrador. - O valor previsto não bate: revise a probabilidade das etapas e o valor de cada negócio. Veja também - Visão geral de Contatos e do CRM - Negócios: notas, anexos, checklists, itens de linha e valor automático - Empresas (companies) e vínculo com contatos - Registro de pedidos (Orders Registry) no CRM

Avançar uma etapa por vez no funil (etapas sequenciais)

Visão geral Um funil só conta a verdade se cada negócio passar pelas etapas na ordem. Quando um negócio salta de Contato direto para Fechado, o relatório de conversão fica sem sentido: parece que a oportunidade fechou sem qualificação, sem proposta e sem negociação. Esse salto acontecia com frequência quando o Robô movia negócios. Ele enxergava apenas o número da etapa de destino, sem o nome nem o tipo — então escolhia pelo nome do desfecho ("Fechado", "Ganho") e pulava o meio do funil. Duas correções foram feitas: 1. O Robô agora enxerga o funil em ordem. Ao consultar as etapas de um pipeline, ele recebe a sequência real, com o nome e o tipo de cada etapa (em aberto, ganho ou perdido). Isso reduz muito o salto, porque ele passa a entender que aquilo é um funil, e não um menu de opções. 2. Existe uma opção por pipeline que RECUSA a movimentação com salto. É a garantia dura: quando ligada, o servidor devolve erro e o negócio não sai do lugar. A primeira correção é orientação. A segunda é regra. Se a operação precisa de garantia, ligue a opção. Pré-requisitos - Módulo CRM habilitado na conta. - Pelo menos um pipeline com etapas já criado e na ordem correta (a ordem das etapas na tela de configuração é a ordem que a regra usa). - Perfil de Administrador para ligar ou desligar a opção. Agentes veem a configuração, mas não conseguem alterá-la. Passo a passo 1. Abra CRM no menu lateral. 2. Clique em Configurações (engrenagem) do CRM e selecione o pipeline que quer proteger. 3. Role até a seção Fechamento de negócios — a mesma que contém Exigir um motivo ao marcar como ganho ou perdido. 4. Ative a chave Avançar uma etapa por vez. 5. Pronto. A partir daí, qualquer tentativa de mover um negócio pulando etapa é recusada — venha ela do quadro kanban, da lista, de uma automação, do FlowBuilder ou do Robô. Para desligar, basta desativar a mesma chave. A configuração é por pipeline: você pode exigir a sequência no funil de vendas e deixar livre o funil de suporte. Configurações & opções | Opção | Onde fica | Padrão | O que faz | |---|---|---|---| | Avançar uma etapa por vez | Configurações do pipeline → Fechamento de negócios | Desligada | Recusa mover um negócio pulando etapas | | Exigir um motivo ao marcar como ganho ou perdido | Mesma seção | Desligada | Pede um motivo escrito no fechamento | As duas opções são independentes e podem ser usadas juntas. O que continua SEMPRE permitido, mesmo com a opção ligada: - Voltar etapa. Recuar não é pular. Um negócio pode voltar de "Proposta" para "Qualificação" quantas vezes for preciso. - Marcar como perdido. Uma etapa do tipo perdido é sempre alcançável, de qualquer ponto do funil. Negócio morre a qualquer momento — a regra nunca prende um negócio vivo em um funil onde ele já acabou. - Avançar para a próxima etapa. A regra bloqueia o salto, não o avanço normal. O que fica bloqueado é o pulo para frente: sair da etapa 1 e cair na etapa 4. Isso inclui pular direto para uma etapa de ganho — ganhar sem passar pelo funil também distorce o relatório. Como a recusa aparece: a plataforma devolve uma mensagem que nomeia a etapa que falta, por exemplo: "Este pipeline avança uma etapa por vez. Mova este negócio para 'Proposta' primeiro." Isso é proposital — o Robô lê essa mensagem e se corrige sozinho, movendo para a etapa certa em vez de repetir o mesmo salto. Casos de uso - Funil de vendas com relatório confiável. Se o time é medido por taxa de conversão entre etapas, o salto quebra a métrica. Ligue a opção nesse pipeline. - Robô movendo negócios sozinho. Quando o Robô tem permissão para mover negócios no CRM, a opção é a rede de segurança que impede o "fechou tudo" acidental. - Time novo em treinamento. Pessoas também erram arrastando cartão no kanban. A regra ensina o processo na prática, com uma mensagem que diz exatamente para onde mover. - Funil operacional sem ordem rígida (suporte, triagem, produção): deixe desligada. Nem todo quadro é um funil sequencial. Dicas, limites e boas práticas - A regra vale para pessoas também, não só para o Robô. Ela é aplicada no servidor, no momento de gravar a movimentação. O Robô age com a mesma credencial do time, então não existe como aplicar a regra só para ele — e isso é bom: a mesma disciplina vale para todo mundo. - A ordem das etapas é a ordem que aparece na configuração do pipeline. Se você reordenar as etapas, a regra passa a valer pela nova ordem imediatamente. Revise a ordem antes de ligar. - LIMITE HONESTO — a regra falha aberta. Se a plataforma não conseguir determinar a posição de uma das etapas envolvidas (por exemplo, o negócio está parado em uma etapa que foi arquivada depois), a movimentação é permitida, e não bloqueada. A escolha foi deliberada: é preferível deixar passar um caso raro a prender um negócio sem saída. A opção previne o salto comum; ela não substitui revisão humana do funil. - Desligada por padrão. Nenhum pipeline existente muda de comportamento até alguém ligar a chave. - Reordenar um cartão dentro da mesma etapa não é movimentação de etapa — nunca é bloqueado. - Se você também ativou Exigir um motivo ao marcar como ganho ou perdido, o motivo continua obrigatório ao fechar, inclusive quando o fechamento acontece arrastando o cartão. Solução de problemas "Não consigo arrastar o cartão para a etapa que eu quero." Leia a mensagem: ela diz o nome da etapa pela qual o negócio precisa passar antes. Mova para essa etapa e siga. Se o processo realmente pula essa etapa no dia a dia, a etapa provavelmente não deveria existir — ou a opção não deveria estar ligada nesse pipeline. "O Robô continua pulando etapas." Confirme que a chave está ligada no pipeline daquele negócio (a configuração é por pipeline, não por conta). Com a chave ligada, o salto é recusado no servidor — o Robô não tem como contornar. "Ligamos a opção e um negócio ficou preso." Marcar como perdido e voltar etapa são sempre permitidos, então um negócio nunca fica sem saída. Se mesmo assim algo parece travado, verifique se a etapa atual do negócio ainda existe e está ativa na configuração do pipeline. "A chave está desabilitada para mim." Somente Administradores podem alterar as configurações do pipeline. Peça a um administrador. "Um salto passou mesmo com a opção ligada." É o comportamento de falha aberta descrito acima: quando a posição de uma etapa não pode ser determinada, a movimentação passa. Verifique se alguma etapa do caminho foi arquivada e reorganize o funil. Veja também - CRM: pipelines, kanban e negócios (deals) - Relatórios e análises do CRM (funil, SLA e previsão) - Ferramentas do Maestro por módulo e como habilitá-las - Modos de autonomia do Robô e aprovação humana (HITL)

Negócios: notas, anexos, checklists, itens de linha e valor automático

Visão geral Um negócio (deal) no CRM da Conversa Labs vai muito além do título e da etapa. Cada negócio reúne recursos que contam a história completa da oportunidade: - Notas — registros internos da equipe sobre o andamento. - Anexos — arquivos relacionados (propostas, contratos, comprovantes). - Checklists — tarefas a cumprir, com contagem de itens concluídos. - Itens de linha — produtos do catálogo e suas quantidades, com o preço capturado no momento da inclusão. - Valor — o montante do negócio, que pode ser automático (somado dos itens de linha) ou manual (digitado por você). Quando você adiciona itens de linha, a plataforma calcula o valor do negócio automaticamente, somando o total de cada linha. Isso transforma o negócio em um pequeno orçamento consistente. Pré-requisitos - O módulo de CRM (pipelines) habilitado e um negócio já criado. - Permissão para editar o CRM para alterar notas, anexos, checklists, itens e valor. - Para puxar itens do catálogo, o módulo de Catálogo com produtos cadastrados. Passo a passo Adicionar notas e anexos 1. Abra o negócio no CRM. 2. Na área de trabalho, selecione Adicionar nota. O compositor fica disponível tanto no Histórico quanto em Notas salvas, sem duplicar o rascunho. 3. Escreva o contexto da conversa ou decisão e selecione Salvar. Com o editor em foco, você também pode usar ⌘/Ctrl + Enter. 4. Use Histórico para acompanhar mudanças do negócio e filtre por etapa, agentes, vínculos, notas ou edições. Use Notas salvas para consultar, editar, excluir ou carregar notas antigas. 5. Ao excluir uma nota, confirme a ação com atenção: a exclusão é permanente e não pode ser desfeita. 6. Anexe arquivos relevantes ao negócio para manter tudo em um só lugar. A aba e o filtro ativos ficam no endereço da página. Ao recarregar ou compartilhar o link, a área de trabalho abre no mesmo contexto. Criar um checklist 1. No negócio, abra a seção de checklist. 2. Adicione os itens que precisam ser concluídos (ex.: enviar proposta, agendar reunião). 3. Marque cada item conforme avança; a plataforma mostra o total concluído. Montar o orçamento com itens de linha 1. Na seção de itens de linha, selecione um produto disponível no catálogo. 2. Defina a quantidade e adicione a linha. O preço unitário é capturado do catálogo. 3. A plataforma calcula o total de cada linha e soma tudo no valor do negócio. 4. Para voltar a um valor manual, remova os itens de linha. Configurações & opções - Valor automático vs manual: havendo qualquer item de linha, o valor passa a ser automático (soma das linhas). Sem itens de linha, você define o valor manualmente. - Edição do orçamento: nesta tela, produto e preço vêm do catálogo; para corrigir uma linha, remova-a e adicione novamente com o produto e a quantidade desejados. - Moeda única por negócio: todas as linhas usam a mesma moeda do negócio; a primeira linha define a moeda. - Snapshot do catálogo: ao adicionar um item do catálogo, o nome e o preço são congelados naquele momento — editar o produto no catálogo depois não altera o orçamento já montado. - Contadores: o negócio exibe contagens de notas, anexos e itens de checklist (concluídos/total). - Rascunho por negócio: trocar entre Histórico e Notas salvas preserva o texto; navegar para outro negócio usa um rascunho separado para evitar registrar conteúdo no lugar errado. - Histórico no fuso da conta: datas e agrupamentos do histórico seguem o fuso horário definido para a conta. Casos de uso - Montar uma proposta dentro do próprio negócio, com produtos e quantidades do catálogo. - Acompanhar um checklist de qualificação antes de avançar a etapa. - Centralizar a proposta em PDF e os comprovantes como anexos do negócio. - Manter o valor do funil sempre coerente com o orçamento real do cliente. Dicas, limites e boas práticas - Prefira itens de linha para orçamentos: o valor fica sempre correto e auditável. - Como o item do catálogo é um snapshot, atualize preços no catálogo antes de montar novos orçamentos. - Use notas para o histórico interno e anexos para documentos — não misture os dois. - Mantenha o checklist enxuto e acionável; ele orienta o avanço pelas etapas. Solução de problemas - O valor não soma os itens: confira se há itens de linha; sem itens, o valor é manual. - Não consigo trocar a moeda: a moeda é única por negócio e definida pela primeira linha — remova as linhas para redefinir. - O preço veio diferente do catálogo: o item guarda o preço do momento em que foi adicionado (snapshot). - Não vejo itens de linha: verifique se o módulo de Catálogo está habilitado e tem produtos. - Não encontro uma nota antiga: abra Notas salvas e use Carregar mais notas até chegar ao registro desejado. - O Histórico está vazio após aplicar um filtro: selecione Limpar filtro; pode não haver eventos correspondentes entre as páginas já carregadas. - Uma nota não foi salva: mantenha o editor aberto e tente novamente. O rascunho permanece no negócio enquanto a página estiver aberta. Veja também - CRM: pipelines, kanban e negócios (deals) - Empresas (companies) e vínculo com contatos - Visão geral de Contatos e do CRM - Registro de pedidos (Orders Registry) no CRM

Tipo de contato: Visitante, Lead e Cliente

Visão geral Todo contato tem um tipo que representa o seu estágio no relacionamento: - Visitante — ainda sem identificação (sem e-mail, telefone ou perfil social). - Lead — já tem alguma forma de contato (e-mail, telefone ou canal externo como WhatsApp). - Cliente — foi promovido manualmente (ou por automação) por ter comprado/fechado. O tipo aparece como um selo colorido na lista de Contatos e no painel do contato dentro da conversa, onde você pode alterá-lo com um clique. Pré-requisitos - Nenhum. O tipo de contato é nativo e está sempre disponível. Passo a passo Ver o tipo 1. Abra Contatos. Cada contato mostra o selo do tipo ao lado do nome. 2. Dentro de uma conversa, abra o painel do contato à direita — o selo aparece ao lado do nome. Alterar o tipo (na conversa) 1. No painel do contato, clique no selo do tipo. 2. Escolha Visitante, Lead ou Cliente. A alteração é salva na hora. Filtrar / segmentar por tipo 1. Em Contatos, abra Filtrar. 2. Escolha o atributo Tipo de contato e o valor (Visitante / Lead / Cliente). 3. Salve como segmento para reutilizar. Configurações & opções - Promoção automática: um contato Visitante vira Lead automaticamente assim que ganha e-mail, telefone ou um identificador social (por exemplo, ao chegar por WhatsApp). O tipo Cliente nunca é definido automaticamente — só manualmente ou por automação. - Alterar por automação, macro ou FlowBuilder: use a ação Alterar tipo de contato (change_contact_type) — disponível em regras de automação, macros e no nó Ação de contato do FlowBuilder — para definir Visitante / Lead / Cliente automaticamente (ex.: virar Cliente quando um pagamento é confirmado). Casos de uso - Qualificação: um fluxo marca o contato como Cliente ao fechar uma venda. - Segmentação: crie um segmento de Clientes para uma campanha de pós-venda. - Higiene: filtre Visitantes antigos sem identificação para limpeza. Dicas, limites e boas práticas - O tipo nunca é rebaixado automaticamente — um Cliente não volta a Lead sozinho. - Os três tipos (Visitante, Lead, Cliente) são fixos; tipos personalizados não fazem parte desta versão. Solução de problemas - O contato voltou a Lead depois que salvei como Visitante? Se ele tem e-mail/telefone, a promoção automática o define como Lead ao salvar. Para mantê-lo em outro estágio, use Cliente. Veja também - Importação e segmentos de contatos - Atributos personalizados

Registro de pedidos (Orders Registry) no CRM

Visão geral O Registro de pedidos (Orders Registry) é um histórico de compras centrado no contato. Para cada contato (e, opcionalmente, para cada negócio) você registra os pedidos com título, valor, moeda, status e data, montando uma visão clara de tudo o que aquela pessoa já comprou. É importante entender o que ele é e o que não é: o registro de pedidos é um log, não um gateway de pagamento. Ele não cobra, não estorna e não concilia dinheiro — quem cuida da cobrança é o módulo de Pagamentos. Marcar um pedido como "reembolsado" ou "cancelado" aqui é apenas uma anotação no histórico, não uma operação financeira. Os pedidos podem chegar de várias origens: lançados manualmente, recebidos via webhook, criados pela API, originados do módulo de Pagamentos ou de integrações de comércio. Pré-requisitos - O Registro de pedidos é opcional e vem desativado por padrão. Peça a um administrador para habilitá-lo para a conta. - Permissão de gestão de CRM para criar e editar pedidos. - Contatos cadastrados — todo pedido pertence a um contato. Passo a passo 1. Confirme com um administrador que o Registro de pedidos está habilitado. 2. No menu lateral, abra Pedidos. A página reúne os pedidos que você pode consultar, inclusive os vinculados a contatos e negócios existentes. 3. Use a busca, período, origem, gateway, status e ordenação para chegar ao recorte desejado. Esses filtros ficam no endereço da página, então podem ser recarregados ou compartilhados. 4. Crie um pedido manual informando contato existente, título, valor, moeda e status. 5. Quando houver produtos, consulte os itens com nome, quantidade, preço unitário e desconto; eles preservam a fotografia financeira da venda. 6. Opcionalmente, informe a data do pedido e a data de pagamento, e vincule o pedido a um negócio. 7. Exporte o mesmo recorte em CSV ou selecione pedidos manuais para a ação em massa disponível. Pedidos de integrações são protegidos contra edição e exclusão na tela: a caixa de seleção fica desabilitada neles, e Selecionar todos os pedidos manuais destes filtros também alcança apenas os manuais. 8. Se um pedido integrado estiver com cliente ou vínculos incorretos, use Corrigir cliente e vínculos da venda. Escolha o contato, revise cobrança e recuperação relacionadas e aplique a prévia. Essa ação não edita o retrato financeiro do pedido e também funciona quando o registro integrado é imutável. Configurações & opções - Status do pedido: pendente, pago, parcialmente pago, em atraso, reembolsado, cancelado e falho. - Origem (source): manual, webhook, API, Pagamentos ou comércio — identifica de onde veio o registro. - Vínculos: todo pedido pertence a um contato e pode ser ligado a um negócio do CRM. - Moeda e valor: cada pedido tem seu valor e moeda próprios (padrão BRL). - Identificador externo: pedidos vindos de integrações trazem um ID externo que evita duplicação. - Itens do pedido: o nome e os valores de cada item são um retrato da venda. Alterações posteriores no Catálogo não reescrevem o que foi vendido; quando disponível, o item também mantém o vínculo ao produto ou à variação da mesma conta. - Carteira por responsável: quando a privacidade por responsável está ativa, cada vendedor vê apenas os pedidos dos contatos/negócios que pode acessar. - Lista global e CSV: a tela Pedidos é paginada no servidor; a exportação respeita os filtros e a seleção atual, sem incluir dados fora do seu escopo. - Editar × corrigir vínculos: somente pedidos manuais têm edição e exclusão comuns. A correção separada de contato, organização, negócio e conversa preserva valor, status, itens, datas e identidade externa. Casos de uso - Manter o histórico de compras de cada cliente direto no perfil do contato. - Acompanhar, no negócio, os pedidos já realizados naquela oportunidade. - Consolidar pedidos de várias origens (manual, Pagamentos, comércio) em um único log. - Alimentar automações e relatórios com base no que cada contato comprou. - Comparar, no relatório do Catálogo, o orçamento dos negócios com o valor efetivamente liquidado dos itens. Dicas, limites e boas práticas - Use o registro de pedidos para histórico; para cobrar de fato, use o módulo de Pagamentos. - Padronize títulos e status para facilitar a leitura e os filtros. - Ao integrar via webhook/API, envie um ID externo estável para não duplicar pedidos. - Para cada item integrado, envie também um identificador estável do item; assim, uma nova entrega do mesmo pedido não duplica as linhas. - Vincule o pedido ao negócio correspondente quando fizer sentido, para conectar venda e oportunidade. - Edite ou exclua somente registros manuais. Em um importado, use Corrigir cliente e vínculos apenas para associações; corrija valor, status, itens, datas ou ID externo na fonte e sincronize novamente. Solução de problemas - Não vejo a seção de Pedidos: o módulo pode estar desativado para a conta — fale com um administrador. - Pedido duplicado: confirme se a integração está enviando o mesmo ID externo em vez de criar um novo. - O pedido não cobrou o cliente: isso é esperado — o registro é um log; a cobrança é feita em Pagamentos. - O nome ou preço do catálogo mudou: o item registrado continua exibindo o retrato da venda original; isso é intencional para preservar o histórico financeiro. - Não consigo criar um pedido: verifique sua permissão de gestão de CRM e se o contato existe. - Não consigo editar um pedido importado: isso é intencional. Registros recebidos de Pagamentos, comércio, API ou webhook preservam os fatos financeiros contra reentregas. Se o problema for somente o cliente ou outro vínculo, use Corrigir cliente e vínculos da venda na linha do pedido. Veja também - CRM: pipelines, kanban e negócios (deals) - Negócios: notas, anexos, checklists, itens de linha e valor automático - Visão geral de Contatos e do CRM Remover pedidos de teste ou órfãos Na lista de Pedidos, administradores podem remover registros que vieram de cobranças ou integrações. Informe o tipo e o motivo da correção. O pedido sai imediatamente da visão Operacionais, mas a origem, o responsável, o motivo e eventuais compensações permanecem no histórico de auditoria. Pedidos manuais nunca pagos e sem cobrança vinculada podem ser excluídos de forma definitiva. Pedidos pagos ou vinculados a uma integração são anulados, não apagados: comissões abertas, estoque e pontuação de engajamento são compensados de forma atômica. Uma comissão já fechada bloqueia a operação para evitar divergência financeira. Use o filtro Situação do registro → Anulados para revisar o que foi removido. A restauração só é permitida quando a anulação não gerou compensações contábeis, de estoque ou engajamento e quando a identidade externa ainda está livre. Para excluir a própria cobrança, primeiro arquive-a. Somente uma cobrança não liquidada pode ser eliminada permanentemente; a exclusão exige um motivo e anula/desvincula o pedido relacionado antes de apagar a cobrança local. Nenhuma dessas ações cancela ou estorna valores no gateway.

Relatórios e análises do CRM (funil, SLA e previsão)

Visão geral Os Relatórios do CRM são o painel de análise da sua operação de vendas na Conversa Labs. Em uma única tela você acompanha conversão, valor em aberto e ganho, previsão ponderada, o funil por etapa, o cumprimento de SLA, a saúde e a prioridade dos negócios e o ranking de responsáveis — tudo filtrável por pipeline e por período. É uma superfície administrativa: o acesso é restrito a usuários com perfil de administrador. Você abre o painel pela barra lateral em CRM > Relatórios (rota crm_reports_index). Pré-requisitos - Perfil de administrador na conta. Agentes não têm acesso a esta tela. - O módulo de CRM (pipelines) habilitado para a conta. - Pelo menos um pipeline com negócios cadastrados, para que os painéis tenham dados para exibir. Passo a passo 1. Abra o CRM pela barra lateral e selecione Relatórios. 2. No filtro de pipeline, escolha Todos os pipelines (relatório por conta) ou um pipeline específico. 3. No filtro de período, escolha uma janela pronta (7, 30 ou 90 dias), Todo o período ou Personalizado para informar uma data inicial e final. 4. Leia cada painel de cima para baixo: KPIs de resumo, distribuições (SLA, saúde, prioridade), funil por etapa (quando há um pipeline selecionado) e principais responsáveis. 5. Para reaproveitar uma combinação de pipeline + período, salve uma visão (veja "Configurações & opções"). Configurações & opções Painéis e métricas - Resumo (KPIs) — visão geral da carteira: - Negócios abertos, e a contagem de ganhos / perdidos. - Taxa de conversão = ganhos ÷ (ganhos + perdidos). - Taxa de ganho = ganhos ÷ total de negócios do período. - Tempo médio de ciclo — média do tempo entre a data de abertura e o fechamento dos negócios encerrados (a data de abertura é editável no negócio; por padrão é a data de criação). - Valor em aberto, valor ganho e previsão ponderada, sempre agrupados por moeda. - Funil por etapa — por etapa do pipeline: contagem de negócios, valor em aberto e previsão por moeda e o SLA da etapa. Exige um pipeline específico selecionado. - SLA dos negócios abertos — distribui os negócios abertos em no prazo, vencendo (perto do limite), estourado (acima do SLA) e sem prazo (etapa sem SLA definido). - Distribuição por saúde — saudável, em risco e crítico. - Distribuição por prioridade — baixa, média, alta e urgente. - Principais responsáveis — ranking dos donos de negócios pelo número de negócios abertos e pelo valor em aberto por moeda. Previsão ponderada A previsão soma, para cada negócio aberto, o seu valor multiplicado pela probabilidade da etapa em que ele está. Etapas mais avançadas pesam mais na previsão; por isso, manter a probabilidade das etapas realista deixa a previsão mais confiável. Filtros e visões salvas - Pipeline: Todos os pipelines ou um pipeline específico. - Período: janelas de 7 / 30 / 90 dias, Todo o período ou Personalizado (data inicial/final). - Visões salvas: salve a combinação atual de pipeline + período como uma predefinição nomeada e aplique-a depois com um clique. As visões usam o mecanismo de filtros salvos (tipo de filtro de relatório). Multimoeda Os valores são agrupados por moeda, sem conversão automática. Se a carteira tem negócios em moedas diferentes (por exemplo, BRL e USD), cada moeda aparece com seu próprio total, lado a lado. Casos de uso - Acompanhar a conversão por etapa e identificar onde os negócios travam no funil. - Priorizar o esforço da equipe pela previsão ponderada e pelo valor em aberto. - Monitorar o SLA e a saúde da carteira para agir antes que negócios estourem o prazo ou virem risco. - Comparar o desempenho dos responsáveis por volume e por valor em aberto. Dicas, limites e boas práticas - O funil só aparece com um pipeline específico selecionado. Com Todos os pipelines, o relatório por conta omite o funil (as etapas pertencem a cada pipeline, então um funil consolidado não faria sentido). - O período filtra pela data de abertura do negócio (por padrão, a data de criação — corrigível no próprio negócio), não pela data de fechamento. Ajuste a janela conforme o que você quer medir. - Mantenha a probabilidade das etapas realista — ela alimenta diretamente a previsão ponderada. - O ranking de responsáveis mostra os principais donos por negócios abertos; donos sem negócios abertos no período não aparecem. Solução de problemas - O funil está vazio: selecione um pipeline específico no filtro — o relatório por conta não exibe funil. - Acesso negado / não vejo Relatórios: a tela é somente para administradores. Peça acesso a um administrador da conta. - Os valores aparecem em moedas diferentes: isso é esperado — não há conversão automática; cada moeda tem seu próprio total. - Os números parecem baixos: confira o período (ele filtra pela data de abertura) e o pipeline selecionados antes de comparar. Veja também - CRM: pipelines, kanban e negócios (deals) - Registro de pedidos (Orders Registry) no CRM - Visão geral de Contatos e do CRM