Hub Retencao

Projetos e fluxos

Central visual dos projetos recorrentes: o que dispara, quais ferramentas entram, qual racional eu sigo no backend e qual output precisa sair.

← Voltar ao Hub

Fluxo selecionado

Virada do Club

Fechar a virada de ciclo dos creators usando o mes fechado validado pelos snapshots diarios, creators ativos do Partner Center, atualizacao controlada no Notion e reconciliacao de tags/grupos no Circle.

Mensal, dia 3 a 5 ou sob comandoJulho concluido com pendencias conhecidas

Dono

Agente 2 + Gabriel

Cron

0 6 3 * * · America/Sao_Paulo

Ultima run

07/08/2026

Resultado

Notion e Circle aplicados sem falha de escrita; 775 ativos sem pagina Notion e 255 ausentes no Circle seguem para saneamento

Acao manual

Rodar agora

Executa a virada manual de Agosto fechado pelo runner offline: Partner Center, Notion, Circle e report neste topico. O segundo clique confirma que a acao nao tem volta.

Fluxo completo

Deslize para ver →

>

Iniciar virada

cron dia 3 ou comando manual

ok

ok

Conferir captura

2.268 ativos informados

ok

{}

Casar handles

Partner Center x Notion

ok

?

Classificar vinculo

ativo, alerta ou revisao

ok

{}

Calcular mudancas

GMV x categoria; sem GMV = Start

ok

ok

Gerar pre-run

diffs, bloqueios e riscos

ok

out

Atualizar Notion

GMV, categoria e status

ok

?

Resolver duplicados

oficial x arquivado

ok

{}

Planejar Circle

access groups, tags e espacos

ok

out

Aplicar Circle

grupos/tags com OK

ok

out

Limpar espacos

space groups e space members

ok

?

Proteger aquisicao

categoria concedida

ok

!

Auditar ausentes

membro faltante ou outro e-mail

aviso

!

Enviar report final

sucessos, falhas e pendencias

aviso

Run selecionada

07/08/2026 · real

Fechamento operacional de julho saiu da etapa de Notion e avancou para Circle com aplicacao controlada. Foram tratados duplicados manuais, preservados internos Amplify, aplicada a regra de aquisicao protegida e rodada auditoria read-only dos membros esperados ausentes no Circle.

concluida com saneamento pendente
Notion final: 1.315 correcoes unicas, 489 operacoes de duplicados, 0 falhas e dry-run final com 0 correcoes automaticas restantes.
Duplicados manuais resolvidos com OK do Gabriel: @jaquelfsz_ e @casalsantoshop; 4 operacoes, 4 sucessos.
Circle spaces aplicado: Diamond teve 66 remocoes efetivas; Start/Silver/Gold/Safira tiveram 976 remocoes efetivas e 0 falhas.
Regra de aquisicao protegida aplicada para arianyoliveira_creator, viral.que.vende e dayinventando; Fonte do Creator = Aquisicao criada/preenchida no Notion.
Pendencia estrutural: 775 ativos do Partner sem pagina unica no Notion seguem para saneamento, sem update automatico.
Auditoria Circle: 255 e-mails esperados ausentes; 205 missing_member e 50 possible_other_email.
Para a proxima virada, repetir sempre pre-run fechado antes de qualquer escrita em Notion ou Circle.

Racional operacional

Operar em fases auditaveis: validar mes fechado, coletar Partner Center pagina a pagina, conferir contagem, cruzar GMV e vinculo, gerar dry-run, aplicar Notion somente com OK, resolver duplicados em trilha separada, planejar Circle, aplicar grupos/tags/espacos somente com OK e fechar com auditoria de ausentes. Ativo sem GMV entra como Start. Creator de aquisicao fica protegido na categoria concedida ate o mes seguinte a proxima virada.

Regras de seguranca

