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
- Com o módulo habilitado, abra Empresas no menu lateral.
- 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).
- Preencha as inscrições fiscais (estadual e municipal) quando a empresa emitir nota — os campos ficam logo abaixo do documento.
- 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.
- 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.
- 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.
- Na aba Contatos da empresa, vincule pessoas com papel e cargo; marque uma empresa como principal de cada contato.
- 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.
- Para grupos empresariais, defina a matriz no campo de hierarquia da filial — a árvore aparece na aba Hierarquia.
- 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_iddo 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 resolvecontact.*,crm_item.*,conversation.*,account.*ecompany.*(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.