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 y los límites de las funciones 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 hacer un seguimiento global de todos los eventos de creación, actualización y eliminación de tareas, Listas, subcarpetas, Carpetas, Espacios, Metas e Indicadores.

Más información sobre los webhooks de la API de ClickUp, incluidos:

• 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 de creación de webhook directamente desde el navegador.

Webhooks de Automatización

Usa los webhooks de Automatizaciones cuando quieras tener un control total sobre los Desencadenadores 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 tarea: envían datos cuando se actualizan las tareas.
• Webhooks de Chat: envían datos cuando se publican mensajes en el Chat.

Crear un webhook

Tendrás que crear un webhook para cada destino que vaya a recibir datos de ClickUp a través de Automatizaciones.

Puedes reutilizar los webhooks que hayas creado en Automatizaciones en todo tu Entorno de trabajo, pero tendrás que configurar webhooks independientes para las Automatizaciones de tareas y de Chat.

Asegúrate de probar el webhook antes de añadirlo a las Automatizaciones que enviarán datos reales.

Usar variables dinámicas en el webhook

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

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

Usar cabeceras

Las cabeceras 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 la siguiente cabecera:

Content-type: application/json

Usar parámetros de URL

También puedes definir parámetros de URL para cada webhook y ayudar así 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 la Automatización.

Probar webhooks

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

Puedes encontrar 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 envía ClickUp.

Para webhooks de API:

• Filtra tu primer webhook a eventos concretos, como taskCreated y taskUpdated.
• Filtra tu primer webhook a una ubicación concreta, como una Lista dedicada que solo contenga tareas de prueba con datos genéricos pero representativos.

Para webhooks de Automatización:

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