Skip to main content
Etiquetas e status do funil são as duas formas de marcar um projeto dentro de um funil. As duas pertencem ao funil, e não à conta, e são criadas na tela de edição do funil.

Etiqueta

Um projeto pode ter várias ao mesmo tempo. Serve para caracterizar: “urgente”, “cliente enterprise”, “aguardando terceiro”.

Status do funil

Um projeto tem um só por funil. Serve para dizer em que situação ele está: “em negociação”, “ganho”, “perdido”.

Etiquetas

Cada etiqueta tem um nome e uma cor. Você as cria na seção Etiquetas do funil, com o botão Adicionar etiqueta. As etiquetas aparecem no cartão do kanban (se a configuração do cartão as exibir), servem de critério em restrições, filtros e automações, e podem bloquear etapas.
Cores só ajudam quando são poucas e consistentes. Reserve o vermelho para o que realmente exige atenção; se tudo é vermelho, nada é.

Bloquear etapas a partir de uma etiqueta

Ao configurar uma etiqueta, você pode marcar em quais etapas ela bloqueia o vínculo. Um projeto com a etiqueta “Bloqueado pelo cliente” pode ser impedido de estar em “Em produção”, por exemplo. O bloqueio vale nos dois sentidos: o projeto etiquetado não entra na etapa, e o projeto que já está na etapa não recebe a etiqueta. Veja Restrições e bloqueios.

Aplicar etiquetas pela API

Pela API, a etiqueta de um projeto é sempre identificada pelo ID numérico da etiqueta do funil. Esses IDs vêm na lista tags de POST /api/management/get-project-funnels, com o project_funnel_id no corpo. Há dois caminhos:
  • Em PUT /api/management/projects/{project}, envie tags com as listas to_add e to_rem. As duas são obrigatórias e podem vir vazias: {"tags": {"to_add": [12], "to_rem": []}}.
  • Em POST /api/management/toggle-funnel-tag, envie project_id e funnel_tag_id. A chamada alterna: aplica a etiqueta se o projeto não a tem e remove se já tem.
A etiqueta precisa ser de um funil ao qual o projeto está vinculado. Se não for, a chamada responde HTTP 404. Se um bloqueio de etapa impedir a etiqueta, a resposta traz message: "blocked_by_existing_step_blocking".

Status do funil

O status do funil responde “como está esse projeto neste processo”. Você o cria na seção Status do funil, com nome, cor e a opção Conclusivo. O status do funil é diferente do status do projeto, que é um campo global do projeto. Um projeto pode estar em três funis e ter um status do funil diferente em cada um, porque esse status pertence ao vínculo entre o projeto e aquele funil. Ao trocar o status, a plataforma registra quando a troca aconteceu e quem a fez. Essa data fica disponível como critério de filtro e de ordenação automática das etapas.

Status conclusivo

Marcar um status como Conclusivo indica que, ao recebê-lo, o projeto chegou ao fim daquele processo. O efeito prático é sobre a previsão.

Ao aplicar um status conclusivo

A previsão passa a ser considerada realizada, com a data do momento em que o status foi aplicado.

Ao sair de um status conclusivo

A previsão realizada é desfeita e o projeto volta a ser tratado como em andamento.
Em um funil de vendas, “Ganho” e “Perdido” são ambos conclusivos: os dois encerram o processo, ainda que com resultados opostos. “Em negociação” não é.

Data de previsão

Cada vínculo entre projeto e funil tem sua própria data de previsão — quando se espera que aquele processo termine para aquele item.
A data é definida no cartão ou nos detalhes do projeto. Como pertence ao vínculo com o funil, um projeto em dois funis pode ter duas previsões diferentes.
Preenchida automaticamente quando o projeto recebe um status conclusivo. É o que permite comparar o que foi prometido com o que aconteceu.
A plataforma conta quantas vezes a data de previsão foi alterada e exibe isso junto à data.Um número alto é um sinal de processo: aquele item vem sendo reprogramado seguidamente, o que costuma indicar um impedimento que ninguém registrou.
A data de previsão também funciona como gatilho de automação: você pode disparar ações quando ela é atingida. Veja Gatilhos.

Onde etiquetas e status são usados

A tabela compara onde cada marca pode ser usada.

Ao clonar ou desvincular

Veja o que acontece com as etiquetas e os status nestas duas operações.
  • Clonar o funil copia todas as etiquetas, todos os status e os bloqueios de etapa configurados neles.
  • Desvincular o projeto do funil desfaz as etiquetas daquele funil, junto com os checklists e formulários. O histórico permanece.

Próximos passos

Restrições e bloqueios

Como etiquetas e status viram regras de movimentação.

Configuração do quadro

Escolher se etiquetas, status e previsão aparecem no cartão.