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

Conversa Labs

Conversa Labs

Última atualização em Aug 12, 2026

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