← Voltar
Habitz
Manual M01 · Fase 2.1
Manuais de Uso · Abril 2026
Habitz · Forge Co
Fase 2.1 · Manuais de Uso · M01

ABERTURA DE SALA.
PARTE DIGITAL.

"Toda sala Habitz é uma célula autônoma dentro de uma rede com padrões comuns. Abrir uma sala é replicar o sistema — não improvisar um novo."

Uso interno · Habitz · Matriz e Salas Franqueadas

Manual Técnico · Habitz · Atualizado 2026-04-23 Facebook · Instagram · Business Manager · CRM · n8n
Parte 1 · Por que esse padrão existe

SEM PADRÃO,
A REDE QUEBRA.

Abrir sala sem padrão fragmenta tráfego, quebra o CRM multi-sala, impede rateio justo de comissão e trava a escalabilidade. Quatro decisões estruturais definem a replicabilidade da operação — e precisam estar todas feitas antes do primeiro lead entrar.

01 · Os Quatro Ganhos

QUATRO RAZÕES PRA
SEGUIR O PADRÃO.

Cada decisão de infraestrutura desse manual existe pra preservar um dos quatro ganhos abaixo. Pular passo aqui é abrir dívida técnica que vai cobrar juros na primeira escala.

01

Roteamento Automático de Leads

Lead vindo de anúncio Facebook/Instagram da sala cai direto no CRM da sala certa — sem triagem manual, sem leads perdidos no meio do caminho.

02

Faturamento Separado

Cada sala paga o próprio tráfego, direto no CNPJ dela. A matriz organiza a governança, não centraliza despesa de mídia.

03

Métricas por Sala

CPL, ROAS, conversão por canal — cada sala enxerga o próprio desempenho e a matriz compara maçãs com maçãs na hora de decidir investimento.

04

Escalabilidade da Rede

Não se cria um App Meta novo por sala. O App "Habitz CRM" é único e as Pages entram como recursos dele — abrir a 20ª sala é tão simples quanto abrir a 2ª.

Parte 2 · Pré-requisitos

O QUE PRECISA ESTAR
PRONTO ANTES.

Não comece a execução digital antes de ter tudo abaixo resolvido. Voltar no meio do passo 04 porque o CNPJ não está ativo custa dias — e trava a Ad Account em revisão da Meta.

02 · Checklist de Pré-requisitos

SETE PONTOS.
TODOS FEITOS.

O gestor da sala nova e o responsável pela matriz validam esse checklist juntos antes de abrir a primeira tela. Qualquer item pendente vira bloqueador explícito — não silencioso.

Pré-requisitos · Abertura de sala

Antes de começar a parte digital

  • CNPJ da sala aberto e operacional
  • Contrato de formação de sala com a matriz assinado
  • % de repasse pra matriz definido (padrão 5%)
  • Gestor da sala contratado (já tem acesso ao CRM)
  • Identidade visual da sala aprovada (logo adaptada · paleta seguindo brand book)
  • Acesso admin à Business Manager "Habitz Rede"
  • Cartão corporativo ou pix configurado pra faturamento Meta
Parte 3 · Passo a passo

NOVE PASSOS.
NA ORDEM.

A sequência importa. Cada passo prepara o terreno do seguinte — tentar criar Ad Account antes da Page, ou autorizar o App antes do BM, gera erros obscuros da Meta que custam horas pra diagnosticar. Siga na ordem.

03 · Execução Digital

DO ZERO AO
PRIMEIRO LEAD.

Do primeiro clique até o lead de teste caindo no Kanban, a execução completa leva entre 2 e 4 horas úteis — somada a até 24h de aprovação da Ad Account pela Meta na primeira sala.

01 Criar Page Facebook da sala

A Page é a identidade pública da sala no Facebook e o ponto de ancoragem pra todos os anúncios. Cada sala tem a própria Page — nunca reaproveita a da matriz.

Abrir facebook.com/pages/create logado na conta pessoal do gestor da sala.

  • Nome padrão: "Habitz [Cidade]" (ex: Habitz Porto Alegre)
  • Categoria: Imobiliária
  • Foto de perfil: logo adaptada pra cidade (ver brand_book.html · seção logo-bloco)
  • Foto de capa: aplicação visual aprovada pela matriz
  • Descrição: copy curta padrão (modelo no brand book)
Observação

Nunca use a Page da matriz pra veicular ads de outra sala — quebra o roteamento por page_id e mistura métricas que precisam ficar separadas pra rateio.

02 Adicionar Page ao Business Manager "Habitz Rede"

A Page é criada na conta pessoal do gestor, mas precisa ser ancorada no BM "Habitz Rede" — que é a camada de governança central da rede.

Acessar business.facebook.com → Contas → Páginas → Adicionar → Reivindicar Página.

  • Inserir URL da Page criada no Passo 01
  • Aguardar confirmação de vínculo (instantânea se o criador for admin do BM)
  • Atribuir admins: gestor da sala (admin total) + 2 admins da matriz (redundância)
  • Confirmar que a Page aparece em "Páginas" dentro do BM Habitz Rede
