Búsqueda

Pregúntame lo que quieras

Crear una Automatización de webhook en Chat

Crea una Automatización de webhook de Chat para comunicarte con una app integrada externa cuando ocurra un evento específico en ClickUp. Por ejemplo, cuando se publica un mensaje de Chat en un Canal en particular, también se publica automáticamente en Zapier o Make.

Este artículo explica cómo enviar eventos de Chat desde ClickUp con la Acción Llamar webhook. Para que una app externa inicie una Automatización de Chat, usa el Disparador Webhook recibido.

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 Disparadores, Acciones, encabezados de URL y parámetros de Automatización

Los Disparadores son eventos que inician una Automatización.

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

Las Acciones son los eventos que la Automatización inicia después de activarse. Para llamar a un webhook, usa la Acción Llamar webhook.

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

  • La ubicación en 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 confidenciales. Una vez guardados, no puedes ver los valores del encabezado para editarlos.

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

Crea una Automatización de webhook de Chat

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

  1. En la esquina superior derecha, haz clic en el ícono de robot.
  2. Haz clic en Crear Automatización.
  3. Configura tu Disparador, Condiciones y Acciones:
    • Selecciona la Acción Llamar webhook.
    • Selecciona un webhook existente o Crear webhook:
    • Asigna un nombre y una descripción opcional a tu webhook.
    • Ingresa la URL de tu webhook.
    • Selecciona los siguientes campos dinámicos para incluirlos en la URL.
    • ID de comentario: agrega el ID del comentario de Chat individual.
    • ID de canal: agrega el ID del Canal de Chat.
    • Agrega encabezados personalizados opcionales:
    • Haz clic en Agregar e ingresa una clave y un valor.
    • De forma predeterminada, los encabezados del webhook incluyen Content-type=application/json.
    • 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 sumar más pares clave-valor.
  4. Haz clic en Crear webhook.

Prueba 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 caret. O bien, desde un canal:
    • Haz clic en el ícono de robot.
    • Selecciona Administrar Automatizaciones de Chat.
    • Haz clic en la pestaña Webhooks.
  2. Coloca el cursor sobre el webhook y haz clic en Probar.
    • Aparece un mensaje que indica si la prueba fue exitosa o fallida.

Si la prueba falla

Puedes verificar si 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 de Chat en una Automatización.

Crea una Automatización de Chat con un webhook existente

Después de probar el webhook de Chat, actívalo 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 Administrar.
  2. Haz clic en Agregar Automatización.
  3. Configura tu Disparador, Condiciones y Acciones:
    • Selecciona la Acción Llamar webhook.
    • Selecciona tu webhook.
  4. Haz clic en Crear.

Llamada de webhook fallida

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

Desactiva el webhook de Chat

Después de activar el webhook de Chat, puedes desactivarlo.

Para desactivar el webhook de Chat, desde un canal:

  1. En la esquina superior derecha, haz clic en el ícono de robot.
  2. Selecciona Administrar Automatizaciones de Chat.
  3. Haz clic en la pestaña Webhooks.
  4. A la derecha de tu webhook, haz clic en el interruptor para desactivarlo.
  5. Revisa la advertencia que indica que las Automatizaciones que usan el webhook también se desactivarán.
  6. Haz clic en Deshabilitar.
  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 interruptor.

Captura de pantalla de la pestaña Webhooks, donde se resalta la opción para deshabilitar un webhook.

Claves y valores de encabezado

A continuación encontrarás los encabezados que incluimos y algunas pautas 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 están almacenados los recursos solicitados. http:www.example.com
Custom Los encabezados personalizados se usan para proteger el payload, por ejemplo, especificando una clave de Authorization. Ingresa una clave y un valor personalizados.