Pular para conteúdo

Fluxo de Aprovação — Mapa Completo

Status: ✅ Em produção (pasta Criação) · atualizado em 11/06/2026

O que é: a referência única de como uma peça caminha da produção até a publicação, e tudo o que a Gi faz automaticamente em cada etapa. Para quem: todo o time de Criação (produtores, revisora, account, publicador) + referência técnica no fim. Ferramentas: ClickUp · Canal #Revisões · #Gitamakers · #BackOffice · WhatsApp do cliente

Esta página é o mapa geral. Para o passo a passo de cada função, veja os guias: Como mandar pra revisão · Como revisar · Como aprovar com o cliente · Como publicar.

Visão geral

Toda peça de Criação (arte, vídeo, copy, planejamento, página) passa por revisão interna antes de ir pro cliente, e por aprovação do cliente antes de ser publicada. A Gi orquestra esse caminho: ela avisa a pessoa certa em cada transição de status, cobra quem está travando, e leva a peça pro grupo do cliente quando ela é aprovada. Você muda o status da task no ClickUp; a Gi cuida do resto.

O fluxo completo

flowchart TD
    P[em produção] -->|produtor termina| R[em revisão interna]

    R -->|revisor aprova<br/>clica Resolver| AC[em aprovação cliente]
    R -->|revisor pede ajuste<br/>responde na thread| ALT[em alteração & ajuste]

    ALT -->|produtor reenvia<br/>após ajustar| R

    AC -->|cliente aprova| AP[aprovado]
    AC -->|cliente pede ajuste| ALTC[em alteração cliente]

    ALTC -->|produtor refaz| R
    AP -->|publicado| PUB[publicado]

    style R fill:#f76808,color:#fff
    style ALT fill:#f5a623,color:#fff
    style AC fill:#0091ff,color:#fff
    style ALTC fill:#f5a623,color:#fff
    style AP fill:#30a46c,color:#fff
    style PUB fill:#1b1b1b,color:#fff

Os três caminhos possíveis depois que a peça entra em revisão:

  1. Aprovação direta — o revisor abre, gosta, clica Resolver na mensagem do #Revisões. A Gi move pra em aprovação cliente e manda no grupo do cliente.
  2. Ajuste interno — o revisor responde na thread do #Revisões com o que mudar. A Gi move pra em alteração & ajuste e avisa o produtor. Quando o ajuste fica pronto, o produtor reenvia pra revisão (em revisão interna); a Gi posta uma mensagem nova e o revisor resolve essa pra liberar pro cliente.
  3. Ajuste do cliente — o cliente pede mudança no grupo. O account move pra em alteração cliente; o produtor refaz e reenvia.

O que a Gi faz em cada etapa

Status O que dispara O que a Gi faz Quem é avisado Onde
em revisão interna Produtor muda o status Atribui o revisor (Yasmin, se vazio) + posta a peça pra revisão Revisora #Revisões
em alteração & ajuste Revisor responde na thread do #Revisões Move o status, copia o feedback na task e avisa o produtor Produtor comentário na task
em aprovação cliente Revisor clica Resolver (com a task em revisão interna) Move o status → dispara o envio pro cliente Cliente grupo WhatsApp
aprovado Cliente aprova (account muda o status) Avisa que a peça está liberada pra publicar Publicadora (Yasmin) #Revisões
publicado Publicador finaliza — (fim do ciclo) — —

O botão Resolver é a aprovação — mas só em revisão interna

No #Revisões, cada peça que a Gi posta tem um botão Resolver. Quando o revisor clica com a task em em revisão interna, isso é o "aprovado interno" — a Gi move a task pra em aprovação cliente sozinha, sem precisar mexer no status na mão.

Importante: o Resolver só aprova em em revisão interna. Se a peça está em em alteração & ajuste (ou outro status), dar check é apenas higiene do canal — a Gi ignora e não manda pro cliente. Uma peça ajustada é aprovada quando o produtor a reenvia pra revisão (gera uma mensagem nova) e o revisor resolve essa.

O caminho dos ajustes (em detalhe)

