Migração para o GHL

Resumo do processo de consolidação, normalização e auditoria das tags

99.802

contatos no GHL

fontes consolidadas

20.303

tags reaplicadas

959

duplicatas mergeadas

Índice

Contexto
Padrão de nomenclatura das tags
Como cada fonte virou tag no GHL
Auditoria e remediação
Bug conhecido
Webhooks ativos
Arquivos e relatórios

1. Contexto

Migramos contatos de 4 fontes principais para o GHL em 27/04/2026, mais reconciliação contra duas fontes complementares (Hotmart e Sympla) na auditoria pós-import.

Fonte	O que é	Volume bruto
Clint	CRM antigo de comercial	86.657
ActiveCampaign	E-mail marketing	66.067
Planilhas P1/P2/P3	Pesquisas históricas Google Sheets	~50.000 respostas
Hotmart Workshop	Vendas Workshop 100k Sem Caos (WP1→WP21)	1.730 transações
Hotmart Aplicação MU	Pagamento de entrada para Mentoria Ultra	854 transações
Sympla	Ingressos do Workshop	694 participantes
Tally + Typebot	Aplicações e pesquisas	12.487 respostas

Resultado: 99.802 contatos consolidados no GHL após dedupe (email → phone E.164 → CPF → instagram).

2. Padrão de nomenclatura das tags

Definimos um formato canônico no GHL, independente de como cada fonte nomeava:

Tipo	Formato GHL	Exemplo
Edição da Mentoria Ultra	`mu{N}` (sem zero à esquerda)	`mu13`, `mu18`
Edição do Workshop Presencial	`wp{N:02d}` (2 dígitos)	`wp08`, `wp19`, `wp20`
Origem do lead	`origem-{fonte}`	`origem-clint`, `origem-activecampaign`, `origem-hotmart`
Compra Workshop	`[wpN] compra aprovada`	`[wp21] compra aprovada`
Bumps Hotmart	`wpN bump amigo` / `wpN bump gravacao`	`wp22 bump amigo`
Aplicação MU	`pagou-aplicacao-mu` / `aplicacao-estornada`	—
Pesquisa respondida	`respondeu-pesquisa`	—

Regra-chave: uma pessoa que foi a 3 edições da MU (ex: 12, 13, 18) tem 3 tags no GHL — mu12, mu13, mu18. Nunca consolidamos histórico.

3. Como cada fonte virou tag no GHL

Clint

Tags brutas como MU18 - Lead, WP19 - Convite 02, MU13 - Confirmado → normalizadas para mu18, wp19, mu13.

ActiveCampaign

Tags brutas como [MU13] - Lead, [WP20] - Checkout, MU10-FBASE → normalizadas para mu13, wp20, mu10.

Hotmart Workshop

Cada Código de Oferta mapeado para a edição correta (cidade × lote × tipo):

69 códigos de oferta distintos cobrindo WP1 → WP21
Mapeamento mantido em webhooks/hotmart_ghl.py + dashboard dash-wp.ultralize.com.br
Bumps "Amigo" e "Gravação" tratados como tags separadas

Hotmart Aplicação MU (produto 3667801)

APPROVED/COMPLETE → pagou-aplicacao-mu
REFUNDED/CHARGEBACK → aplicacao-estornada

Planilhas P1/P2/P3

Coluna "Tag Lançamento" → extração via regex de MUx/WPx → normalização canônica.

Sympla

Tags por evento (16 eventos = 16 cidades de Workshop) → normalizadas para wp{N}.

4. Auditoria + Remediação

Em 09/05/2026 fizemos auditoria 100% (não amostra) comparando snapshot do GHL contra todas as fontes brutas.

Problema	Volume	Ação
Tags faltantes (existiam na fonte, sumiram no GHL)	20.303 tags em 15.435 contatos	Reaplicadas via API
Contatos duplicados (mesma pessoa, IDs diferentes)	959 grupos	Merge: master = mais completo, união de tags + CFs, deletados os outros
Tags extras sem evidência	99 tags	Removidas
Leads que nunca foram importados	554 (476 reimportados)	Upsert no GHL com tag `reimportado-fase-auditoria`
CustomFields ausentes	90.135 valores em ~17k contatos	Preenchidos sem sobrescrever existentes
Spam estrangeiro (DDIs Nigeria, Pakistan, etc.)	2.974	Deletados

Falhas em todas as etapas: ~2% — basicamente contatos que tinham sido deletados num merge anterior na mesma rodada.

5. Bug conhecido (a corrigir)

Regex ambígua: a função que normaliza tags MU usa mu\s*(\d+) — isso captura "MU24" dentro de IPMU24 (Imersão Presencial Mentoria Ultra 2024, evento real e diferente das edições da MU).

Sintoma: alguns contatos do Clint que tinham a tag IPMU24 ganharam a tag mu24 no GHL. Mas MU24 não existe — a edição mais recente é MU19.

Casos identificados: digitalrudder@gmail.com, fernando.solha@gmail.com. Provavelmente há mais — precisa varrer e remover mu24 em todos os contatos do Clint que tinham IPMU24 originalmente.

6. Webhooks ativos (manter as tags atualizadas)

A partir de 27/04/2026, qualquer nova ação de cliente cria/atualiza tag automaticamente:

Hotmart → GHL (webhooks/hotmart_ghl.py, systemd hotmart-ghl): toda nova compra/cancelamento de Workshop ou Aplicação MU.
Sympla → GHL: ingressos novos viram contato + tag wpN.
Wati (WhatsApp): leads que iniciam conversa entram com tag de origem.

Para configurar uma nova edição (WP24, WP25, etc.), usamos a skill /configurar-wp-ghl que automatiza:

1. Pega offers do dashboard
2. Edita OFFER_MAP em hotmart_ghl.py
3. Restart do serviço systemd
4. Backfill dos contatos pendentes
5. Valida no GHL

7. Arquivos e relatórios

Hub de fontes brutas (CSVs)

https://planilhas-ghl.ultralize.com.br

Todos os CSVs das 7 fontes (Clint, ActiveCampaign, Hotmart Workshop, Hotmart Aplicação MU, Tally, Typebot, Sympla) + as 3 planilhas Google originais.

Relatório consolidado da auditoria

Sumário executivo com semáforos por fase (cobertura, fidelidade, duplicatas, eventos, pesquisas, erros).

Abrir RELATORIO.md

Status master da migração

Documento vivo com tudo que foi feito, decisões tomadas, pendências.

Abrir STATUS_MIGRACAO_GHL.md

Documento gerado em 09/05/2026 · Ultralize