Criando seu primeiro funil e definindo etapas
Antes de cadastrar oportunidades, é preciso desenhar o caminho que elas vão percorrer. No SiteUp, esse caminho é o funil, e cada parada é uma etapa. Este guia mostra como criar o funil do zero, configurar campos avançados e organizar etapas de forma que SLAs, automações e métricas funcionem corretamente.
Acessando o configurador de funis
No módulo Kanban, abra o Gerenciador de Funis pelo menu superior. Clique em Novo funil e preencha:
- Nome do funil (único por conta, ex.: "Comercial 2026").
- Descrição interna (opcional, ajuda quando há vários funis).
- Status ativo: funis inativos somem do seletor de quadro mas preservam histórico.
- Distribuição round-robin: opcional, atribui agentes pré-cadastrados ao item no momento da criação se ainda não houver responsável.
Os funis criados ficam ordenados por nome no seletor de quadro e o cache de listagem é invalidado automaticamente após salvar.
Estrutura de uma etapa
Etapas são gravadas em JSONB no campo stages do funil. Cada etapa tem chave própria e os seguintes parâmetros configuráveis:
| Campo | Para que serve |
|---|---|
name |
Nome visível no topo da coluna |
color |
Cor da faixa da coluna (paleta StageColorPicker) |
description |
Texto interno para o time |
sla |
Prazo em horas — se um item permanecer mais tempo que isso na etapa, é contado em sla_breached_total no dashboard |
checklist_templates |
Lista de itens de checklist (texto, prioridade, obrigatório) que são copiados automaticamente para o card ao entrar na etapa |
message_templates |
Mensagens reutilizáveis disponíveis para envio rápido nessa etapa |
scheduled_follow_up |
Sequência de mensagens agendadas (ver artigo de Follow-up) |
stage_automations |
Lista de regras "ao entrar nessa etapa, fazer X" |
stage_events (em funnel.settings) |
Mapeamento etapa → evento Meta CAPI |
google_ads_stage_events (em funnel.settings) |
Mapeamento etapa → ação de conversão Google Ads |
Os IDs das etapas são únicos por conta. Ao duplicar um funil ou criar com chaves já existentes, a plataforma sufixa automaticamente o ID com o timestamp para evitar colisão.
Estrutura sugerida
Para a maioria das PMEs, esta estrutura cobre 90% dos casos:
| Ordem | Etapa | Significado | SLA sugerido |
|---|---|---|---|
| 1 | Lead | Contato chegou, ainda não qualificado | 24 h |
| 2 | Qualificado | Orçamento, decisor e prazo confirmados | 72 h |
| 3 | Proposta enviada | Documento comercial entregue | 120 h |
| 4 | Negociação | Revisões, descontos, contrato | 168 h |
| 5 | Fechamento | Aguardando assinatura ou pagamento | 72 h |
| 6 | Ganho | Venda concluída | — |
| 7 | Perdido | Negócio caiu (com motivo, se exigido) | — |
Comece com 3 etapas e cresça depois — quanto menor o funil, mais fácil o time adotar.
Atributos personalizados do funil
Em Configurações do funil → Atributos personalizados, cadastre campos que precisam aparecer em todo card desse funil (ex.: porte da empresa, segmento, fonte). Cada atributo tem name, type e, no caso de listas, valores permitidos. Esses atributos ficam em global_custom_attributes e são exibidos automaticamente no formulário do card.
Status do item: open, won, lost
Cada card carrega um campo de status em item_details.status. Mover para uma etapa não muda o status sozinho — quem altera é a regra de automação set_item_status ou o agente. Status won e lost removem o card das contagens de pipeline aberto e alimentam o dashboard de conversão. A configuração Exigir motivo de perda força o preenchimento ao marcar lost.
Round-robin de atribuição
Se a opção round_robin_distribution está ativa nas configurações do funil e o item é criado sem agente, a plataforma sorteia um responsável da lista funnel.settings.agents. A atribuição é registrada como automática (sem assigned_by).
Boas práticas
- Nomeie etapas no infinitivo do estado, não da ação ("Proposta enviada", não "Enviar proposta").
- Evite mais de 7 colunas: o quadro fica difícil de ler.
- Defina SLA realista por etapa: ele alimenta os badges de SLA estourado no dashboard.
- Use checklist templates para padronizar o trabalho do time em cada etapa.
Próximos passos
Com o funil pronto, siga para Cards e oportunidades. Para configurar regras automáticas, leia Movendo cards e automações por etapa.