Nomenclatura e tags dos workflows n8n

Princípio: pesquisar como o time trabalha

O nome do workflow é a primeira camada de pesquisa. Ele deve conter literalmente
os termos que o time procura no dia a dia: GHL, LEADS, WHATSAPP,
1/3, ENTRADA ou PROCESSAMENTO.

As tags são a segunda camada. Elas permitem cruzar características que não
cabem bem no nome, como “todos os webhooks”, “tudo que usa Redis”, “tudo que
cria oportunidade”, “tudo que foi criado por uma pessoa” ou “tudo que é
mantido por uma pessoa”.

Por isso, o código numérico 100/200/300 deixa de fazer parte do nome visível.
As categorias numéricas do inventário anterior permanecem apenas como metadado
legado até a migração dos 494 workflows ser revisada.

Formato canônico do nome

ÍCONE [CONTEXTO] ETAPA/TOTAL | FUNÇÃO | Verbo + objeto

O emoji fica solto, sem colchetes. Somente o contexto usa [colchetes].

ETAPA/TOTAL é opcional. Exemplos:

⚪ [LEADS] | ENTRADA | Receber leads de cadastro do Meta Ads
🟠 [LEADS] | PROCESSAMENTO | Validar e distribuir leads de cadastro
🔴 [GHL] | PROCESSAMENTO | Qualificar lead automaticamente
🔵 [CLICKUP] | SINCRONIZAÇÃO | Atualizar painel do gestor
🟠 [UAZAPI] | UTILITÁRIO | Enviar mensagem

O que cada parte responde

DEV e PROD são instâncias separadas, portanto [DEV] e [PROD] não entram
no nome. Versão só aparece no final quando duas versões precisam coexistir
durante migração:

⚪ [LEADS] | ENTRADA | Receber leads do site | v2

Não usar final, novo, corrigido, cópia, datas ou IDs do n8n como
versão.

Contexto pesquisável

[CONTEXTO] não é uma classificação acadêmica: é a âncora mais útil para a
pesquisa humana. Valores usuais:

[LEADS] [WHATSAPP] [GHL] [KOMMO] [CRM] [CLICKUP]
[1NORT] [UAZAPI] [META ADS] [GOOGLE ADS] [ASAAS]
[ONBOARDING] [CONTRATOS] [RELATÓRIOS]

Usar apenas um contexto principal. Outras plataformas e dependências ficam em
tags Usa | .... Exemplo: um fluxo cujo assunto é a criação de oportunidades
no GHL usa [GHL]; o fato de também ler PostgreSQL e enviar WhatsApp aparece
nas tags.

O mesmo contexto deve ser grafado sempre da mesma forma. Não alternar GHL,
Go High Level e GoHighLevel no nome.

Ícone do gatilho primário

Entradas interativas usam tags específicas:

Gatilho | Formulário
Gatilho | Chat IA
Gatilho | MCP
Gatilho | Avaliação

Eventos de aplicativo também preservam sua origem:

Gatilho | ClickUp
Gatilho | Calendly

respondToWebhook é um nó de resposta, não um gatilho. Ele não determina
ícone nem cria a tag Gatilho | Webhook.

Nós auxiliares de governança com prefixo GOV | não participam da
classificação funcional do workflow. Enquanto o fallback por workflow estiver
em uso, o n8nTrigger de governança não altera o ícone, a função nem as tags de
gatilho do processo de negócio. A captura global deve substituí-lo assim que o
canário for aprovado.

Workflows com vários gatilhos

O nome recebe um único ícone; as tags registram todos os gatilhos de produção
que realmente fazem parte do contrato.

Escolha determinística:

1. ⚫ quando o contrato principal é tratar erros;
2. 🟠 quando o workflow é um componente chamado por outros workflows e não
   possui uma entrada externa independente;
3. entrada externa que possui o contrato: ⚪, 🔴, 🟣 ou 🟢;
4. 🔵 quando o agendamento é o início real da rotina;
5. 🟡 ou 🟤 somente quando manual/evento interno é de fato o contrato, e não
   um apoio para teste ou inicialização.

