Pular para conteúdo

POP — Fluxo de Revisão Padronizado (humano)

⚠️ Status: v1 — em validação. Documentação criada antes da operação completa rodar. Vai evoluir conforme o time usar e sinalizar atrito. Itens marcados como "v1" são suposições a confirmar.

Área: Operação ponta-a-ponta (Conteúdo, Tráfego, Backoffice, Comercial) Responsáveis: Criador da task · Revisor Interno · Cliente Tempo estimado: Varia por peça (mínimo 30 min entre fases) Ferramentas: ClickUp · Canais ClickUp Chat · WhatsApp do cliente Slash command relacionado: —

Por que esse POP existe

Hoje só o projeto da Janaina tem fluxo de revisão fechado ponta-a-ponta. Os outros clientes operam no improviso. Esse POP padroniza:

  • Quem revisa cada peça (Revisor Interno designado por task)
  • Quais statuses representam cada fase (mesma nomenclatura nas listas operacionais)
  • Quando o cliente é notificado automaticamente (status em aprovação cliente → mensagem no grupo WhatsApp)
  • Em qual canal cada área recebe ping (Design e Audiovisual, Estratégia & Copy, Conteúdo, Tráfego e Infra, BackOffice)

Fluxo visual

flowchart LR
    A[para fazer] --> B[em produção / em andamento]
    B --> C[em revisão interna]
    C -->|aprovado<br/>internamente| E[em aprovação cliente]
    C -->|ajustes<br/>necessários| D[em alteração & ajuste]
    D --> B
    E -->|cliente aprova| G[aprovado / concluído]
    E -->|cliente pede<br/>ajuste| F[em alteração cliente]
    F --> B
    G --> H[publicado / agendado]

    style C fill:#f76808,color:#fff
    style E fill:#0091ff,color:#fff
    style G fill:#30a46c,color:#fff

Statuses padrão

Essas listas adotam (ou estão adotando) os 3 statuses-chave de revisão:

Lista ClickUp Tem fluxo padrão?
Design Design ✅
Vídeo Vídeo ✅
Copy Copy ⚠️ adicionar em alteração & ajuste
Planejamento e Estratégia Planejamento ✅
Gestão de Campanhas Campanhas ⚠️ adicionar os 3 statuses
Relatórios (Tráfego) Relatórios ⚠️ adicionar os 3 statuses

Statuses de revisão (preservar nomenclatura exata):

Status Cor Quando aplicar
em revisão interna 🟠 laranja Peça produzida, aguarda revisão do Revisor Interno designado
em alteração & ajuste 🟡 amarelo Há ajustes pendentes a fazer (loop interno antes de mandar ao cliente)
em aprovação cliente 🔵 azul Aprovada internamente, enviada ao cliente para validação final

Cada lista preserva seus statuses específicos (ex: em gravação, em edição, em veiculação). Os 3 acima são adicionais — não substituem nada.

Papéis e responsabilidades

Papel Quem O que faz
Criador da task Quem abre a peça (criativo, copy, campanha, etc.) Preenche brief + atribui Revisor Interno + move pra em produção
Produtor Designer / Videomaker / Copywriter / Gestor de Tráfego Executa a peça e move pra em revisão interna
Revisor Interno Definido por task no campo Revisor Interno (people) Revisa internamente e decide: aprovar (→ em aprovação cliente) ou devolver (→ em alteração & ajuste)
Ponte com cliente Account manager / Tati (Backoffice) Acompanha o status em aprovação cliente e responde no grupo WhatsApp do cliente
Publicador Social media / Gestor de Tráfego Quando status vira aprovado, executa publicação/veiculação

Notificações automáticas

1. Quando vai pra em revisão interna

  • ClickUp Automation (zero código, configurar na UI): atribui automaticamente o Revisor Interno à task + posta menção no canal Chat da área.
  • Canal por área:
  • Design e Vídeo → Design e Audiovisual
  • Copy / Planejamento → Estratégia & Copy
  • Social Media (Planejamento) → Conteúdo
  • Gestão de Campanhas / Relatórios Tráfego → Tráfego e Infra
  • Backoffice — qualquer task com Tati como Revisor Interno → BackOffice. Vale pra QUALQUER lista (RH/Vagas, Contas a Pagar/Receber, Gestão Contratual, Time GITA, Onboarding, Cultura, Recrutamento e Seleção, R [Administrativo/Direção/Financeiro], Gestão de Clientes, NPS, Entrada do novo cliente, R [Pós Venda], Relatórios de Entregas).
    • Regra por pessoa, não por lista — porque a Tati atua em múltiplas áreas
    • Trigger: Status = em revisão interna AND Revisor Interno = Tati
    • Action: Post to BackOffice + Notify Tati

2. Quando vai pra em alteração & ajuste

  • ClickUp Automation: notifica os assignees originais da task (quem produziu a peça) com o comentário do revisor.

3. Quando vai pra em aprovação cliente

  • Webhook automatizado: o servidor recebe o evento e envia mensagem WhatsApp formatada no grupo [CLIENTE] Atendimento SC com:
  • Nome da peça
  • Descrição curta
  • Link da mídia (campo Link da Mídia da task)
  • CTA leve pedindo aprovação
  • A task recebe automaticamente um comentário confirmando o envio.
  • Endpoint que processa: POST /webhook/clickup/aprovacao-cliente (servidor Easypanel apiclickup).

4. Quando vai pra aprovado

  • ClickUp Automation: posta no canal da área avisando que a peça está liberada pra publicação.

Checklist de revisão interna

