Crea un'Automazione webhook Chat per comunicare con un'app integrata esterna quando si verifica un evento specifico in ClickUp. Ad esempio, quando viene pubblicato un messaggio in Chat in un determinato Canale, viene pubblicato automaticamente anche su Zapier o Make.

Questo articolo spiega come inviare eventi Chat fuori da ClickUp tramite l'Azione Chiama webhook. Per avviare un'Automazione Chat da un'app esterna, usa il Trigger Webhook ricevuto.

Puoi anche usare i webhook con le Automazioni delle attività.

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

Usa Trigger, Azioni, intestazioni URL e parametri delle Automazioni

I Trigger sono eventi che avviano un'Automazione.

Messaggio pubblicato è l'unico Trigger webhook Chat.

Le Azioni sono gli eventi avviati dall'Automazione dopo l'attivazione del Trigger. Per chiamare un webhook, usa l'Azione Chiama webhook.

Usa le intestazioni URL e i parametri 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 è possibile visualizzare i valori delle intestazioni per modificarli.

Crea un'Automazione webhook Chat

Per creare un'Automazione webhook Chat, da un canale:

1. In alto a destra, fai clic sull'icona robot.
2. Fai clic su Crea Automazione.
3. Configura il Trigger, le Condizioni e le Azioni:
   • Seleziona l'Azione Chiama webhook.
   • Seleziona un webhook esistente o Crea webhook:
   • Assegna un nome e una descrizione facoltativa al webhook.
   • Inserisci l'URL del webhook.
   • Seleziona i seguenti campi dinamici per includerli nell'URL.
   • ID commento: aggiungi l'ID del singolo commento Chat.
   • ID canale: aggiungi l'ID del Canale Chat.
   • Aggiungi intestazioni personalizzate facoltative:
   • Fai clic su Aggiungi, quindi inserisci una chiave e un valore.
   • Per impostazione predefinita, le intestazioni webhook includono Content-type=application/json.
   • 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.
4. Fai clic su Crea webhook.

Testa un'Automazione webhook Chat

Dopo aver creato il webhook, puoi testarlo da ClickUp.

Per testare un'Automazione webhook Chat:

1. Subito dopo aver creato il webhook, nell'angolo in alto a sinistra della finestra di dialogo dell'Automazione, fai clic sulla freccia. Oppure, da un canale:
   • Fai clic sull'icona robot.
   • Seleziona Gestisci Automazioni Chat.
   • Fai clic sulla scheda Webhook.
2. Passa il cursore sul webhook e fai clic su Test.
   • Viene visualizzato un messaggio con l'esito positivo o negativo dell'operazione.

Se il test non riesce

Puoi verificare se l'app esterna è operativa. Se non è disponibile, potremmo bloccare la chiamata webhook per motivi di sicurezza.

Se il test ha esito positivo

Puoi rendere il webhook Chat attivo in un'Automazione.

Crea un'Automazione Chat con un webhook esistente

Dopo aver testato il webhook Chat, rendilo attivo nel tuo Workspace.

Per attivare il webhook Chat:

1. Subito dopo aver testato il webhook, nella finestra di dialogo delle Automazioni seleziona la scheda Gestisci.
2. Fai clic su Aggiungi Automazione.
3. Configura il Trigger, le Condizioni e le Azioni:
   • Seleziona l'Azione Chiama webhook.
   • Seleziona il tuo webhook.
4. Fai clic su Crea.

Chiamata webhook non riuscita

Se il webhook è attivo e una chiamata webhook non riesce, ritentiamo per 1 ora e 15 minuti. Durante questo periodo, la chiamata verrà visualizzata nella scheda Attività Automazioni con stato in sospeso.

Disattiva il webhook Chat

Dopo l'attivazione del webhook Chat, puoi renderlo inattivo.

Per disattivare il webhook Chat, da un canale:

1. In alto a destra, fai clic sull'icona robot.
2. Seleziona Gestisci Automazioni Chat.
3. Fai clic sulla scheda Webhook.
4. A destra del webhook, fai clic sul toggle per disattivarlo.
5. Leggi l'avviso: anche le Automazioni che usano il webhook verranno disattivate.
6. Fai clic su Disabilita.
7. Il webhook Chat viene ora visualizzato nella scheda Inattivo.

Per riattivare il webhook Chat, apri la scheda Inattivo e fai clic sul toggle per attivarlo.

Chiavi e valori delle intestazioni

Di seguito trovi le intestazioni disponibili e alcune indicazioni per creare intestazioni personalizzate: