ClickUp

Collega ClickUp a AI SmartTalk per sincronizzare attività e documenti nella tua base di conoscenza e automatizzare la gestione delle attività con le azioni SmartFlow.

---

Panoramica

L'integrazione di ClickUp ti consente di:

• Sincronizzare attività e documenti nella tua base di conoscenza
• Interrogare lo stato del progetto in modo conversazionale
• Automatizzare la creazione e gli aggiornamenti delle attività tramite SmartFlow
• Ottimizzare i flussi di lavoro tra chat e gestione dei progetti

---

Requisiti

Prima di iniziare, assicurati di avere:

• Un account AI SmartTalk attivo
• Un account ClickUp con accesso allo spazio di lavoro
• Permessi di amministratore o membro nello spazio di lavoro

---

Procedura Passo-Passo

Passo 1: Collega il tuo account ClickUp

1. Accedi al tuo account AI SmartTalk
2. Vai su Impostazioni → Integrazioni
3. Trova ClickUp e fai clic su Collega
4. Si apre la finestra di autorizzazione ClickUp OAuth
5. Fai clic su Collega Spazio di Lavoro e autorizza l'accesso

Passo 2: Seleziona Spazi di Lavoro e Spazi

Dopo l'autorizzazione:

1. Scegli quali Spazi di Lavoro collegare
2. Seleziona Spazi all'interno di ciascun spazio di lavoro
3. Scegli Cartelle e Elenco da sincronizzare
4. Fai clic su Continua

Passo 3: Configura le Impostazioni di Sincronizzazione

Impostazione	Descrizione
Attività	Sincronizza nomi delle attività, descrizioni, stato
Documenti	Sincronizza il contenuto dei Documenti ClickUp
Commenti	Includi commenti delle attività (opzionale)
Allegati	Riferisci gli URL degli allegati

Passo 4: Avvia la Sincronizzazione Iniziale

1. Fai clic su Avvia Sincronizzazione
2. AI SmartTalk importa il tuo contenuto ClickUp
3. La barra di progresso mostra lo stato della sincronizzazione
4. Verifica il contenuto nella sezione Conoscenza

---

Cosa Viene Sincronizzato

Attività

Campo	Sincronizzato
Nome dell'attività	✅
Descrizione	✅
Stato	✅
Assegnatari	✅
Date di scadenza	✅
Priorità	✅
Tag	✅
Campi personalizzati	✅
Commenti	Opzionale
Sottoattività	✅

Documenti

Campo	Sincronizzato
Titolo del documento	✅
Contenuto del documento	✅
Pagine annidate	✅
Ultimo aggiornamento	✅

---

Azioni SmartFlow

ClickUp esporta potenti azioni SmartFlow per automatizzare la gestione dei progetti:

Azioni Disponibili

Azione	Descrizione	Parametri
Crea Attività	Aggiungi una nuova attività a un elenco	name, description, list_id, assignees, due_date
Aggiorna Attività	Modifica un'attività esistente	task_id, status, priority, assignees
Aggiungi Commento	Commenta un'attività	task_id, comment_text
Cambia Stato	Sposta l'attività tra gli stati	task_id, new_status
Assegna Attività	Cambia gli assegnatari dell'attività	task_id, user_ids
Ottieni Attività	Recupera i dettagli dell'attività	task_id

Esempio: Crea Attività da Chat

Quando un cliente segnala un problema, crea automaticamente un'attività ClickUp:

Trigger: Servizio Chat
Condition: Il messaggio contiene "bug" o "problema"
Actions:
  1. Richiesta AI:
       Estrai il riassunto del problema dalla conversazione
  2. ClickUp - Crea Attività:
       Elenco: Segnalazioni Bug
       Nome: {{extracted_summary}}
       Descrizione: "Segnalato via chat da {{customer_name}}"
       Priorità: Alta
  3. Risposta Chat:
       "Ho creato una segnalazione bug per il nostro team. Riferimento: {{task_id}}"

Esempio: Notifica di Aggiornamento Stato

Quando lo stato di un'attività cambia, notifica il cliente:

