Usa el Trigger Webhook recibido para iniciar una Automatización de ClickUp cuando una aplicación externa envíe una solicitud. Aplicaciones como Stripe, GitHub o una integración personalizada pueden enviar datos a ClickUp para ejecutar tu Automatización, sin necesidad de un conector de terceros.

Si quieres que una Automatización se inicie desde una aplicación externa, usa el Trigger Webhook recibido. Este Trigger inicia una Automatización estándar o de Chat cuando una aplicación externa envía una solicitud POST a ClickUp. Para enviar datos fuera de ClickUp, usa la Acción Llamar webhook.

El Trigger Webhook recibido está disponible en el plan Business y superiores. La disponibilidad de funciones y los límites varían según el plan y el rol del usuario. Más información

¿Qué es el Trigger Webhook recibido?

El Trigger Webhook recibido permite que una aplicación externa envíe información a ClickUp para iniciar una Automatización.

La información que envía la aplicación externa es el payload. ClickUp genera una URL única para cada Automatización que usa este Trigger. Cuando una aplicación envía una solicitud POST a esa URL, la Automatización se ejecuta.

Cada URL está vinculada a una Automatización y no vence.

Activa el ClickApp Webhook recibido

Antes de que los administradores puedan crear Automatizaciones con este Trigger, el ClickApp debe estar activado:

1. En la esquina superior izquierda, haz clic en el nombre de tu Entorno de trabajo y selecciona Aplicaciones.
2. Busca y activa Webhook recibido.

Cómo funciona la autenticación

ClickUp crea una clave de API para tu Entorno de trabajo. Todas las URL de webhook del Entorno de trabajo usan la misma clave de API. Envía la clave de API en el encabezado de autorización de cada solicitud a la URL del webhook. Las solicitudes sin una clave de API válida se rechazan.

De forma predeterminada, solo los propietarios y administradores del Entorno de trabajo pueden ver la clave de API.

En la sección del Trigger, usa Mostrar para ver la clave de API o Copiar para copiarla. También puedes encontrar Clave de API en la tarjeta del ClickApp Webhook recibido y usar Mostrar o Copiar desde ahí.

Crea una Automatización con el Trigger Webhook recibido

Desde un Espacio, Carpeta, Subcarpeta, Lista o Canal de Chat:

1. En la esquina superior derecha, haz clic en el ícono del robot.
2. Haz clic en Crear Automatización.
3. Selecciona el Trigger Webhook recibido. Se generará una URL de Webhook única y se mostrará la clave de API de tu Entorno de trabajo.
4. Haz clic en Copiar junto a URL de Webhook para copiar la URL. Haz clic en Copiar junto a Clave de API para copiar la clave.
5. En Payload de muestra, pega un cuerpo JSON de muestra. ClickUp convierte sus campos en variables que puedes insertar en las Acciones a continuación.
6. Elige una Acción disponible.
7. Haz clic en Crear.
8. Para ejecutar la Automatización, envía una solicitud POST a la URL del webhook.
9. Envía la clave de API como valor sin procesar en el encabezado Authorization. Una solicitud válida devuelve 202.
10. En la sección del Trigger, haz clic en Regenerar junto a URL de Webhook para crear una nueva URL. La URL anterior deja de funcionar y devuelve 404.

Las solicitudes entrantes tienen un límite de 1 MB. Las solicitudes están limitadas a 60 por minuto por token de API y 200 por minuto por Entorno de trabajo.

Rota la clave de API

Para rotar la clave de API del Entorno de trabajo:

1. En la esquina superior izquierda, haz clic en el nombre de tu Entorno de trabajo y selecciona Aplicaciones.
2. Busca y selecciona Webhook recibido.
3. En Clave de API, haz clic en Rotar.
4. La nueva clave se aplica a todas las URL de webhook del Entorno de trabajo. La clave anterior devuelve 401 para cada URL.

Actualiza la clave de API en cada aplicación externa que envíe solicitudes al Entorno de trabajo.