Slack
Requisitos previos
- Un Workspace de Slack donde puedas instalar apps.
- Permisos de administrador o de gestión de apps en ese Workspace.
1. Crear una app de Slack
- Abre api.slack.com/apps → Create New App → From scratch.
- Ponle un nombre (por ejemplo,
isthisthing.online Alerts) y elige tu Workspace.
2. Activar Incoming Webhooks
- En la barra lateral de la app, haz clic en Incoming Webhooks.
- Activa Activate Incoming Webhooks en On.
- Haz clic en Add New Webhook to Workspace.
- Elige el canal de destino (por ejemplo,
#incidents) → Allow.
Recibirás una URL como:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
Copia esta URL: la necesitarás en el siguiente paso.
3. Añadir la integración en isthisthing.online
- Ve a Integrations → New Integration.
- Selecciona Slack como tipo.
- Rellena los campos:
| Campo | Valor |
|---|---|
| Name | Una etiqueta descriptiva, p. ej. Slack #incidents |
| Webhook URL | La URL del paso 2 |
| Channel | Déjalo vacío (el webhook publica en el canal que elegiste) |
- Activa los eventos disparadores que necesites (creado / resuelto / actualizado).
- Haz clic en Save.
4. Probar
Haz clic en el icono Test junto a tu integración en la lista. En unos segundos debería aparecer un mensaje de prueba en tu canal de Slack.
Qué incluye el mensaje
| Campo | Descripción |
|---|---|
| Event & Status | CREATED, RESOLVED o UPDATED con el estado actual del Incident |
| Workspace & Monitor | Nombres e IDs para referencia rápida |
| Timestamps | Hora de inicio, resolución y emisión en UTC |
| Links | Botones para abrir el Incident o el Dashboard del Workspace |
Solución de problemas
| Problema | Solución |
|---|---|
| No llega ningún mensaje | Comprueba que la integración esté enabled y que al menos un evento disparador esté activo. Verifica que la URL del webhook siga activa en Slack. |
Error invalid_blocks | Regenera el webhook en Slack y actualiza la URL en la configuración de la integración. |
| Canal incorrecto | Los Incoming Webhooks publican en el canal elegido al crearlos. Crea un webhook nuevo para otro canal. |
Seguridad
- Trata las URL de webhook como secretos: no las subas al control de versiones.
- Rota la URL de inmediato si se expone.
- Limita la gestión de integraciones a Owners y Admins del Workspace.