Configurar avisos de Slack para los comentarios de revisión

Envía, si quieres, una notificación a un canal de Slack cada vez que alguien comente en un enlace de revisión de Commentful que has compartido.

Generar un webhook en Slack ​

1. Crea una app de Slack (si aún no tienes una) ​

Crea tu app de Slack

Elige un nombre y un espacio de trabajo al que asociar la app (ten en cuenta que probablemente publicarás muchos mensajes de prueba, así que quizá te convenga crear un canal para pruebas) y haz clic en Create App. Si ya has creado una app, puedes usar esa.

2. Activa los Incoming Webhooks en tu app de Slack ​

Después de crear tu app de Slack, se te redirigirá a la página de ajustes de la nueva app (si usas una app existente, abre sus ajustes desde el panel de gestión de apps).

Desde ahí, selecciona la función Incoming Webhooks y haz clic en el interruptor Activate Incoming Webhooks para activarla.

3. Crea un Incoming Webhook para tu espacio de trabajo de Slack ​

Con los Incoming Webhooks activados, la página de ajustes debería actualizarse y mostrar algunas opciones más. Una de ellas es un botón muy práctico llamado Add New Webhook to Workspace: haz clic en él.

Este botón lanza una versión abreviada del proceso de instalación de las apps de Slack, totalmente independiente, para que no tengas que escribir código para generar una URL de Incoming Webhook. Verás una pantalla parecida a esta:

Pantalla de permisos con el selector de canal de los Incoming Webhooks

Elige el canal en el que publicará la app y haz clic en el botón Authorize. Si necesitas añadir el Incoming Webhook a un canal privado, primero tienes que estar en ese canal.

Volverás a los ajustes de tu app, donde deberías ver una entrada nueva en la sección Webhook URLs for Your Workspace, con una URL de webhook parecida a esta:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Esa URL es tu flamante Incoming Webhook, específico para un único usuario y un único canal.

Añadir la URL de tu webhook de Slack desde el plugin Commentful ​

Para configurar las notificaciones de Slack de Commentful, crea una URL de webhook de Slack siguiendo los pasos anteriores y, después, en el plugin Commentful de Figma, abre el botón con el icono Settings (en la esquina superior derecha de la ventana del plugin), haz clic en Enable webhook notifications for review links, comprueba que Slack está seleccionado en el desplegable Webhook Platform, copia y pega la URL de tu webhook de Slack y haz clic en Save Webhook URL:

por ejemplo, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Para comprobar que la integración con Slack funciona, haz clic en el botón Send Test Message, que envía una notificación de prueba desde Commentful a tu canal de Slack.

Añadir la URL de tu webhook de Slack desde la app web de Commentful ​

Para configurar las notificaciones de Slack de Commentful, crea una URL de webhook de Slack siguiendo los pasos anteriores y, después, en la app web de Commentful (al abrir cualquier enlace de revisión compartido en el navegador), pulsa las teclas CTRL + K del teclado y copia y pega la URL de tu webhook de Slack:

por ejemplo, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Para comprobar que la integración con Slack funciona, haz clic en el botón Send Test Message to Slack, que envía una notificación de prueba desde Commentful a tu canal de Slack.

Las notificaciones del webhook de Slack se envían al canal de Slack que elijas como avisos del canal. Si incluyes texto como @name en tus comentarios de Commentful, puede que Slack lo muestre en el cuerpo del mensaje, pero Commentful no asocia automáticamente a los revisores de Commentful con usuarios de Slack, así que no se garantizan menciones nativas de Slack.