Observação

A Page fica ancorada no BM Habitz Rede. Isso dá controle central: se uma sala sair, a Page pode ser transferida — nunca criar um novo BM isolado por sala.

03 Criar Instagram comercial

O Instagram é o canal principal de conteúdo orgânico da sala. Precisa ser comercial e vinculado à Page — senão não dá pra veicular ads a partir dele.

App Instagram → Cadastrar → criar conta nova com email corporativo da sala.

  • Username padrão: @habitz_[cidade] (ex: @habitz_poa)
  • Configurações → Conta → Mudar pra conta profissional → Empresa
  • Vincular à Page Facebook criada no Passo 01
  • Bio padrão: "Habitz · [Cidade] · Curadoria de imóveis premium · [Link site]"
  • Foto de perfil idêntica à da Page Facebook (consistência visual)
04 Criar Ad Account no Business Manager

A Ad Account é onde as campanhas rodam e onde o cartão da sala é cobrado. Faturamento totalmente separado da matriz — governança central, dinheiro descentralizado.

BM Habitz Rede → Contas → Contas de Anúncios → Criar Nova → "Em nome da sua empresa".

  • Nome padrão: "Habitz [Cidade] · Ad Account"
  • Moeda: BRL · Fuso: America/Sao_Paulo
  • Vincular à Page da sala criada no Passo 01
  • Método de pagamento: cartão corporativo OU pix da sala (não da matriz)
  • Atribuir admins: gestor da sala (acesso total) + 1 admin da matriz (somente leitura pra auditoria)
Observação crítica

Cada sala paga o próprio tráfego. O BM Habitz Rede organiza, mas não centraliza faturamento — a Ad Account é da sala, fatura direto pro CNPJ dela. Misturar isso uma vez vira dor de cabeça contábil pra sempre.

05 Autorizar App "Habitz CRM" na Page

O App "Habitz CRM" é o que permite o CRM receber leads do Facebook automaticamente. Autorizar significa dar ao App permissão pra ler leads daquela Page específica.

BM Habitz Rede → Configurações Comerciais → Integrações → Apps → Habitz CRM → Adicionar.

  • Selecionar a Page da nova sala
  • Permitir scopes: leads_retrieval, pages_show_list, pages_read_engagement
  • Gerar Page Access Token — anotar em cofre (vai pro n8n no Passo 08)
  • Confirmar validade do token (padrão: 60 dias · renovar via System User Token pra forever)
Observação

O App Habitz CRM é único pra toda rede. Nunca crie um app por sala — isso quebra renovação de token, duplica manutenção e impede que a Meta trate a Habitz como uma entidade única na hora de aprovações.

06 Cadastrar sala no CRM

Com a infraestrutura Meta pronta, a sala é registrada no CRM — mas entra inativa. Só vira ativa depois de passar pelo gate operacional (documento fiscal + gestor + corretor).

Acessar crmforgeco.aforgeco.com/admin/salas/nova com perfil de admin da rede.

  • Código: 3 letras maiúsculas (ex: POA · FLN · RJO)
  • Nome fantasia · Cidade · UF · CNPJ · Razão social · PIX
  • % repasse matriz: 5 (ou o % contratado no contrato de formação)
  • Facebook Page ID: copiar do BM (campo "ID da Página" na seção de info)
  • Facebook Ad Account ID: copiar do BM (formato act_XXXXXXXXXX)
  • Salvar → a sala nasce com ativo=false
07 Montar elenco inicial

Sem pelo menos um gestor e um corretor autorizados, a sala não pode ser ativada. Esse é o gate que impede leads caírem em sala vazia.

Acessar /admin/salas/[CODIGO]/elenco (ex: /admin/salas/POA/elenco).

  • Adicionar 1 gestor — vincular usuário já cadastrado no CRM
  • Adicionar ao menos 1 corretor autorizado (perfil ativo + documento fiscal)
  • Voltar ao form da sala → confirmar que o botão "Ativar sala" ficou verde
  • Clicar Ativar → ativo=true · sala pronta pra receber leads
08 Atualizar mapa no n8n

O n8n é quem traduz page_id do Facebook pro código da sala do CRM. Sem esse mapa atualizado, o webhook recebe o lead e não sabe pra onde mandar.

Acessar workflow "Habitz Lead Router" no n8n (ambiente de produção).

  • Abrir node "Mapa Page → Sala" (node tipo Set ou Code)
  • Adicionar linha nova no objeto de mapeamento:
  • "<page_id_da_nova_sala>": "<codigo_da_sala>"
  • Salvar o workflow → Reativar
  • Executar teste manual com o page_id novo pra confirmar retorno do código correto
Observação

