Crea un'Automazione webhook per comunicare con un'app integrata esterna quando si verifica un evento specifico in un'attività di ClickUp.

Questo articolo illustra l'invio di dati da parte di ClickUp tramite l'Azione Chiama webhook. Per far sì che un'app esterna avvii un'Automazione in ClickUp, usa invece il Trigger Webhook ricevuto.

Consulta il nostro articolo Crea un'Automazione webhook per Chat per saperne di più sui webhook di Chat.

La disponibilità delle funzionalità e i limiti variano in base al piano e al ruolo dell'utente. Ulteriori informazioni

Cosa sono i webhook?

I webhook sono un metodo automatizzato per inviare informazioni da ClickUp alle tue integrazioni e ad altri sistemi.

Invece di richiedere le informazioni a ClickUp, i webhook le inviano in modo proattivo per mantenere aggiornati i dati negli altri sistemi.

Le informazioni inviate da ClickUp quando un webhook viene attivato, o chiamato, prendono il nome di payload.

Per i webhook delle attività, il payload include informazioni sull'attività che ha attivato l'Automazione in ClickUp.

Puoi anche configurare i webhook tramite la nostra API pubblica.

Azioni Chiama webhook

Da uno Spazio, una Cartella, una Sottocartella o un Elenco in ClickUp, puoi creare un'Automazione attivata dall'attività su un'attività, che chiama un webhook come Azione dell'Automazione.

La tabella seguente descrive le Azioni disponibili:

Ogni azione ha un payload diverso. Ti consigliamo di usare l'azione Chiama webhook per tutte le nuove integrazioni che stai creando.

Usa intestazioni e parametri URL

Usa le intestazioni e i parametri URL per definire i dettagli del webhook, ad esempio:

• La posizione in ClickUp da cui viene inviato il webhook
• L'endpoint dell'app esterna
• Il tipo di media del corpo della richiesta

Le intestazioni URL sono sensibili. Una volta salvate, non puoi visualizzarne i valori per modificarli.

Di seguito trovi le intestazioni che abbiamo messo a disposizione e alcune linee guida per creare intestazioni personalizzate:

Crea un webhook senza creare un'Automazione

Per creare un webhook prima di configurare un'Automazione, da uno Spazio, una Cartella, una Sottocartella o un Elenco:

1. In alto a destra, fai clic sull'icona robot.
2. Fai clic su Gestisci Automazioni.
3. Fai clic sulla scheda Webhook.
4. Fai clic su Crea webhook.
5. Inserisci un titolo univoco.
6. Aggiungi una descrizione.
7. Inserisci l'URL del webhook.
8. Seleziona eventuali campi dinamici per includerli nell'URL.
9. Aggiungi intestazioni personalizzate:
   • Per impostazione predefinita, le intestazioni del webhook includono Content-type=application/json.
   • Fai clic su Aggiungi per aggiungere altre coppie chiave-valore.
10. Aggiungi parametri URL personalizzati facoltativi:
    • Inserisci una chiave e un valore per aggiungere parametri URL personalizzati.
    • Fai clic su Aggiungi per aggiungere altre coppie chiave-valore.
11. Fai clic su Testa webhook per inviare un payload di esempio.
12. Fai clic su Crea webhook.

Usa un webhook esistente in un'Automazione

Per creare un'Automazione usando un webhook esistente, da uno Spazio, una Cartella, una Sottocartella o un Elenco:

1. In alto a destra, fai clic sull'icona robot.
2. Fai clic su Crea Automazione.
3. Seleziona l'Azione Chiama webhook.
4. Seleziona il webhook dal menu a discesa.
5. Fai clic su Crea.

Crea un webhook usando l'azione Chiama webhook

Per creare un webhook durante la creazione di un'Automazione, da uno Spazio, una Cartella, una Sottocartella o un Elenco:

1. In alto a destra, fai clic sull'icona robot.
2. Fai clic su Crea Automazione.
3. Seleziona l'Azione Chiama webhook.
4. Fai clic su Crea Webhook.
5. Inserisci un titolo univoco.
6. Aggiungi una descrizione.
7. Inserisci l'URL del webhook.
8. Seleziona eventuali campi dinamici per includerli nell'URL.
9. Nella sezione Intestazioni, per impostazione predefinita il tipo di contenuto è impostato su application/json.
   • Per aggiungere un'intestazione personalizzata, fai clic su +Aggiungi e inserisci una chiave e un valore.
10. Nella sezione Parametri URL, inserisci una chiave e un valore per aggiungere parametri personalizzati.
11. Fai clic su Testa webhook per inviare un payload di esempio prima di abilitare il webhook.
12. Fai clic su Crea webhook.
13. Completa la configurazione del Trigger dell'Automazione, delle Condizioni e di eventuali altre Azioni.
14. Fai clic su Crea.

Testa il tuo webhook

Dopo aver creato un webhook, puoi testarlo, modificarlo, eliminarlo o disattivarlo dalla scheda Webhook:

1. Passa il cursore sul webhook e fai clic su Testa.
2. Viene visualizzato un messaggio che indica se l'operazione è riuscita o meno.

Se il test fallisce

Se il test fallisce, verifica che l'app esterna sia operativa. Se non è disponibile, potremmo bloccare la chiamata webhook per motivi di sicurezza.

Se il test ha esito positivo

Se il test ha esito positivo, puoi attivare il webhook in tutta sicurezza e iniziare a usarlo nelle Automazioni!

Chiamata webhook non riuscita

Se il webhook è attivo e una chiamata webhook non va a buon fine, riproviamo per 1 ora e 15 minuti. Durante questo periodo, la chiamata viene visualizzata nella scheda Attività delle Automazioni con stato in sospeso.

Disattiva il webhook

Dopo che un webhook di attività è stato attivato, puoi renderlo inattivo.

Dalla scheda Webhook, fai clic sul toggle per rendere inattivo un webhook esistente.

Anche le Automazioni che usano il webhook verranno disattivate.

Usa l'Azione Chiama webhook (Legacy)

Per usare l'Azione Chiama webhook (Legacy), da uno Spazio, una Cartella, una Sottocartella o un Elenco:

1. In alto a destra, fai clic sull'icona robot.
2. Fai clic su Crea Automazione.
3. Seleziona l'Azione Chiama webhook (Legacy).
4. Inserisci l'URL del webhook.
5. Seleziona eventuali campi dinamici per includerli nell'URL.
6. Fai clic su Crea.