Skip to main content
As Tarefas são a ponte entre IA e time humano. Quando o agente identifica algo que precisa de mão humana — uma pendência, uma confirmação, uma conferência — ele cria uma tarefa direto para o responsável daquele cliente, com prazo, descrição e contexto. Saímos do mundo “IA conversa, humano descobre depois”: agora a IA despacha trabalho para a fila do humano exatamente como um SDR despacha para um vendedor.
Acesse em CRM > Tarefas. Cada tarefa também aparece embutida na ficha do cliente vinculado.

​
Tarefa vs. Atividade vs. Agendamento

Confusão comum — a distinção é importante:
TarefaAtividadeAgendamento (Calendar)
O que éTrabalho humano a fazerEvento que já aconteceuCompromisso no Google Calendar
ExecutorPessoa do timeHistórico (ninguém executa)Cliente / colaborador
Estadoaberta / concluída / canceladaImutávelCalendar sync
Onde aparece/tasks + ficha do clienteTimeline do clienteGoogle Calendar + ferramenta Agendamento do agente
Regra simples: tarefa = humano. Agendamento = compromisso no Calendar. Retorno = a IA volta a falar (veja Retornos).

​
Anatomia de uma tarefa

CampoTipoObrigatórioNotas
Títulotexto (até 255)✓Renderizável (com {{variavel}}) quando criada por automação
Descriçãotexto (até 2000)Idem
Responsávelpessoa do time✓Resolução automática em fallback (veja abaixo)
ClientevínculoHabilita visibilidade na ficha + timeline
Prazodata/horaOpcional; aparece como “Vence em…”
Statusaberta / concluída / cancelada✓Pode ir e voltar livremente
Status flui em qualquer direção: aberta ⇄ concluída / cancelada. Reabrir uma tarefa concluída limpa a data de conclusão.

​
Quatro formas de criar uma tarefa

Manualmente

Botão Nova tarefa em /tasks ou na ficha do cliente. Você escolhe título, descrição, responsável, cliente e prazo.

Pelo agente de voz

Durante uma chamada, o agente usa a tool create_task (CRM Action) quando identifica uma pendência humana.

Pelo agente WhatsApp

Mesma tool create_task — funciona em chats por texto também.

Por automação

Bloco Criar tarefa dentro de uma automação. Renderiza variáveis do cliente nos campos.

​
Exemplo: agente cria tarefa durante a conversa

Cliente (na call): “Preciso ver com meu chefe e te retorno na sexta.” Agente chama create_task(title="Confirmar interesse com chefe — {{cliente_nome}}", due_in_seconds=259200). Resultado: aparece na fila do responsável do cliente, com prazo de 3 dias, vinculada ao cliente, registrada na timeline.

​
Exemplo: bloco em automação

Numa régua de cobrança, quando o agente detecta promessa de pagamento: 
... → Condicional (disposition == "promessa_pagamento")
      └─ true → Criar tarefa
                  título: "Confirmar pagamento amanhã - {{cliente_nome}}"
                  descrição: "Cliente prometeu pagar via {{custom.forma_pagamento}}"
                  prazo: 24h

​
Resolução do responsável (fallback automático)

Em todas as origens, o sistema tenta na ordem:
1

Responsável informado explicitamente

Se o usuário/agente/automação especificou um responsável, usa esse.
2

Responsável padrão da tool

Se a tool create_task foi configurada com responsável padrão, usa esse (criação por agente).
3

Responsável do cliente

Usa o campo assigned_to do cliente (configurado na ficha).
4

Falha ou skip

Se nada resolve:
  • Por agente → erro retornado para o agente.
  • Por automação → step marca skipped (run continua o fluxo).
O comportamento de skip em vez de falhar no automation é proposital: workflow não pode parar porque uma delegação não tem dono. A run loga e segue.

​
A página /tasks

Kanban com 3 colunas:
ColunaO que mostra
AbertasTarefas pendentes (com badge de prazo se vencendo/atrasada)
ConcluídasTarefas finalizadas — com data de conclusão
CanceladasTarefas explicitamente canceladas
Ações disponíveis:
  • Drag-and-drop entre colunas para mudar status.
  • Filtros: busca textual (título/descrição/cliente), responsável, cliente.
  • Editar inline: título, descrição, responsável, prazo.

​
Embed na ficha do cliente

Toda ficha de cliente (/clients/[id]) tem uma seção Tarefas que mostra as últimas 50 tarefas vinculadas:
  • Ordenação: abertas primeiro, depois por prazo.
  • Ações inline: marcar concluída, cancelar, reabrir, editar prazo.
  • Sincronizado com /tasks: mudanças refletem nas duas telas em tempo real.
  • Botão “Nova tarefa”: cria já vinculada ao cliente atual.
Eventos de criação e conclusão também aparecem na timeline e no calendário do cliente como atividades task_created / task_completed.

​
Permissões

AçãoQuem pode
Criar tarefa com clienteQuem tem permissão para ver o cliente
Criar tarefa sem clienteAuto-atribuição apenas (a menos que admin)
Atualizar/fechar/cancelar/reabrirAdmin OR responsável OR criador
Reatribuir tarefa sem clienteApenas para si mesmo (a menos que admin)
Reatribuir tarefa com clienteQuem tem permissão de ver o cliente

​
Como configurar o agente para criar tarefas

1

Crie a tool create_task

Em Studio de IA > Tools, clique em Nova tool e escolha tipo CRM Action.
2

Selecione a action create_task

No painel de configuração, escolha a action create_task.
3

Defina quando o agente deve usar

Campo Quando usar: descreva os cenários em que o agente deve abrir tarefa (ex: “use sempre que o cliente disser que precisa confirmar com terceiros, mencionar uma pendência ou pedir conferência humana”).
4

(Opcional) Responsável padrão

Configure um default_assignee_user_id para usar quando o agente não conseguir determinar o responsável.
5

Vincule a tool ao agente

Em Studio de IA > Agentes, abra o agente e adicione a tool em Recursos vinculáveis.
Funciona igual para agente de voz e agente WhatsApp — a mesma tool serve aos dois.

​
Como configurar uma automação que cria tarefa

Use o bloco Criar tarefa no construtor visual:
CampoAceita
Título (template)Texto com {{variaveis}}
Descrição (template)Texto com {{variaveis}}
Responsável (opcional)UUID de usuário — se vazio, usa fallback
Prazo (em segundos a partir de agora)60 a 2.592.000 (= 30 dias)
Variáveis suportadas: {{cliente_nome}}, {{cliente_empresa}}, {{custom.cpf}}, {{context.disposition}}, etc. Veja a seção de templating.

​
Próximos passos

Automações

Crie réguas que disparam tarefas automaticamente

Retornos

A outra ponta: quando o “depois” é o próprio agente voltar

Tools (CRM Action)

Configure create_task e outras ações que o agente pode usar

Cliente 360

Veja onde as tarefas aparecem na ficha do cliente