sequenceDiagram
    participant Pr as Produtor
    participant Gi as Gi
    participant Rev as Revisora
    participant Cli as Cliente

    Pr->>Gi: move pra "em revisão interna"
    Gi->>Rev: "uma peça nova está pronta para sua revisão" (#Revisões)
    Rev->>Gi: responde na thread "ajusta as fontes"
    Gi->>Pr: move pra "em alteração & ajuste" + "a peça voltou para você"
    Pr->>Pr: aplica o ajuste
    Pr->>Gi: reenvia pra "em revisão interna"
    Gi->>Rev: posta uma mensagem NOVA pra revisão
    Rev->>Gi: clica Resolver na mensagem nova
    Gi->>Cli: move pra "em aprovação cliente" + envia no grupo

Resolver fora de 'em revisão interna' não envia pro cliente

O Resolver só aprova quando a task está em em revisão interna. Em em alteração & ajuste (ou peça já publicada/aprovada), dar check é só higiene do canal — a Gi ignora e não manda pro cliente. Isso evita enviar peça não-ajustada por engano e protege o fluxo de pular etapas.

As mensagens da Gi (o que você vai ver)

São os textos reais que a Gi envia em cada ponto. Reconhecê-los ajuda a saber em que etapa a peça está.

1. Entrada na revisão — no #Revisões, endereçada à revisora, com botão Resolver:

@Yasmin, uma peça nova está pronta para sua revisão.
Reels Institucional — Débora Faria
Por: Hélio
Task: https://app.clickup.com/t/...
Mídia: https://drive.google.com/...

— Gi

2. Volta pra ajuste — comentário na própria task, pro produtor:

Hélio, a peça voltou para você — Yasmin deixou os comentários na task.
Quando estiver pronta, é só mover de volta para revisão.

— Gi

3. Envio pro cliente — no grupo WhatsApp. Na primeira interação do dia a Gi se apresenta:

Bom dia, Débora! Tudo bem?
Trouxe uma peça nova para a sua aprovação:

Reels Institucional
Mídia: https://drive.google.com/...

Qualquer ajuste, é só me chamar por aqui.
Um ótimo dia para você.

— Gi · gita.

Nas peças seguintes do mesmo dia, ela vai direto:

Débora, mais uma peça para a sua aprovação:

Card Promo
Mídia: https://drive.google.com/...

— Gi

4. Liberada pra publicar — no #Revisões, pra publicadora:

A Débora aprovou!
Yasmin, a peça está liberada para publicação.
Task: https://app.clickup.com/t/...

— Gi

Cobrança automática (follow-up)

A Gi acompanha o que trava e cobra com cuidado, 3x por dia (9h, 13h, 17h, seg–sex):

Situação Quando Quem a Gi chama
Peça parada em revisão interna há 48h a revisora ("está tudo bem? consegue olhar hoje?")
Mesma peça ainda parada há 72h escala pra Tay (mensagem privada na task)
Cliente não respondeu a aprovação há 24h a Larissa (CS) pra fazer follow-up

Peça em alteração não é cobrada

Quando a peça está em em alteração & ajuste, a Gi não cobra — esse status é o produtor trabalhando, não alguém travando. A cobrança só acontece em revisão (revisora) e em aprovação cliente (Larissa).

Exemplo da cobrança de revisão:

Yasmin, está tudo bem?
Esta peça está há 2 dias parada na sua revisão. Consegue olhar hoje?
Task: https://app.clickup.com/t/...

— Gi

Onde acompanhar

O que Onde
Notificações em tempo real Canal #Revisões
Resumo da manhã Briefing matinal da Gi no #Gitamakers (8h, seg–sex) — lista o que está mexendo por status
Quadro do dia sob demanda #BackOffice — comandos /dash (panorama), /gargalo (o que travou), /carga (carga por pessoa), ou @Gi <pergunta>
Dashboard live docs.grupogita.com.br/automations/OPERACIONAL-DASHBOARD

Anexo técnico

Detalhes para manutenção e escala (clique pra abrir)

Máquina de estados (pasta Criação, folder 901316977953)

em revisão interna → (em alteração & ajuste | em aprovação cliente) → (em alteração cliente) → aprovado → publicado

Automações e arquivos (todas em server/automations/ do apiclickup)

Nº Arquivo Gatilho Tipo
T1 revisao-interna.js status → em revisão interna webhook (Automation UI)
T2 em-alteracao.js status → em alteração & ajuste webhook (Automation UI)
— gi-alteracao-watcher.js revisor responde na thread da Gi cron 60s (polling)
— gi-resolved-watcher.js revisor clica Resolver cron 60s (polling)
T3 aprovacao-cliente.js status → em aprovação cliente webhook (Automation UI)
T4 aprovado.js status → aprovado webhook (Automation UI)
— gi-followup-revisao.js 9h/13h/17h seg–sex cron
— gi-briefing-matinal.js 8h seg–sex cron
— gi-backoffice-watcher.js /dash /gargalo /carga @Gi cron 60s
— pre-auditoria.js status → Revisão (gated) webhook (Gemini)

Canais ClickUp Chat

  • Revisões 8cgqa6x-12053 · #Gitamakers 8cgqa6x-12093 · #BackOffice 8cgqa6x-11973

Custom fields (IDs globais)

  • Cliente bd3e6204-d959-43e3-93e4-fea13351b86b (dropdown)
  • Revisor Interno d93860a2-1f0f-41b3-8dd9-d82fb5c39ca7 (users) — deve ter 1 pessoa; com várias, a Gi usa o default da lista
  • Link da Mídia b53f1b1a-4f47-41e3-92cc-238ba4e49c10 (url) — obrigatório pro T3

Revisor default por lista — Yasmin (44242244) nas 5: Design 901325235657, Vídeo 901325235661, Copy 901325235663, Planejamento 901325235658, Produção de Páginas 901325235651. CS de follow-up: Larissa (118037412). Publicadora T4: Yasmin.

Env flags (apiclickup): ENABLE_GI_RESOLVED_WATCHER, ENABLE_GI_ALTERACAO_WATCHER, ENABLE_GI_FOLLOWUP_REVISAO, ENABLE_GI_BRIEFING_MATINAL, ENABLE_GI_BACKOFFICE_WATCHER, ENABLE_PRE_AUDITORIA.

Pré-condição crítica: T1–T4 dependem de Automations configuradas na UI do ClickUp (status muda → chama o webhook correspondente). Os watchers (Resolver, reply na thread, follow-up, briefing) rodam por cron interno e não dependem da UI. A Gi conversacional em DM/menção no ClickUp roda pelo poller do engine gita-agents (repo separado).

Pendências para escalar (roadmap)

  • O fluxo está ativo só na pasta Criação. Tráfego e Lançamento ainda não têm as Automations habilitadas.
  • cliente-autofill (preenche campos da task a partir do cliente) está em implantação — depende da migration 006-grupos-cliente-meta.sql e da criação dos custom fields na UI.
  • Validar que a Automation em aprovação cliente → webhook está ativa nas 5 listas (pré-condição do envio ao cliente).

Ver também