Tarefas obrigatórias são ações que precisam ser executadas quando um lead entra numa etapa do funil. Quando o lead chega na etapa, o Syncro automaticamente cria essas tarefas vinculadas ao lead, com data de vencimento calculada (ex: 1 dia depois) e atribuídas ao responsável do lead.
Mais importante: enquanto há tarefas pendentes, o lead não pode sair da etapa — o sistema bloqueia a tentativa de mover no kanban. Isso força disciplina: ninguém pula etapas no afobamento, todo lead recebe o atendimento mínimo definido pelo gestor.
Pra que servem
Casos de uso comuns:
Etapa "Qualificação": tarefa "Ligar pra qualificar interesse e orçamento" (vence no mesmo dia).
Etapa "Proposta": tarefa "Enviar proposta personalizada" (vence em 1 dia).
Etapa "Negociação": tarefa "Follow-up de negociação" (vence em 3 dias).
Etapa "Onboarding": tarefas "Enviar boas-vindas" + "Marcar reunião de kickoff".
Sem tarefas obrigatórias, vendedores podem pular do Novo Lead direto pra Proposta sem qualificar. Com tarefas obrigatórias, o processo é forçado.
Pré-requisitos
Permissão de admin do tenant.
Pelo menos 1 pipeline criado.
Configurar tarefas obrigatórias
Acesse Configurações → Pipelines.
Clique no pipeline desejado.
Clique em Editar funil.
No drawer, localize a etapa onde você quer configurar tarefas.
Clique em Tarefas obrigatórias (botão prominente na etapa).
Abre o sub-modal Atividades obrigatórias.

Adicionar uma tarefa obrigatória
No modal, clique em Adicionar atividade. Aparece formulário com:
Assunto (obrigatório): descrição curta. Ex: "Ligar para qualificar interesse". Use o placeholder "Ex: Ligar para o lead".
Descrição (opcional): detalhes longos. Pode usar
{{lead_name}}e{{stage_name}}como placeholders dinâmicos.Tipo de tarefa: escolha entre 6 tipos:
Ligar (
call)Email (
email)Tarefa (
task)Visita (
visit)WhatsApp (
whatsapp)Reunião (
meeting)Prioridade: Baixa / Média (default) / Alta.
Dias após entrar na etapa (
due_date_offset): quanto tempo a tarefa tem pra ser executada.0= mesmo dia,1= amanhã,3= 3 dias depois.
Clique em Adicionar pra incluir.
Adicionar múltiplas tarefas
Repita o processo pra cada tarefa. Você pode ter várias tarefas obrigatórias por etapa:
Etapa: Qualificação | Vencimento |
|---|---|
Ligar pra qualificar | Hoje (0 dias) |
Enviar email com material | Hoje (0 dias) |
Follow-up se não responder | 2 dias |
Reordene arrastando (drag-handle) ou edite cada uma clicando.
Como funciona quando o lead entra na etapa
Toda vez que um lead entra na etapa (criado, movido manualmente, movido por automação):
O Syncro verifica as tarefas obrigatórias.
Pra cada tarefa obrigatória configurada:
Cria uma
Taskno banco com:subjectinterpolado (placeholders substituídos)due_date = hoje + due_date_offset diasassigned_to= responsável do leadlead_idvinculando à oportunidadestage_requirement_id= referência à definição
Registra evento "Atividade obrigatória criada" na timeline do lead.
As tarefas aparecem em Tarefas → Pendentes + na timeline do lead.
Bloqueio ao tentar sair de etapa
Quando alguém tenta arrastar o lead pra outra etapa no kanban (ou mover via API/automação):
O sistema verifica
canLeaveStage:
Lista todas as tarefas obrigatórias dessa etapa pra esse lead.
Conta quantas estão com status
completed(concluídas).Se há tarefas pendentes (não concluídas):
Bloqueia o movimento.
Retorna mensagem de erro com lista: "Tarefas pendentes: Ligar pra qualificar, Enviar email.".
O card volta pra etapa original.
Se todas concluídas, movimento autorizado.
Como concluir tarefas obrigatórias
As tarefas geradas funcionam igual a tarefas normais (veja Concluir tarefa). Você pode:
Marcar checkbox na lista de tarefas
Concluir pelo modal
Arrastar pra coluna Concluídas no kanban de tarefas
Após concluir, o bloqueio de movimento é liberado.
Editar tarefa obrigatória
No drawer de edição da etapa, abra o sub-modal Tarefas obrigatórias.
Localize a tarefa.
Clique em Editar.
Ajuste os campos.
Salve.
⚠️ Atenção: editar uma tarefa obrigatória não atualiza tarefas já criadas pra leads que entraram antes. As mudanças valem pra futuras entradas na etapa.
Excluir tarefa obrigatória
No sub-modal, clique no ícone de lixeira ao lado.
Confirme.
A definição é removida.
⚠️ Atenção: excluir definição não exclui tarefas já criadas em leads. Elas continuam ativas e devem ser concluídas ou canceladas manualmente.
Pular tarefa obrigatória (override)
Em casos especiais (cliente urgente, exceção de processo), você pode querer mover o lead mesmo com tarefa pendente. As opções:
Cancelar a tarefa em vez de concluir (status
cancelled):
Edite a tarefa, mude status pra Cancelada.
Cancelada não conta como pendente — bloqueio é liberado.
Concluir mesmo sem fazer:
Marca como concluída sem realmente executar (não recomendado, distorce métricas).
💡 Dica: se você precisa pular tarefa frequentemente, talvez ela não deveria ser obrigatória. Reavalie se o processo realmente exige.
Use placeholders dinâmicos
No campo Assunto e Descrição das tarefas obrigatórias, você pode usar:
{{lead_name}}— substituído pelo nome do lead{{stage_name}}— nome da etapa atual
Exemplos:
"Ligar pra {{lead_name}} sobre proposta" → vira "Ligar pra Maria Silva sobre proposta".
"Mover {{lead_name}} pra próxima etapa após validação" → personalizado.
Tarefas obrigatórias em automações
A criação de tarefa obrigatória dispara automações com gatilho task_created. Você pode reagir:
"Quando tarefa obrigatória do tipo
whatsappé criada, manda mensagem template""Quando tarefa de Visita é criada, agenda evento na agenda"
Veja Automações.
Boas práticas
Comece com 1-2 tarefas obrigatórias por etapa (não exagere). Pra processos complexos, escale gradualmente.
Use prazos realistas —
due_date_offset=0(hoje) só pra tarefas que realmente precisam ser feitas no dia.Diferencie por prioridade — Alta pra críticas, Baixa pra sugeridas.
Use tipos certos — Ligar/Email/Visita/WhatsApp/Reunião ajudam a equipe a entender o que fazer só de bater o olho.
Revise mensalmente — tarefas que ninguém faz indicam processo mal calibrado.
Próximos passos
Pra entender etapas de Ganho/Perdido (que também têm comportamento especial), veja Etapas Ganho e Perdido.
Pra mover leads no kanban, veja Mover negócios.