Crea una Automatización con webhook para comunicarte con una aplicación externa integrada cuando se produzca un evento específico en una tarea de ClickUp.

Este artículo trata sobre el envío de datos desde ClickUp mediante la Acción Llamar al webhook. Si quieres que una aplicación externa inicie una Automatización en ClickUp, usa el Disparador Webhook recibido.

Consulta nuestro artículo Crear una Automatización con webhook de Chat para saber más sobre los webhooks de Chat.

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

¿Qué son los webhooks?

Los webhooks son una forma automatizada de enviar información desde ClickUp a tus integraciones y otros sistemas.

En lugar de solicitar la información a ClickUp, los webhooks la envían de forma proactiva para mantener los datos actualizados en otros sistemas.

La información que ClickUp envía cuando se activa o se llama a un webhook se denomina carga útil (payload).

En el caso de los webhooks de tareas, la carga útil incluye información sobre la tarea que disparó la Automatización en ClickUp.

También puedes configurar webhooks mediante nuestra API pública.

Acciones de Llamar al webhook

Desde un Espacio, Carpeta, subcarpeta o Lista en ClickUp, puedes crear una Automatización disparada por la actividad de una tarea que llame a un webhook como Acción de Automatización.

La siguiente tabla describe las Acciones disponibles:

Cada acción tiene una carga útil diferente. Te recomendamos usar la acción Llamar al webhook para cualquier nueva integración que estés creando.

Usar encabezados y parámetros de URL

Usa encabezados y parámetros de URL para definir los detalles del webhook, por ejemplo:

• La ubicación de ClickUp desde la que se envía el webhook
• El endpoint de la aplicación externa
• O el tipo de medio del cuerpo de la solicitud

Los encabezados de URL son confidenciales. Una vez guardados, no podrás ver sus valores para editarlos.

A continuación encontrarás los encabezados que hemos incluido y algunas indicaciones para crear encabezados personalizados:

Crear un webhook sin crear una Automatización

Para crear un webhook antes de configurar una Automatización, desde un Espacio, Carpeta, subcarpeta o Lista:

1. En la esquina superior derecha, haz clic en el icono del robot.
2. Haz clic en Gestionar automatizaciones.
3. Haz clic en la pestaña Webhooks.
4. Haz clic en Crear webhook.
5. Introduce un título único.
6. Añade una descripción.
7. Introduce la URL de tu webhook.
8. Selecciona los campos dinámicos que quieras incluir en la URL.
9. Añade encabezados personalizados:
   • De forma predeterminada, los encabezados del webhook incluyen Content-type=application/json.
   • Haz clic en Añadir para agregar más pares clave-valor.
10. Añade parámetros de URL personalizados opcionales:
    • Introduce una clave y un valor para añadir parámetros de URL personalizados.
    • Haz clic en Añadir para agregar más pares clave-valor.
11. Haz clic en Probar webhook para enviar una carga útil de ejemplo.
12. Haz clic en Crear webhook.

Usar un webhook existente en una Automatización

Para crear una Automatización con un webhook existente, desde un Espacio, Carpeta, subcarpeta o Lista:

1. En la esquina superior derecha, haz clic en el icono del robot.
2. Haz clic en Crear automatización.
3. Selecciona la Acción Llamar al webhook.
4. Selecciona tu webhook en el menú desplegable.
5. Haz clic en Crear.

Crear un webhook usando la acción Llamar al webhook

Para crear un webhook mientras configuras una Automatización, desde un Espacio, Carpeta, subcarpeta o Lista:

1. En la esquina superior derecha, haz clic en el icono del robot.
2. Haz clic en Crear automatización.
3. Selecciona la Acción Llamar al webhook.
4. Haz clic en Crear webhook.
5. Introduce un título único.
6. Añade una descripción.
7. Introduce la URL de tu webhook.
8. Selecciona los campos dinámicos que quieras incluir en la URL.
9. En la sección Encabezados, el tipo de contenido está configurado de forma predeterminada como application/json.
   • Para añadir un encabezado personalizado, haz clic en +Añadir e introduce una clave y un valor.
10. En la sección Parámetros de URL, introduce una clave y un valor para añadir parámetros personalizados.
11. Haz clic en Probar webhook para enviar una carga útil de ejemplo antes de activar tu webhook.
12. Haz clic en Crear webhook.
13. Termina de configurar el Disparador, las Condiciones y cualquier otra Acción de tu Automatización.
14. Haz clic en Crear.

Probar tu webhook

Tras crear un webhook, puedes probarlo, editarlo, eliminarlo o desactivarlo desde la pestaña Webhooks:

1. Pasa el cursor sobre el webhook y haz clic en Probar.
2. Aparecerá un mensaje indicando si la prueba ha sido correcta o ha fallado.

Si la prueba falla

Si la prueba falla, comprueba que la aplicación externa esté operativa. Si no está disponible, es posible que bloqueemos la llamada al webhook por motivos de seguridad.

Si la prueba es correcta

Si la prueba es correcta, ya puedes activar el webhook con confianza y empezar a usarlo en las Automatizaciones.

Llamada al webhook fallida

Si tu webhook está activo y una llamada falla, se reintentará durante 1 hora y 15 minutos. Durante ese tiempo, la llamada aparecerá en tu pestaña Actividad de automatizaciones con estado pendiente.

Desactivar el webhook

Una vez activado un webhook de tarea, puedes dejarlo inactivo.

Desde la pestaña de webhooks, haz clic en el interruptor para desactivar un webhook existente.

Las Automatizaciones que usen el webhook también quedarán inactivas.

Usar la acción Llamar al webhook (heredado)

Para usar la acción Llamar al webhook (heredado), desde un Espacio, Carpeta, subcarpeta o Lista:

1. En la esquina superior derecha, haz clic en el icono del robot.
2. Haz clic en Crear automatización.
3. Selecciona la Acción Llamar al webhook (heredado).
4. Introduce la URL de tu webhook.
5. Selecciona los campos dinámicos que quieras incluir en la URL.
6. Haz clic en Crear.