Crear flujos de trabajo que comienzan con webhooks
- Todos los miembros (por defecto)
- Disponible en planes de pago
Los Flujos de trabajo son tareas o procesos automatizados de múltiples pasos que se ejecutan directamente en Slack. Los flujos de trabajo pueden ser tan sencillos o complejos como quieras y normalmente no exigen escribir ningún código. Para crear un flujo de trabajo que se ejecuta cuando ocurre un evento en un servicio externo, puedes utilizar un webhook.
Lo que necesitarás para comenzar
- Familiaridad con el envío de solicitudes HTTP usando la línea de comando u otra herramienta.
- Entender los webhooks entrantes. Si necesitas ayuda, lee la documentación sobre la API de Slack o pídele ayuda a un desarrollador de tu equipo.
Nota: Los propietarios y administradores pueden restringir el acceso a crear flujos de trabajo a través de webhooks. Si no ves esta opción en el Generador de flujos de trabajo, ponte en contacto con un propietario o administrador para pedirle ayuda.
Configuración del flujo de trabajo
Conceptos básicos del flujo de trabajo de webhook
En Slack, todos los flujos de trabajo se inician en respuesta a un desencadenante. Para desencadenar un flujo de trabajo mediante un webhook, debes configurar el webhook para ejecutar tu flujo de trabajo cuando en otro servicio se produzca un evento que especifiques. Por ejemplo, puedes crear un flujo de trabajo que publique un mensaje en un canal específico cuando hay un problema con tu página web para que el equipo de ingeniería pueda investigarlo.
Cómo configurar tu webhook
El servicio externo que utilices para crear y configurar tu webhook debe permitirte realizar una solicitud HTTP POST a Slack cuando ocurren ciertos eventos. Slack generará una solicitud URL única para tu flujo de trabajo cuando la publiques y podrás configurar tu webhook para transmitir información a Slack en el cuerpo de la solicitud HTTP. Se puede hacer referencia a cualquier dato que tu webhook envíe a Slack en los pasos que agregues a tu flujo de trabajo al crear variables.
Consejo: Si no sabes bien cómo configurar tu webhook, te recomendamos que le pidas ayuda a un desarrollador de tu equipo o que consultes cualquier documento de apoyo que te haya entregado el servicio que uses, como Postman o Zapier.
Cómo crear variables personalizadas
Puedes agregar hasta 20 variables para transmitir datos de otro servicio a Slack e incluir información específica de Slack como los nombres de Slack o las direcciones de correo electrónico en los pasos que agregues a tu flujo de trabajo.
Para crear variables personalizadas, puedes agregar pares de valores clave al Generador de flujos de trabajo como una variable basada en texto. Una vez que agregues una variable, verás una vista previa del cuerpo del HTTP para que puedas asegurarte de que los valores coincidan con las salidas JSON en el otro servicio que estés conectando a Slack con tu webhook. Ten en cuenta que actualmente no es posible utilizar estructuras JSON anidadas en variables de flujo de trabajo.
En el ejemplo a continuación, si no se enviaron el usuario, la severidad ni la descripción_incidencia con tu solicitud de webhook, el flujo de trabajo podría fallar.
Consejo: Si necesitas agregar, quitar o modificar variables en cualquier momento, abre tu flujo de trabajo en el Generador de flujos de trabajo. A continuación, haz clic en el ícono del lápiz junto a Se inicia con un webhook para realizar los cambios. También deberás asegurarte de que cualquier cambio en las variables se refleje en el servicio externo desde el que se envía tu solicitud de webhook.
Obtén tu URL de solicitud web
Cuando publiques tu flujo de trabajo, Slack generará una URL de solicitud única que puedes agregar a tu webhook para asegurarte de que envíe la PUBLICACIÓN que configuraste al canal correcto. Las URL de solicitud comienzan con https://hooks.slack.com/triggers y las sigue una cadena aleatoria de caracteres.
Asegúrate de mantener tu URL de solicitud segura, ya que cualquier persona que tenga el enlace podrá desencadenar tu flujo de trabajo.
Nota: Los flujos de trabajo de webhook están limitados a una solicitud por segundo. Obtén más información sobre límites de frecuencia en el sitio de la API de Slack.
Agregar pasos para completar tu flujo de trabajo
Agregar pasos
Una vez que hayas configurado tu webhook y creado las variables que te gustaría usar, estarás listo para agregar pasos a tu flujo de trabajo.
- Abre tu flujo de trabajo en el Generador de flujos de trabajo.
- Haz clic en Agregar paso.
- Elige el tipo de paso que desees agregar, luego sigue las indicaciones para personalizar el paso.
Cómo probar tu flujo de trabajo
Antes de publicar tu flujo de trabajo en un canal que los miembros de tu espacio de trabajo estén usando de forma activa, puedes configurar el primer paso para publicar en un canal de prueba.
- Envía una PUBLICACIÓN a la solicitud URL de tu flujo de trabajo y sigue los pasos para asegurarte de que todo funcione como corresponde.
- Regresa al Generador de flujos de trabajo y actualiza el primer paso de tu flujo de trabajo para publicar en tu canal preferido, luego publica los cambios.