Usa el disparador Webhook received 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 ningún conector de terceros de por medio.

Si quieres que una automatización se inicie desde una aplicación externa, usa el disparador Webhook received. Este disparador 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 a webhook.

El disparador Webhook received 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 disparador Webhook received?

El disparador Webhook received 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 disparador. Cuando una aplicación envía una solicitud POST a esa URL, la automatización se ejecuta.

Cada URL está vinculada a una sola automatización y no caduca.

Activar el ClickApp Webhook received

Antes de que los administradores puedan crear automatizaciones con este disparador, 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 received.

Cómo funciona la autenticación

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

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

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

Crear una automatización con el disparador Webhook received

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

1. En la esquina superior derecha, haz clic en el icono del robot.
2. Haz clic en Crear automatización.
3. Selecciona el disparador Webhook received. Se generará una URL de webhook única y se mostrará la clave 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 API para copiar la clave.
5. En Payload de muestra, pega un cuerpo JSON de ejemplo. ClickUp convierte sus campos en variables que puedes insertar en las acciones de abajo.
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 API como valor sin formato en el encabezado Authorization. Una solicitud válida devuelve 202.
10. En la sección del disparador, 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. La frecuencia de solicitudes está limitada a 60 por minuto por token de API y a 200 por minuto por Entorno de trabajo.

Rotar la clave API

Para rotar la clave 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 received.
3. En Clave 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 API en todas las aplicaciones externas que envíen solicitudes al Entorno de trabajo.