Se esquecer esse passo, o lead chega no webhook mas falha com "sala_not_found" — fica invisível pro corretor e não gera alerta automático. É o bug mais comum e o mais caro (lead perdido).

09 Teste end-to-end

Antes de liberar a primeira campanha real, forçar um lead de teste atravessar a stack inteira. Se qualquer passo da cadeia estiver quebrado, ele aparece aqui — não em produção.

  • Criar um lead de teste no formulário da Page nova (botão "Contatar" ou lead ad em modo preview)
  • Em até 10 segundos, conferir no Kanban da nova sala no CRM
  • Confirmar que foi atribuído a um corretor via roleta (coluna "Novos leads")
  • Confirmar que o campo "origem" está como "facebook_lead_ad"
  • Deletar o lead de teste (ou marcar como test=true pra não contaminar métricas)
Parte 4 · Checklist final

ANTES DO
GO-LIVE.

A última validação antes da primeira campanha real ir ao ar. Todos os itens precisam estar marcados — se algum ficou em aberto, a sala não entra em go-live.

04 · Go-Live Checklist

ONZE ITENS.
TODOS FECHADOS.

Esse checklist é revisado pela matriz + gestor da sala em reunião formal. Qualquer item em aberto adia o go-live — não existe "vamos resolver rodando".

Go-Live · Parte digital

Pronto pra primeira campanha real

  • Page publicada e com ao menos 5 posts de aquecimento
  • Instagram ativo, vinculado à Page
  • Ad Account aprovada pela Meta (pode demorar 24h na 1ª)
  • App Habitz CRM autorizado na Page da sala
  • Sala cadastrada e ATIVA no CRM
  • Elenco com ≥1 gestor e ≥1 corretor autorizados
  • n8n mapa atualizado e testado
  • Primeira campanha configurada (mas pausada)
  • Budget inicial aprovado pela matriz
  • Gestor da sala logou no CRM e viu a sala dele
  • Corretor da sala logou e vê o Kanban vazio
Parte 5 · Troubleshooting

QUANDO ALGO
QUEBRA.

Os quatro problemas mais comuns na primeira semana pós-go-live — com diagnóstico e solução direta. Se o problema não estiver aqui, escalar pra matriz em até 4h úteis.

05 · Problemas Comuns

QUATRO SINTOMAS.
QUATRO FIXES.

Cada problema abaixo tem diagnóstico rápido e fix direto. Antes de abrir chamado pra matriz, validar se é um dos quatro casos conhecidos.

Lead não cai no CRM
Confirmar 3 pontos em ordem: (1) secret do webhook bate com o configurado no n8n; (2) mapa n8n tem o page_id da sala; (3) Ad Account está aprovada pela Meta (1ª campanha pode levar 24h).
Page ID não aparece no CRM
Confirmar que copiou o ID numérico da Page (15-16 dígitos) e não o nome de usuário (@habitz-poa). O campo fica em "Sobre" → "ID da Página" no próprio Facebook.
Token expirou (60 dias)
Renovar Page Access Token via BM → Configurações → Integrações → Habitz CRM → Gerar novo token. Solução definitiva: configurar System User Token (forever) pra essa sala — matriz faz uma vez só.
Sala não ativa
O gate do CRM exige documento fiscal do CNPJ + 1 gestor + 1 corretor autorizado. Abrir /admin/salas/[CODIGO] e conferir qual dos três está pendente — o botão "Ativar" só fica verde com os 3 OK.
Parte 6 · Responsabilidades

QUEM FAZ
O QUÊ.

A abertura de sala é um trabalho a quatro mãos — matriz e sala nova. Abaixo, a divisão explícita pra ninguém assumir que "alguém vai fazer".

06 · Divisão do Trabalho

MATRIZ E
SALA NOVA.

A matriz é responsável pela governança central (BM, App, CRM admin, n8n). A sala nova é responsável pela identidade local (Page, IG, Ad Account, elenco). Nenhum dos dois lados pode delegar o próprio lado ao outro.

Lado Matriz

O que a matriz entrega

  • Acesso admin ao BM Habitz Rede
  • Template da logo adaptável pra cidade
  • Revisar e adicionar Page ao BM (Passo 02)
  • Autorizar App Habitz CRM (Passo 05)
  • Cadastrar sala no CRM admin (Passo 06)
  • Atualizar mapa no n8n (Passo 08)
  • Aprovar budget inicial · revisar go-live checklist
  • Estruturar System User Token quando aplicável
Lado Sala Nova

O que a sala entrega

  • CNPJ aberto · contrato assinado · PIX configurado
  • Criar Page Facebook (Passo 01)
  • Criar Instagram comercial (Passo 03)
  • Criar Ad Account com cartão próprio (Passo 04)
  • Cadastrar gestor e ao menos 1 corretor no elenco (Passo 07)
  • 5 posts de aquecimento na Page antes do go-live
  • Executar teste end-to-end (Passo 09)
  • Confirmar go-live checklist em reunião com matriz