Use isso como guia ao revisar peças visuais (Design / Vídeo):

  • Brand fit — Cores e tipografia seguem o brand guidelines do cliente
  • Legibilidade — Texto legível em tamanho real (story 9:16, feed 4:5, etc.)
  • Hierarquia visual — Olho do leitor vai pro CTA principal?
  • Adequação ao formato — Safe area respeitada, sem corte de elementos críticos
  • Erros técnicos — Resolução adequada, exportação correta, fontes embutidas
  • Coerência com brief — Peça responde ao objetivo da pauta original

Para peças de Copy:

  • Tom de voz do cliente (referência: data/brand/<cliente>/guidelines.md)
  • Persona alvo correta
  • Hook nos primeiros 5-10 caracteres
  • CTA específico e acionável
  • Sem erros de português / clareza
  • Comprimento adequado ao formato

Para peças de Tráfego (briefing/criativo de campanha):

  • Objetivo de campanha definido (tráfego, conversão, alcance, etc.)
  • Público segmentado documentado
  • Budget estimado
  • Métricas de sucesso esperadas
  • Criativos vinculados

Como começar a usar (passo a passo)

Para o criador da task

  1. Crie a task na lista certa (Design, Copy, Vídeo, etc.)
  2. Preencha:
  3. Empresa (dropdown — qual cliente)
  4. Revisor Interno (pessoa que vai revisar)
  5. Link da Mídia (após produção; pode ser pasta Drive do cliente)
  6. Brief no campo descrição
  7. Mova pra em produção quando começar; o produtor avança pelos statuses

Para o Revisor Interno

  1. Você é notificado no canal da área quando status muda pra em revisão interna
  2. Abre a task, olha a peça (Link da Mídia) e checa a checklist
  3. Se aprovado: muda pra em aprovação cliente (já dispara mensagem pro cliente)
  4. Se precisa ajuste: muda pra em alteração & ajuste + comentário com o que mudar

Para o cliente (passivo)

  • Não precisa fazer nada no ClickUp
  • Recebe mensagem no grupo [CLIENTE] Atendimento SC com a peça
  • Responde no grupo aprovando ou pedindo ajuste

Para a Ponte com cliente (account / Tati)

  • Acompanha o canal Chat correspondente
  • Quando cliente responde no grupo WhatsApp:
  • Se aprovado: muda task pra aprovado no ClickUp
  • Se ajustes: muda task pra em alteração cliente + comentário com o pedido do cliente
  • Se cliente demora >24h, faz follow-up

Configuração ClickUp (uma vez, pra cada lista)

⚠️ Pendência — esses passos ainda precisam ser feitos manualmente na UI do ClickUp porque a API REST não permite criar status novos nem regras de automation programaticamente. Tempo total: ~10 min.

Statuses faltantes (criar na UI)

Lista Status a criar Posição (antes de) Cor
Copy em alteração & ajuste deu certo 🟡 amarelo
Campanhas em revisão interna em veiculação 🟠 laranja
Campanhas em alteração & ajuste em veiculação 🟡 amarelo
Campanhas em aprovação cliente em veiculação 🔵 azul
Relatórios Tráfego em revisão interna em revisão 🟠 laranja
Relatórios Tráfego em alteração & ajuste finalizado 🟡 amarelo
Relatórios Tráfego em aprovação cliente finalizado 🔵 azul

ClickUp Automations (criar na UI, 4 regras por lista)

Em cada uma das 6 listas operacionais (Design, Vídeo, Copy, Planejamento, Campanhas, Relatórios Tráfego):

Regra 1 — Atribuir revisor + ping canal - Trigger: Status changes to em revisão interna - Action 1: Assign to Revisor Interno (custom field) - Action 2: Post to chat channel: <canal da área> (ver tabela acima)

Regra 2 — Notificar criador em alteração - Trigger: Status changes to em alteração & ajuste - Action: Notify task assignees

Regra 3 — Webhook pro cliente - Trigger: Status changes to em aprovação cliente - Action: Webhook POST https://gita-apiclickup.ewzc9p.easypanel.host/webhook/clickup/aprovacao-cliente

Regra 4 — Liberar publicação - Trigger: Status changes to aprovado (ou concluído, dependendo da lista) - Action: Post to chat channel: <canal da área>

Custom Field Revisor Interno ✅ já criado

Adicionado automaticamente em 22 listas (id global d93860a2-1f0f-41b3-8dd9-d82fb5c39ca7):

Marketing e Dados (6 listas): - Design, Vídeo, Copy, Planejamento e Estratégia, Gestão de Campanhas, Relatórios (Tráfego)

Gestão e Financeiro (11 listas): - RH / Vagas, Gestão Contratual, R [Financeiro], Contas a Receber, Contas a Pagar, R [Administrativo], Time GITA, Onboarding, Cultura e Rituais, Recrutamento e Seleção, R [Direção]

Comercial e Pós Venda — Sucesso do Cliente (5 listas): - Gestão de Clientes, NPS, Entrada do novo cliente, R [Pós Venda], Relatórios de Entregas

Pendente (precisa admin Jurídico adicionar via UI): - R [Jurídico] (API retornou 403 por restrição de permissão da lista)

Pendências e melhorias futuras

  • Configurar as 4 Automations × 6 listas = 24 regras na UI (uma vez)
  • Validar com 1 task de teste em Design end-to-end (criador → revisão interna → aprovação cliente → notificação WhatsApp)
  • Expandir pra Web (Produção de Páginas), Lançamentos, Onboarding em fase posterior
  • Camada IA opcional — Pré-Auditoria via Gemini (revisão automática de criativos visuais) já existe no código (server/automations/pre-auditoria.js) mas está desligada. Pode ser ativada como segunda camada quando o processo humano estiver redondo.

Atalhos do ClickUp

Ver também