Para compartir datos de ClickUp con aplicaciones externas, puedes usar dos tipos de Webhooks en ClickUp:

1. Webhooks creados a través de la API pública de ClickUp.
2. Webhooks activados por Automatizaciones.

La disponibilidad de funciones y los límites varían según el plan y el rol del usuario. Más información

Webhooks de API

Usa los Webhooks de API cuando quieras rastrear de manera general todos los eventos de creación, actualización y eliminación de tareas, Listas, Subcarpetas, Carpetas, Espacios, Metas e Indicadores.

Obtén más información sobre los Webhooks de API de ClickUp, incluyendo:

• Consulta ejemplos de payloads.
• Revisa la especificación de los endpoints de webhook de la API pública de ClickUp.
• Envía tu primera solicitud Create webhook directamente desde tu navegador.

Webhooks de Automatización

Usa los Webhooks de Automatizaciones cuando quieras tener control total sobre los Disparadores y las Condiciones que envían tus datos a aplicaciones externas.

Hay dos tipos de Webhooks de Automatización que puedes crear en ClickUp:

• Webhooks de tareas: envían datos cuando se actualizan las tareas.
• Webhooks de Chat: envían datos cuando se publican mensajes de chat.

Crear un webhook

Necesitas crear un webhook para cada destino que recibirá datos de ClickUp desde las Automatizaciones.

Puedes reutilizar los Webhooks que creaste en Automatizaciones en todo tu Entorno de trabajo, pero debes configurar Webhooks separados para las Automatizaciones de Tareas y de Chat.

Asegúrate de probar tu webhook antes de agregarlo a Automatizaciones que vayan a enviar datos reales.

Usar variables dinámicas en tu Webhook

Las variables dinámicas en la URL pueden ayudar a tu aplicación a procesar los datos que recibe de ClickUp de forma más eficiente.

Puedes usar variables dinámicas en la URL de tu webhook, como el ID de tarea.

Usar encabezados

Los encabezados pueden incluir metadatos que permiten a tu aplicación procesar los payloads entrantes del webhook de forma segura y precisa. De forma predeterminada, ClickUp incluye el siguiente encabezado:

Content-type: application/json

Usar parámetros de URL

También puedes definir parámetros de URL para cada webhook y así ayudar a tu aplicación a procesar los datos con precisión.

A diferencia de las variables dinámicas, los parámetros de URL son estáticos. Los valores no cambian cada vez que se activa tu Automatización.

Probar webhooks

Cuando empieces a usar webhooks, te recomendamos probarlos antes de enviar datos reales desde tu Entorno de trabajo de ClickUp.

Puedes encontrar y usar herramientas gratuitas en línea para probar y experimentar con webhooks. Por ejemplo, puedes usar webhook.site para generar una URL de webhook y ver los payloads que ClickUp envía.

Para Webhooks de API:

• Filtra tu primer webhook a eventos específicos, como taskCreated y taskUpdated.
• Filtra tu primer webhook a una ubicación específica, como una Lista exclusiva que solo contenga tareas de prueba con datos genéricos pero representativos.

Para Webhooks de Automatización:

• Aplica Disparadores y Condiciones precisos, como un Campo personalizado de tipo Casilla de selección para controlar cuándo se envían los datos.
• Agrega la Automatización primero a una Lista o Canal específico, con tareas y mensajes genéricos pero representativos.