Per condividere i dati di ClickUp con app esterne, puoi usare due tipi di webhook in ClickUp:

1. Webhook creati tramite la API pubblica di ClickUp.
2. Webhook attivati dalle Automazioni.

La disponibilità delle funzionalità e i limiti variano in base al piano e al ruolo dell'utente. Scopri di più

Webhook API

Usa i webhook API quando vuoi monitorare in modo generale tutti gli eventi di creazione, aggiornamento ed eliminazione per attività, Elenchi, Sottocartelle, Cartelle, Spazi, Obiettivi e Target.

Scopri di più sui webhook API di ClickUp, inclusi:

• Consulta i payload di esempio.
• Esamina la specifica per gli endpoint webhook dell'API pubblica di ClickUp.
• Invia la tua prima richiesta Crea webhook direttamente dal browser.

Webhook delle Automazioni

Usa i webhook delle Automazioni quando vuoi avere il controllo completo sui Trigger e sulle Condizioni che inviano i tuoi dati alle app esterne.

In ClickUp puoi creare due tipi di webhook delle Automazioni:

• Webhook attività: inviano dati quando le attività vengono aggiornate.
• Webhook Chat: inviano dati quando vengono pubblicati messaggi in chat.

Crea un webhook

Devi creare un webhook per ogni destinazione che riceverà dati da ClickUp tramite le Automazioni.

Puoi riutilizzare i webhook creati nelle Automazioni in tutto il tuo Workspace, ma dovrai configurare webhook separati per le Automazioni di attività e di Chat.

Assicurati di testare il webhook prima di aggiungerlo alle Automazioni che invieranno dati reali.

Usa le variabili dinamiche nel webhook

Le variabili dinamiche nell'URL possono aiutare la tua app a elaborare in modo efficiente i dati ricevuti da ClickUp.

Puoi usare variabili dinamiche nell'URL del webhook, come l'ID attività.

Usa le intestazioni

Le intestazioni possono includere metadati che permettono alla tua app di elaborare i payload webhook in arrivo in modo sicuro e preciso. Per impostazione predefinita, ClickUp include la seguente intestazione:

Content-type: application/json

Usa i parametri URL

Puoi anche impostare parametri URL per ogni webhook per aiutare la tua app a elaborare i dati con precisione.

A differenza delle variabili dinamiche, i parametri URL sono statici: i valori non cambiano ogni volta che l'Automazione viene attivata.

Testa i webhook

Quando inizi a usare i webhook per la prima volta, ti consigliamo di testarli prima di inviare dati reali dal tuo Workspace di ClickUp.

Online trovi strumenti gratuiti per testare e sperimentare con i webhook. Ad esempio, puoi usare webhook.site per generare un URL webhook e visualizzare i payload webhook inviati da ClickUp.

Per i webhook API:

• Filtra il primo webhook su eventi specifici, come taskCreated e taskUpdated.
• Filtra il primo webhook su una posizione specifica, ad esempio un Elenco dedicato che contiene solo attività di test con dati generici ma rappresentativi.

Per i webhook delle Automazioni:

• Applica Trigger e Condizioni precisi, ad esempio un Campo personalizzato Casella di controllo per controllare quando vengono inviati i dati.
• Aggiungi prima l'Automazione a un Elenco o a un canale specifico, con attività e messaggi generici ma rappresentativi.