Validar o mes fechado pelos snapshots diarios antes de comparar: se faltar dia ou houver fonte incompleta, bloquear aplicacao.
Validar total de creators/paginas antes de comparar: se a captura do Partner Center parecer incompleta, bloquear aplicacao.
Reportar falha tecnica com etapa, timeout configurado, duracao real, pagina atingida, contagem parcial e proxima acao sugerida.
Partner Center e a fonte de verdade para vinculo ativo. Todo ativo precisa receber categoria.
Ativo sem GMV no mes de referencia entra como Start, nao fica fora da virada.
Normalizar handles antes do match: remover @, espacos, maiusculas/minusculas e variacoes simples.
Bloquear update automatico quando houver mais de uma pagina Notion para o mesmo handle.
Depois da aplicacao principal, rodar verificacao final de @ para inconclusivos: comparar Partner Center x Circle x Notion por handle normalizado, e-mail e WhatsApp; TikTok publico entra apenas como ultimo recurso e nao deve atualizar automaticamente sem evidencia forte.
Gravar status de verificacao de @ por creator: match_exato, circle_confirmado, match_suspeito, inconclusivo ou revisao_manual.
Usar creator_id/author_id do Partner como chave estavel sempre que existir; @ e dado mutavel e nao deve ser a unica chave definitiva.
Registrar sempre mes de referencia, data da virada e fonte/snapshot usado.
Separar dry-run de aplicacao: o Notion so recebe escrita quando a previa estiver limpa ou aprovada.
Notificacao fica fora ate Notion e Circle estarem corretos.
Preservar internos @amplifyugc.co em qualquer limpeza de Circle.
Access groups do Circle precisam ser validados por member_id e e-mail; endpoint de access group sozinho nao basta.
Criador esperado sem membro Circle nao deve virar falha de categoria: entra em saneamento de convite/e-mail.
Regra de aquisicao protegida precisa receber target_month na auditoria e aplicacao.

Regras de vinculo

VinculadoManter ativo. Atualizar GMV, categoria, mes/fonte da virada e status de vinculo.
Nao encontrado ou Nao vinculado no snapshot fechadoPode virar Desvinculado/Inativo no Notion, com observacao interna citando Partner Center e snapshot.
Desvinculacao solicitadaNao marcar como desvinculado automaticamente. Criar alerta para revisao humana e manter historico.
Prestes a expirarNao mudar categoria por isso. Gerar alerta de risco e acompanhar na run seguinte.
Handle duplicado, vazio ou conflitanteBloquear update automatico daquela pagina/creator e listar no report.

Historico de runs

Fontes e acessos

Outputs esperados

Creators ativos com GMV no periodo fechado

Creators ativos sem GMV no periodo fechado

Todos os creators ativos do Partner Center classificados: com GMV por faixa e sem GMV como Start

Creators inativos/desvinculados que precisam tag no Notion

Ultimo GMV registrado atualizado

Categoria da virada atualizada

Mes e fonte de referencia registrados

Data da ultima virada registrada

Status de vinculo TikTok Shop atualizado

Flags de revisao para duplicado, nao encontrado, ativo sem base, base sem vinculo, desvinculacao solicitada e perto de expirar

Snapshot/fonte da ultima virada registrado

Tag Circle antiga removida quando a categoria muda

Grupo de acesso antigo removido quando a categoria muda

Tag Circle da nova categoria aplicada

Grupo de acesso da nova categoria aplicado

Espacos e space groups antigos removidos quando a categoria muda

Fonte do Creator preenchida para aquisicoes protegidas

Auditoria read-only de membros esperados ausentes no Circle

Reconciliacao final de @ entre Partner Center, Notion e Circle

Resumo de run com sucessos, falhas e pendencias

Ferramentas

OpenClaworquestracao, leitura de memoria e execucao assistida
n8nworkflow visual/operacional da virada
TikTok Shop Partner Centerfonte de verdade para status de vinculoDrive / databasefallback e auditoria quando os snapshots diarios nao fecharem
Notionoutput operacional: status, categoria, ultimo GMV e auditoria
Circlegrupos de acesso da comunidade
Hub Retencaovisualizacao e auditoria do projeto

Riscos e bloqueios

Se os snapshots diarios ainda nao fecharem o mes, o fluxo deve parar antes do Notion
Partner Center pode exigir captura paginada e validacao de contagem
Coleta do Partner Center pode passar de 45s em paginas altas; timeout local foi aumentado para 180s e precisa ficar monitorado no report
Sem lista oficial completa de ativos/vinculados, o diff final de Notion + Circle fica bloqueado
Handles diferentes entre Partner Center, database e Notion podem gerar falso positivo
Comparar bases sujas por @ pode esconder troca de username; casos inconclusivos precisam reconciliacao posterior com Circle e, em ultimo caso, busca publica assistida
Duplicados no Notion precisam bloquear aplicacao automatica
Desvinculacao solicitada e prestes a expirar precisam regra propria
n8n task runner ja apresentou instabilidade
Envios externos seguem bloqueados sem autorizacao
255 membros esperados ficaram ausentes no Circle na auditoria de 07/08/2026: 205 sem membro e 50 com possivel outro e-mail
775 ativos do Partner sem pagina unica no Notion seguem fora do update automatico ate reconciliacao