ClickUp

Conecte o ClickUp ao AI SmartTalk para sincronizar tarefas e documentos com sua base de conhecimento e automatizar o gerenciamento de tarefas com ações do SmartFlow.

---

Visão Geral

A integração do ClickUp permite que você:

• Sincronize tarefas e documentos em sua base de conhecimento
• Consulta o status do projeto de forma conversacional
• Automatize a criação e atualizações de tarefas via SmartFlow
• Otimize fluxos de trabalho entre chat e gerenciamento de projetos

---

Pré-requisitos

Antes de começar, certifique-se de que você possui:

• Uma conta ativa do AI SmartTalk
• Uma conta do ClickUp com acesso ao espaço de trabalho
• Permissões de administrador ou membro no espaço de trabalho

---

Configuração Passo a Passo

Passo 1: Conecte Sua Conta do ClickUp

1. Faça login na sua conta do AI SmartTalk
2. Navegue até Configurações → Integrações
3. Encontre ClickUp e clique em Conectar
4. A janela de OAuth do ClickUp se abre
5. Clique em Conectar Espaço de Trabalho e autorize o acesso

Passo 2: Selecione Espaços de Trabalho e Espaços

Após a autorização:

1. Escolha quais Espaços de Trabalho conectar
2. Selecione Espaços dentro de cada espaço de trabalho
3. Escolha Pastas e Listas para sincronizar
4. Clique em Continuar

Passo 3: Configure as Configurações de Sincronização

Configuração	Descrição
Tarefas	Sincronizar nomes, descrições e status das tarefas
Documentos	Sincronizar conteúdo dos Documentos do ClickUp
Comentários	Incluir comentários das tarefas (opcional)
Anexos	Referenciar URLs de anexos

Passo 4: Iniciar Sincronização Inicial

1. Clique em Iniciar Sincronização
2. O AI SmartTalk importa seu conteúdo do ClickUp
3. A barra de progresso mostra o status da sincronização
4. Verifique o conteúdo na seção Conhecimento

---

O Que É Sincronizado

Tarefas

Campo	Sincronizado
Nome da tarefa	✅
Descrição	✅
Status	✅
Atribuições	✅
Datas de vencimento	✅
Prioridade	✅
Tags	✅
Campos personalizados	✅
Comentários	Opcional
Subtarefas	✅

Documentos

Campo	Sincronizado
Título do documento	✅
Conteúdo do documento	✅
Páginas aninhadas	✅
Última atualização	✅

---

Ações SmartFlow

ClickUp exporta poderosas ações SmartFlow para automatizar o gerenciamento de projetos:

Ações Disponíveis

Ação	Descrição	Parâmetros
Criar Tarefa	Adicionar nova tarefa a uma lista	name, description, list_id, assignees, due_date
Atualizar Tarefa	Modificar tarefa existente	task_id, status, priority, assignees
Adicionar Comentário	Comentar em uma tarefa	task_id, comment_text
Mudar Status	Mover tarefa entre status	task_id, new_status
Atribuir Tarefa	Alterar os responsáveis pela tarefa	task_id, user_ids
Obter Tarefa	Recuperar detalhes da tarefa	task_id

Exemplo: Criar Tarefa a partir do Chat

Quando um cliente relata um problema, crie automaticamente uma tarefa ClickUp:

Trigger: Chat Service
Condition: Message contains "bug" or "issue"
Actions:
  1. AI Request:
       Extract issue summary from conversation
  2. ClickUp - Create Task:
       List: Bug Reports
       Name: {{extracted_summary}}
       Description: "Reported via chat by {{customer_name}}"
       Priority: High
  3. Chat Response:
       "I've created a bug report for our team. Reference: {{task_id}}"

Exemplo: Notificação de Atualização de Status

Quando o status de uma tarefa muda, notifique o cliente:

