# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-28T23:43:42.523Z

## Página

- Título: Criar Tarefa/Atividade
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/criar-tarefa-atividade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Cria uma atividade no CRM reaproveitando entidades e usuário já resolvidos no webhook.

## Seções

- Quando usar
- Impacto operacional
- Entradas e saídas
- Campos de configuração
- Orientações do node
- Boas práticas
- Como validar
- Próximos passos

## Conteúdo da página

# Criar Tarefa/Atividade

Criar Tarefa/Atividade é um node de webhook. Sua função principal é: cria uma atividade no CRM reaproveitando entidades e usuário já resolvidos no webhook. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma.

## Quando usar

Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa.

## Impacto operacional

- Cria tarefa ou atividade no CRM e pode definir responsável, data, quadro e checklist.
- Pode alterar oportunidade, funil, etapa, responsável ou status comercial.
- Cria, busca ou atualiza entidades como lead, contato ou empresa.
- Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout.
- Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes.

## Entradas e saídas

Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo.

## Campos de configuração

| Campo | Como preencher |
| --- | --- |
| Nome | define o nome, título ou valor principal usado pelo node. |
| Conteúdo | texto enviado, registrado ou usado como base da ação. Quando aceitar variáveis, valide se elas estarão preenchidas no momento da execução. |
| Ajuda sobre distribuição por equipe | permite distribuir a ação entre membros de uma equipe, normalmente por rodízio ou regra equivalente. |
| Selecionar empresa | identifica a origem operacional do registro para relatórios e segmentação. |
| Data vinda do evento | identifica a origem operacional do registro para relatórios e segmentação. |
| Máscara da data | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| Data Atividade | controla prazo, espera ou horário. Revise timezone e impacto em SLA antes de publicar. |
| Horário (Opcional) | controla prazo, espera ou horário. Revise timezone e impacto em SLA antes de publicar. |
| Timezone do horário | controla prazo, espera ou horário. Revise timezone e impacto em SLA antes de publicar. |
| URL do Meet (Opcional) | identifica a origem operacional do registro para relatórios e segmentação. |
| Etapa do Quadro | define a etapa de destino no funil ou quadro selecionado. |
| Variável de destino da atividade no contexto | texto enviado, registrado ou usado como base da ação. Quando aceitar variáveis, valide se elas estarão preenchidas no momento da execução. |
| Atribuir para agenda pessoal se existir ? | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. |
| Tipo | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| Quadro | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| Checklist | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| Bindings | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |

## Orientações do node

O que faz
- Cria uma tarefa/atividade no CRM.
- Permite vincular lead, contato, empresa e responsável usando valores fixos ou resultados do contexto do webhook.

Entradas configuráveis
- Nome e Conteúdo com suporte a variáveis.
- Tipo de atividade, data/hora, board e checklist.
- Blocos de vínculo para lead, contato, empresa e usuário.
- Distribuição por equipe em round robin quando nenhum usuário for resolvido.

Saídas
- 1 saída: segue após criar a atividade.

## Boas práticas

- Teste o node em um fluxo controlado e confira o histórico gerado antes de usar em uma automação crítica.
- Em webhooks, confirme se os campos do payload existem em todos os cenários do sistema de origem.

## Como validar

- Configure o node em um fluxo de teste antes de publicar.
- Execute com um registro, conversa ou payload controlado.
- Confira se o caminho seguido, os dados criados e as mensagens enviadas correspondem ao resultado esperado.
- Revise o histórico da entidade, conversa ou execução para confirmar o impacto real.

## Próximos passos

Volte para a referência de [Nodes de webhooks](/docs/configuracao/referencias/nodes-webhooks) ou combine este node com outros nodes do mesmo fluxo para completar a jornada.