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

Este artículo explica cómo ClickUp envía datos con la Acción Llamar webhook. Si quieres que una app 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 aprender sobre los webhooks de Chat.

La disponibilidad y los límites de las funciones 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 actualizados los datos en otros sistemas.

La información que ClickUp envía cuando se activa o se llama a un webhook se conoce como payload.

En el caso de los webhooks de tareas, el payload incluye información sobre la tarea que activó la Automatización en ClickUp.

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

Acciones de Llamar webhook

Desde un Espacio, Carpeta, Subcarpeta o Lista en ClickUp, puedes crear una Automatización activada 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 un payload diferente. Te recomendamos usar la acción Llamar webhook para cualquier integración nueva 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 donde se envía el webhook
• El endpoint de la app externa
• O el tipo de medio del cuerpo de la solicitud

Los encabezados de URL son sensibles. Una vez guardados, no puedes ver sus valores para editarlos.

A continuación encontrarás los encabezados que incluimos y algunas pautas 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 ícono de robot.
2. Haz clic en Administrar automatizaciones.
3. Haz clic en la pestaña Webhooks.
4. Haz clic en Crear webhook.
5. Ingresa un título único.
6. Agrega una descripción.
7. Ingresa la URL de tu webhook.
8. Selecciona los campos dinámicos que quieras incluir en la URL.
9. Agrega encabezados personalizados:
   • De forma predeterminada, los encabezados del webhook incluyen Content-type=application/json.
   • Haz clic en Agregar para añadir más pares clave-valor.
10. Agrega parámetros de URL personalizados opcionales:
    • Ingresa una clave y un valor para agregar parámetros de URL personalizados.
    • Haz clic en Agregar para añadir más pares clave-valor.
11. Haz clic en Probar webhook para enviar un payload 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 ícono de robot.
2. Haz clic en Crear automatización.
3. Selecciona la Acción Llamar webhook.
4. Selecciona tu webhook en el menú desplegable.
5. Haz clic en Crear.

Crear un webhook usando la acción Llamar 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 ícono de robot.
2. Haz clic en Crear automatización.
3. Selecciona la Acción Llamar webhook.
4. Haz clic en Crear webhook.
5. Ingresa un título único.
6. Agrega una descripción.
7. Ingresa 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 como application/json de forma predeterminada.
   • Para agregar un encabezado personalizado, haz clic en +Agregar e ingresa una clave y un valor.
10. En la sección Parámetros de URL, ingresa una clave y un valor para agregar parámetros personalizados.
11. Haz clic en Probar webhook para enviar un payload 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

Después de 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 fue exitoso o si falló.

Si la prueba falla

Si la prueba falla, verifica que la app externa esté operativa. Si está caída, es posible que bloqueemos la llamada al webhook por razones de seguridad.

Si la prueba es exitosa

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

Llamada a webhook fallida

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

Desactivar el webhook

Después de activar un webhook de tarea, puedes dejarlo inactivo.

Desde la pestaña de webhooks, haz clic en el botón de alternancia para dejar inactivo un webhook existente.

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

Usar la acción Llamar webhook (Legacy)

Para usar la acción Llamar webhook (Legacy), desde un Espacio, Carpeta, Subcarpeta o Lista:

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