CRM - Tarefas e Follow-ups

O que é

A página Tarefas concentra as atividades de acompanhamento do CRM: ligacoes a fazer, e-mails a enviar, reunioes agendadas e follow-ups que não podem ser esquecidos. Cada tarefa tem titulo, tipo, prioridade, data de vencimento, responsavel e pode estar vinculada a um cliente e/ou a uma oportunidade.

O vendedor costuma chegar aqui logo no início do dia para ver o que esta pendente, o que venceu e o que precisa ser feito hoje. Por padrão o controlador filtra automaticamente apenas tarefas com status pendente - para ver tarefas concluidas ou canceladas e necessário mudar o filtro de Status. O nome do modulo segue a configuração de termos escolhida em CRM > Configurações (pode aparecer como "Atividades" ou outro sinonimo da sua empresa).

Como usar

1. Va em Modulos > CRM > Tarefas no sidebar.
2. Use os cards do topo como atalhos:
   • Pendentes (azul) - total de tarefas em aberto.
   • Vencidas (vermelho) - passaram da data e ainda não foram concluidas.
   • Hoje (amarelo) - vencem hoje.
   • Esta Semana (verde) - vencem dentro da semana corrente.
3. Refine a lista na barra de filtros:
   • Buscar por titulo... - busca textual (ILIKE) no titulo da tarefa.
   • Status - Pendentes (padrão), Vencidas, Concluidas, Canceladas ou "Todos os status".
   • Tipo - Ligacao, Email, WhatsApp, Reuniao, Follow-up ou Outro.
   • Prioridade - Urgente, Alta, Media ou Baixa.
   • Responsavel - exibe so as tarefas atribuidas a um usuário.
4. Para cadastrar uma nova tarefa, clique em Nova Tarefa (botao flutuante laranja no canto superior direito). Preencha:
   • Titulo (obrigatório).
   • Tipo (obrigatório) - define o icone exibido na lista.
   • Prioridade (obrigatório) - controla a cor do badge e da bolinha no calendário.
   • Data de vencimento (obrigatório).
   • Responsavel (obrigatório) - usuário que vai executar.
   • Cliente e Oportunidade (opcionais) - vinculam a tarefa ao contexto de relacionamento.
   • Lembrar antes (minutos) - antecedencia do lembrete (padrão 30).
5. Para alternar entre lista e visao mensal, clique em Calendário (botao branco ao lado de Nova Tarefa).
6. Em cada tarefa pendente, use a barra de ações rapidas no rodape do card:
   • Visualizar abre os detalhes.
   • Editar abre o formulario completo.
   • Concluir marca como concluida (pede confirmação via modal).
   • Cancelar muda o status para cancelada (pede confirmação).

Casos especiais

Visao em calendário

O botao Calendário leva para /admin/crm/tarefas-calendario, onde as tarefas aparecem distribuidas pelos dias do mês. As cores dos eventos seguem a prioridade (urgente em vermelho, alta em laranja, media em amarelo, baixa em cinza), concluidas ficam verdes e vencidas em vermelho escuro.

Tarefa vinculada a oportunidade

Quando você informa Oportunidade no cadastro, a tarefa aparece com um link roxo apontando para a oportunidade no card da lista. So entram no select do formulario oportunidades em aberto (escopo abertas()).

Filtro de período (hoje / amanha / semana)

Os cards de atalho aplicam periodo=hoje, periodo=amanha ou periodo=semana. Esse filtro não aparece nas pilulas da barra superior, mas continua ativo via URL - para limpar, clique no card Pendentes ou no botao de limpar filtros da barra.

Reagendar

A ação reagendar aceita uma nova data de vencimento (futura) e esta disponível pela API do calendário e via formulario na tela de detalhes da tarefa. A lista não expoe esse botao diretamente - para reagendar a partir da listagem, use Editar e altere a Data de vencimento.

Estado vazio

Se nenhuma tarefa atende os filtros aparece o bloco "Nenhuma tarefa encontrada". Quando o usuário ainda não criou nenhuma, o texto e "Você não tem tarefas pendentes. Que tal criar uma?" com um atalho Nova Tarefa.

Erros comuns e como resolver

• "A data deve ser uma data posterior a now" (ao reagendar) - Causa: você informou uma data igual ou anterior a agora no campo Data de vencimento ao reagendar. Solucao: escolha uma data futura.
• "O campo titulo e obrigatório" / "O campo tipo e obrigatório" / "O campo data de vencimento e obrigatório" / "O campo responsavel e obrigatório" - Causa: o formulario foi enviado com um desses campos vazio. Solucao: preencha todos os campos marcados como obrigatorios antes de salvar.
• Tarefa não aparece após criar - Causa: a lista carrega so pendentes por padrão e a tarefa pode ter sido concluida na sequência ou estar atribuida a outro responsavel. Solucao: mude Status para "Todos os status" e remova o filtro de Responsavel.
• Botoes Concluir / Cancelar sumiram do card - Causa: a tarefa não esta mais com status pendente (ja foi concluida ou cancelada). Solucao: para reativar use Editar e ajuste o status ou crie uma nova tarefa.

Onde encontrar

• URL: /admin/crm/tarefas
• Caminho no menu: Modulos > CRM > Tarefas
• Permissão necessária: crm.tarefas (excluir exige excluir o CRM)
• Módulo necessário: CRM (slug crm)

Veja também

• CRM - Gestão de Relacionamento (visao geral)
• CRM - Listagem de Leads
• Oportunidades de Venda
• Interacoes com Clientes
• Pipelines e Kanban