Trigger: Webhook (attività ClickUp aggiornata)
Condition: Stato cambiato in "Fatto"
Actions:
  1. Ottieni Email Cliente:
       Dal campo personalizzato dell'attività
  2. Invia Email:
       A: {{customer_email}}
       Oggetto: La tua richiesta è stata completata
       Corpo: L'attività "{{task_name}}" è ora completa

---

Casi d'Uso

Supporto Clienti

Sincronizza le attività di supporto in modo che l'AI possa rispondere:

• "Qual è lo stato del mio ticket di supporto?"
• "Quanti problemi aperti abbiamo?"
• "Quando è stata assegnata la mia richiesta?"

Assistente Interno

Aiuta i membri del team con domande sui progetti:

• "Quali attività sono in scadenza questa settimana?"
• "Mostrami tutti i bug ad alta priorità"
• "Su cosa sta lavorando @John?"

Report di Stato del Progetto

L'AI può riassumere lo stato del progetto:

• "Dammi un riassunto dei progressi dello Sprint 14"
• "Quante attività sono bloccate?"
• "Cosa ha completato il team la settimana scorsa?"

Flussi di Lavoro Automatizzati

Attiva azioni ClickUp dalla chat:

• Richiesta del cliente → Crea attività
• Parola chiave di escalation → Assegna al manager
• Problema risolto → Aggiorna stato dell'attività

---

Comportamento di Sincronizzazione

Sincronizzazione Automatica

AI SmartTalk sincronizza periodicamente i dati di ClickUp:

• Nuove attività vengono aggiunte
• Attività aggiornate vengono rinfrescate
• Attività eliminate/archiviate vengono rimosse

Sincronizzazione Manuale

Forza un aggiornamento immediato:

1. Vai su Impostazioni → Integrazioni → ClickUp
2. Clicca su Sincronizza Ora

Aggiornamenti in Tempo Reale tramite Webhook

Per aggiornamenti istantanei, configura i webhook di ClickUp:

1. In ClickUp, vai su Impostazioni → Integrazioni
2. Configura il webhook per l'endpoint di AI SmartTalk
3. Le modifiche alle attività attivano aggiornamenti immediati della base di conoscenza

---

Risoluzione dei Problemi

Problemi di Connessione

Problema	Soluzione
"Autorizzazione fallita"	Ri-autorizza tramite OAuth
"Workspace non trovato"	Controlla i permessi del workspace
"Accesso negato"	Assicurati di avere il ruolo di membro/amministratore

Problemi di Sincronizzazione

Problema	Soluzione
Attività mancanti	Verifica che le attività siano nelle Liste selezionate
Dati obsoleti	Clicca su Sincronizza Ora per aggiornare
Documenti non sincronizzati	Abilita i Documenti nelle impostazioni di sincronizzazione

Problemi con le Azioni SmartFlow

Problema	Soluzione
"Creazione attività fallita"	Controlla che list_id sia valido
"Stato non valido"	Usa il nome esatto dello stato da ClickUp
"Utente non trovato"	Verifica user_id dell'assegnatario

---

Gestire la Connessione

Azione	Come
Aggiungi spazi	Modifica connessione → Seleziona spazi aggiuntivi
Rimuovi spazi	Deseleziona gli spazi di cui non hai bisogno
Aggiorna token	Ri-autorizza se il token scade
Disconnetti	Impostazioni → Integrazioni → ClickUp → Disconnetti

---

Migliori Pratiche

Per la Sincronizzazione della Conoscenza

1. Sii selettivo: Sincronizza solo spazi/liste rilevanti
2. Usa descrizioni: Attività ben documentate = risposte migliori dall'AI
3. Nomenclatura coerente: Nomi chiari delle attività aiutano l'AI a comprendere il contesto
4. Sincronizzazione regolare: Mantieni i dati aggiornati per risposte accurate

Per le Azioni SmartFlow

1. Testa in staging: Testa la creazione di attività prima in una lista di test
2. Gestisci errori: Aggiungi gestione degli errori per le chiamate API fallite
3. Usa modelli: Crea modelli di attività riutilizzabili
4. Registra azioni: Monitora le creazioni automatiche di attività per audit

---

Documentazione Correlata

• Panoramica delle Integrazioni
• Integrazione JIRA — Integrazione simile per la gestione dei progetti
• Azioni SmartFlow
• Webhook SmartFlow