Búsqueda

Pregúntame cualquier cosa

Crear una Automatización de webhook de Chat

Crea una automatización de webhook de Chat para comunicarte con una aplicación externa integrada cuando se produzca un evento específico en ClickUp. Por ejemplo, cuando se publique un mensaje de Chat en un canal concreto, también se publicará automáticamente en Zapier o Make.

Este artículo trata sobre el envío de eventos de Chat desde ClickUp mediante la acción Llamar al webhook. Para que una aplicación externa inicie una automatización de Chat, usa el Webhook recibido como desencadenador.

También puedes usar webhooks con automatizaciones de tareas.

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

Usa desencadenadores, acciones, encabezados de URL y parámetros de automatización

Los desencadenadores son eventos que inician una automatización.

Se publica un mensaje es el único desencadenador de webhook de Chat.

Las acciones son los eventos que la automatización inicia tras activarse. Para llamar a un webhook, usa la acción Llamar al webhook.

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

  • La ubicación de ClickUp desde la que se envía el webhook
  • El punto de conexión 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 los valores de los encabezados para editarlos.

Captura de pantalla de una automatización de webhook de Chat

Crear una automatización de webhook de Chat

Para crear una automatización de webhook de Chat, desde un canal:

  1. En la parte superior derecha, haz clic en el icono de robot.
  2. Haz clic en Crear automatización.
  3. Configura el desencadenador, las condiciones y las acciones:
    • Selecciona la acción Llamar al webhook.
    • Selecciona un webhook existente o Crear webhook:
    • Asigna un nombre a tu webhook y, opcionalmente, una descripción.
    • Introduce la URL del webhook.
    • Selecciona los siguientes campos dinámicos para incluirlos en la URL.
    • ID de comentario: añade el ID individual del comentario de Chat.
    • ID de canal: añade el ID del canal de Chat.
    • Añade encabezados personalizados opcionales:
    • Haz clic en Añadir e introduce una clave y un valor.
    • De forma predeterminada, los encabezados del webhook incluyen Content-type=application/json.
    • 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.
  4. Haz clic en Crear webhook.

Probar una automatización de webhook de Chat

Después de crear el webhook, puedes probarlo desde ClickUp.

Para probar una automatización de webhook de Chat:

  1. Justo después de crear el webhook, en la esquina superior izquierda del modal de automatización, haz clic en el símbolo de intercalación. O bien, desde un canal:
    • Haz clic en el icono de robot.
    • Selecciona Gestionar automatizaciones de Chat.
    • Haz clic en la pestaña Webhooks.
  2. Sitúa el cursor sobre el webhook y haz clic en Probar.
    • Aparece un mensaje indicando si la prueba se ha completado correctamente o ha fallado.

Si la prueba falla

Puedes comprobar si la aplicación externa está operativa. Si no lo está, es posible que bloqueemos la llamada al webhook por motivos de seguridad.

Si la prueba es correcta

Si la prueba es correcta, puedes activar el webhook de Chat en una automatización.

Crear una automatización de Chat con un webhook existente

Después de probar el webhook de Chat, lo activarás en tu Entorno de trabajo.

Para activar el webhook de Chat:

  1. Justo después de probar el webhook, en el modal de automatizaciones selecciona la pestaña Gestionar.
  2. Haz clic en Añadir automatización.
  3. Configura el desencadenador, las condiciones y las acciones:
    • Selecciona la acción Llamar al webhook.
    • Selecciona tu webhook.
  4. Haz clic en Crear.

Llamada al webhook fallida

Si tu webhook está activo y una llamada falla inicialmente, volvemos a intentarlo 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 de Chat

Una vez activado el webhook de Chat, puedes desactivarlo.

Para desactivar el webhook de Chat, desde un canal:

  1. En la parte superior derecha, haz clic en el icono de robot.
  2. Selecciona Gestionar automatizaciones de Chat.
  3. Haz clic en la pestaña Webhooks.
  4. A la derecha de tu webhook, haz clic en el botón de alternancia para desactivarlo.
  5. Revisa la advertencia de que las automatizaciones que usen el webhook también se desactivarán.
  6. Haz clic en Desactivar.
  7. El webhook de Chat aparece ahora en la pestaña Inactivo.

Para volver a activar el webhook de Chat, abre la pestaña Inactivo y activa el botón de alternancia.

Captura de pantalla de la pestaña de webhooks, con la opción para desactivar un webhook resaltada.

Claves y valores de encabezado

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

Clave de encabezado Descripción Valor de encabezado
Accept Especifica el tipo de respuesta que enviará el servidor. application/json, text/html
Authorization Envía las credenciales del cliente en el cuerpo de la solicitud.
Por ejemplo, un JSON Web Token.		 abC0012.Efg34.hIj5
Content-type Solo se admite JSON. application/json
Referrer Contiene la URL completa o parcial donde se almacenan los recursos solicitados. http:www.example.com
Custom Los encabezados personalizados se usan para proteger la carga útil, por ejemplo especificando una clave de autorización. Introduce una clave y un valor personalizados.