Usa il Trigger Webhook ricevuto per avviare un'Automazione di ClickUp quando un'app esterna invia una richiesta. App come Stripe, GitHub o un'integrazione personalizzata possono inviare dati a ClickUp per eseguire la tua Automazione, senza alcun connettore di terze parti.

Se vuoi che un'Automazione parta da un'app esterna, usa il Trigger Webhook ricevuto. Questo Trigger avvia un'Automazione standard o di Chat quando un'app esterna invia una richiesta POST a ClickUp. Per inviare dati fuori da ClickUp, usa invece l'Azione Chiama webhook.

Il Trigger Webhook ricevuto è disponibile nel piano Business e superiori. La disponibilità delle funzionalità e i limiti variano in base al piano e al ruolo utente. Ulteriori informazioni

Che cos'è il Trigger Webhook ricevuto?

Il Trigger Webhook ricevuto consente a un'app esterna di inviare informazioni a ClickUp per avviare un'Automazione.

Le informazioni inviate dall'app esterna costituiscono il payload. ClickUp genera un URL univoco per ogni Automazione che usa questo Trigger. Quando un'app invia una richiesta POST a quell'URL, l'Automazione viene eseguita.

Ogni URL è collegato a una sola Automazione e non scade.

Attiva la ClickApp Webhook ricevuto

Prima che gli amministratori possano creare Automazioni con questo Trigger, la ClickApp deve essere attivata:

1. Nell'angolo in alto a sinistra, fai clic sul nome della tua Area di lavoro e seleziona App.
2. Cerca e attiva Webhook ricevuto.

Come funziona l'autenticazione

ClickUp crea una chiave API per la tua Area di lavoro. Ogni URL webhook nell'Area di lavoro usa la stessa chiave API. Invia la chiave API nell'intestazione di autorizzazione di ogni richiesta all'URL webhook. Le richieste prive di una chiave API valida vengono rifiutate.

Per impostazione predefinita, solo i titolari e gli amministratori dell'Area di lavoro possono visualizzare la chiave API.

Nella sezione Trigger, usa Mostra per visualizzare la chiave API o Copia per copiarla. Puoi anche trovare la Chiave API nella scheda della ClickApp Webhook ricevuto e usare Mostra o Copia direttamente da lì.

Crea un'Automazione con il Trigger Webhook ricevuto

Da uno Spazio, una Cartella, una Sottocartella, un Elenco o un canale Chat:

1. Nell'angolo in alto a destra, fai clic sull'icona robot.
2. Fai clic su Crea Automazione.
3. Seleziona il Trigger Webhook ricevuto. Verrà generato un URL webhook univoco e verrà visualizzata la chiave API della tua Area di lavoro.
4. Fai clic su Copia accanto a URL webhook per copiare l'URL. Fai clic su Copia accanto a Chiave API per copiare la chiave.
5. In Payload di esempio, incolla un corpo JSON di esempio. ClickUp trasforma i suoi campi in variabili che puoi inserire nelle Azioni sottostanti.
6. Scegli un'Azione disponibile.
7. Fai clic su Crea.
8. Per eseguire l'Automazione, invia una richiesta POST all'URL webhook.
9. Invia la chiave API come valore grezzo nell'intestazione Authorization. Una richiesta valida restituisce 202.
10. Nella sezione Trigger, fai clic su Rigenera accanto a URL webhook per creare un nuovo URL. Il vecchio URL smette di funzionare e restituisce 404.

Le richieste in entrata hanno un limite massimo di 1 MB. Le richieste sono limitate a 60 al minuto per token API e 200 al minuto per Area di lavoro.

Ruota la chiave API

Per ruotare la chiave API dell'Area di lavoro:

1. Nell'angolo in alto a sinistra, fai clic sul nome della tua Area di lavoro e seleziona App.
2. Cerca e seleziona Webhook ricevuto.
3. Sotto Chiave API, fai clic su Ruota.
4. La nuova chiave si applica a tutti gli URL webhook nell'Area di lavoro. La vecchia chiave restituisce 401 per ogni URL.

Aggiorna la chiave API in ogni app esterna che invia richieste all'Area di lavoro.