Trigger: Webhook (ClickUp task updated)
Condition: Status changed to "Done"
Actions:
  1. Get Customer Email:
       From task custom field
  2. Send Email:
       To: {{customer_email}}
       Subject: Your request has been completed
       Body: Task "{{task_name}}" is now complete

---

Casos de Uso

Suporte ao Cliente

Sincronize tarefas de suporte para que a IA possa responder:

• "Qual é o status do meu ticket de suporte?"
• "Quantos problemas abertos temos?"
• "Quando meu pedido foi atribuído?"

Assistente Interno

Ajude os membros da equipe com consultas sobre projetos:

• "Quais tarefas estão vencendo esta semana?"
• "Mostre-me todos os bugs de alta prioridade"
• "Em que o @John está trabalhando?"

Relatório de Status do Projeto

A IA pode resumir o estado do projeto:

• "Dê-me um resumo do progresso da Sprint 14"
• "Quantas tarefas estão bloqueadas?"
• "O que a equipe completou na semana passada?"

Fluxos de Trabalho Automatizados

Acione ações ClickUp a partir do chat:

• Pedido do cliente → Criar tarefa
• Palavra-chave de escalonamento → Atribuir ao gerente
• Problema resolvido → Atualizar status da tarefa

---

Comportamento de Sincronização

Sincronização Automática

A IA SmartTalk sincroniza periodicamente os dados do ClickUp:

• Novas tarefas são adicionadas
• Tarefas atualizadas são refrescadas
• Tarefas deletadas/arquivadas são removidas

Sincronização Manual

Force uma atualização imediata:

1. Vá para Configurações → Integrações → ClickUp
2. Clique em Sincronizar Agora

Atualizações em Tempo Real via Webhooks

Para atualizações instantâneas, configure webhooks do ClickUp:

1. No ClickUp, vá para Configurações → Integrações
2. Configure o webhook para o endpoint da IA SmartTalk
3. Mudanças na tarefa acionam atualizações imediatas na base de conhecimento

---

Resolução de Problemas

Problemas de Conexão

Problema	Solução
"Autorização falhou"	Re-autorização através do OAuth
"Espaço de trabalho não encontrado"	Verifique as permissões do espaço de trabalho
"Acesso negado"	Assegure-se de que você possui o papel de membro/admin

Problemas de Sincronização

Problema	Solução
Tarefas ausentes	Verifique se as tarefas estão nas Listas selecionadas
Dados desatualizados	Clique em Sincronizar Agora para atualizar
Documentos não sincronizando	Ative Documentos nas configurações de sincronização

Problemas de Ações do SmartFlow

Problema	Solução
"Falha na criação da tarefa"	Verifique se o list_id é válido
"Status inválido"	Use o nome exato do status do ClickUp
"Usuário não encontrado"	Verifique o user_id do responsável

---

Gerenciando a Conexão

Ação	Como
Adicionar espaços	Editar conexão → Selecionar espaços adicionais
Remover espaços	Desmarcar espaços que você não precisa
Atualizar tokens	Re-autorização se o token expirar
Desconectar	Configurações → Integrações → ClickUp → Desconectar

---

Melhores Práticas

Para Sincronização de Conhecimento

1. Seja seletivo: Sincronize apenas espaços/listas relevantes
2. Use descrições: Tarefas bem documentadas = melhores respostas da IA
3. Nomeação consistente: Nomes de tarefas claros ajudam a IA a entender o contexto
4. Sincronização regular: Mantenha os dados atualizados para respostas precisas

Para Ações do SmartFlow

1. Teste em staging: Teste a criação de tarefas em uma lista de teste primeiro
2. Lide com erros: Adicione tratamento de erros para chamadas de API falhadas
3. Use templates: Crie templates de tarefas reutilizáveis
4. Registre ações: Acompanhe criações de tarefas automatizadas para auditoria

---

Documentação Relacionada

• Visão Geral das Integrações
• Integração com JIRA — Integração semelhante de gerenciamento de projetos
• Ações do SmartFlow
• Webhooks do SmartFlow