Se webhook e schedule iniciarem processos independentes no mesmo workflow, não
se escolhe uma cor arbitrariamente: o fluxo deve ser separado em duas entradas
que chamam um subfluxo comum.

Um workflow que publica no RabbitMQ, mas não consome a fila, não recebe 🔴. Ele
usa Usa | RabbitMQ e Ação | Publicar na fila. Um workflow em queue mode
também não recebe automaticamente Usa | Redis; essa tag só existe quando há
uso explícito do Redis na lógica do workflow.

Funções permitidas

Não criar sinônimos como RECEBIMENTO, INPUT ou HANDLER quando
ENTRADA já descreve a função.

Cadeias e frações 1/3

A fração é mantida no nome porque ela é útil para localizar rapidamente uma
etapa. Ela só pode ser usada quando:

• existe uma cadeia fixa e documentada;
• todas as etapas compartilham o mesmo identificador de cadeia;
• o contexto só muda entre etapas quando a responsabilidade realmente passa
  para outro domínio ou sistema;
• cada posição é única e o denominador é igual em todas as etapas;
• a chamada entre as etapas foi confirmada; sem ligação comprovada, a fração
  atual é apenas uma hipótese.

Exemplo didático do formato — ele não aprova nenhuma cadeia real do inventário:

⚪ [LEADS] 1/3 | ENTRADA | Receber cadastro
🟠 [LEADS] 2/3 | PROCESSAMENTO | Validar cadastro
🟠 [LEADS] 3/3 | SAÍDA | Distribuir lead

Tags comuns:

Cadeia | Leads cadastro
Etapa | 1 de 3
Etapa | 2 de 3
Etapa | 3 de 3

Cada workflow recebe somente a sua própria tag Etapa | .... Se o número de
etapas muda com frequência ou há ramificações, omitir a fração e representar o
grafo no manifesto.

Modelo de tags

As tags visíveis no n8n ficam em português natural, com acentos e nomes
familiares ao time. O padrão Categoria | Valor deixa cada filtro
autoexplicativo. Chaves técnicas em minúsculas, como gatilho:webhook, podem
existir no JSON e em scripts, mas não são o rótulo apresentado ao usuário.

Cada tag visível, contando categoria, separador, espaços e valor, deve ter no
máximo 24 caracteres, que é o limite aceito pelo n8n PROD. Ao criar ou
alterar o vocabulário controlado, validar o rótulo completo, não apenas o valor.

Obrigatórias em todo workflow governado

Obrigatórias adicionais antes de PROD

Criticidade | Baixa
Criticidade | Média
Criticidade | Alta
Criticidade | Crítica

Escopo | Interno
Escopo | Compartilhado
Escopo | Cliente

Criador | ... é histórico e não muda quando o workflow troca de
responsável. Responsável | ... representa quem mantém o fluxo hoje, pode
mudar e pode aparecer mais de uma vez quando a responsabilidade é realmente
compartilhada. Não usar e-mail; usar o nome curto controlado da equipe.

Uma pessoa não se torna responsável automaticamente só porque criou o
workflow. Da mesma forma, a troca de responsável nunca apaga o registro do
criador.

Em workflows antigos com várias tags de pessoas, não é seguro adivinhar quem
criou. Durante a migração:

Criador | A confirmar
Responsável | Pendente
Revisão | Criador
Revisão | Responsável

O placeholder de criador pode ser substituído uma única vez durante a
curadoria; depois da confirmação, a tag de criador fica imutável. Um workflow
com responsável não confirmado não está pronto para PROD. Novos workflows já
nascem com criador e pelo menos um responsável confirmados.

Tags de uso técnico

Aplicar uma tag para cada dependência usada diretamente pela lógica, inclusive
o sistema principal que também aparece em [CONTEXTO]:

Usa | Redis
Usa | PostgreSQL
Usa | RabbitMQ
Usa | ClickUp
Usa | WhatsApp
Usa | Uazapi
Usa | GHL
Usa | Kommo
Usa | Pipedrive
Usa | Meta Ads
Usa | Asaas

Não marcar todos os workflows com Usa | PostgreSQL ou Usa | Redis só
porque o n8n usa esses serviços como infraestrutura. A tag descreve nós e
contratos explícitos do workflow.

Tags de ação

As ações descrevem o resultado ou operação pesquisável:

Ação | Capturar lead
Ação | Validar lead
Ação | Distribuir lead
Ação | Buscar contato
Ação | Criar contato
Ação | Nova oportunidade
Ação | Qualificar lead
Ação | Recuperar lead
Ação | Enviar mensagem
Ação | Agrupar mensagens
Ação | Publicar na fila
Ação | Sincronizar dados
Ação | Criar usuário
Ação | Vincular cliente
Ação | Armazenar backup
Ação | Gerar relatório
Ação | Gerar contrato
Ação | Notificar erro

Evitar tags vagas como Ação | Processar, Ação | Executar ou
Ação | Geral.

Tags condicionais de governança

Cadeia | Nome curto
Etapa | 1 de 3
MCP | Aprovado
Revisão | Aposentar

Available in MCP é o controle técnico do n8n. MCP | Aprovado registra a
decisão de governança e exige manifesto, finalidade e allowlist.

Exemplos completos

Entrada de leads

⚪ [LEADS] | ENTRADA | Receber leads de cadastro do Meta Ads

Contexto | Leads
Função | Entrada
Gatilho | Webhook
Ação | Capturar lead
Usa | Meta Ads
Criador | Nome curto
Responsável | Nome curto
Status | Em revisão
Criticidade | Alta
Escopo | Compartilhado

Processamento no GHL consumindo fila

🔴 [GHL] | PROCESSAMENTO | Qualificar lead automaticamente

Contexto | GHL
Função | Processamento
Gatilho | RabbitMQ
Ação | Qualificar lead
Ação | Nova oportunidade
Usa | RabbitMQ
Usa | GHL
Criador | A confirmar
Responsável | Nome curto
Revisão | Criador
Status | Em revisão
Criticidade | Alta
Escopo | Compartilhado

Componente compartilhado

🟠 [UAZAPI] | UTILITÁRIO | Enviar mensagem

Contexto | Uazapi
Função | Utilitário
Gatilho | Subfluxo
Ação | Enviar mensagem
Usa | Uazapi
Usa | WhatsApp
Criador | A confirmar
Responsável | Nome curto
Revisão | Criador
Status | Em revisão
Criticidade | Alta
Escopo | Compartilhado

Como pesquisar

Aplicação segura no acervo atual

1. auditar os gatilhos e dependências reais;
2. resolver cadeias com denominadores ou ligações inconsistentes;
3. confirmar contexto, função e criador;
4. aplicar primeiro as tags;
5. validar a pesquisa do time e as dependências;
6. renomear um conjunto por vez;
7. atualizar manifesto e export sanitizado no GitHub;
8. somente depois revisar duplicados, arquivamento e descarte.

Nenhuma sugestão automática autoriza renomear, desativar, arquivar ou excluir.
Os nomes e tags atuais do n8n permanecem inalterados até uma etapa de aplicação
explicitamente aprovada.

O mapa público, com exemplos fictícios e sem identificadores internos, está em
Mapa público de normalização.
O mapa real e o contrato legível por máquina permanecem no repositório privado
1Nort-Digital/n8n-workflows.

Compatibilidade com a classificação anterior

O inventário já produzido contém sugestões categoria:110,
categoria:210 e semelhantes. Elas continuam preservadas para
rastreabilidade e para que os JSONs históricos permaneçam válidos, mas:

• não entram mais no nome visível;
• não substituem Contexto | ..., Função | ..., Gatilho | ... ou
  Ação | ...;
• permanecem com suggestion_status: unreviewed;
• serão regeneradas somente depois da aprovação desta nomenclatura.