Un webhook de chat permite que los servicios externos publiquen mensajes automáticos en un canal de ISO Mate. Un administrador del canal habilita el webhook en la Configuración del Canal, copia la URL del webhook y luego las herramientas externas envían una solicitud POST con un cuerpo JSON sencillo para publicar un mensaje. Es ideal para notificaciones de compilación, alertas de monitoreo y actualizaciones de estado desde otros sistemas.
Habilitar un webhook de canal
- Abre Chat desde el grupo General de la barra lateral y selecciona el canal.
- Abre Configuración del Canal desde la cabecera del canal (solo administradores) y ve a la pestaña Webhook.
- Activa Webhook Habilitado.
- Usa Copiar URL para copiar la URL del Webhook para tu servicio externo.
Publicar un mensaje por webhook
Envía una solicitud POST a la URL del webhook con un cuerpo JSON. Solo el texto del mensaje es obligatorio, y puedes personalizar el nombre y el avatar del bot que publica.
POST /api/chat/webhook/{token}
Content-Type: application/json
{
"text": "¡Hola desde mi integración!",
"username": "Mi Bot",
"icon_url": "https://example.com/bot-avatar.png"
}Campos del payload
- text: el contenido del mensaje, obligatorio, hasta 4000 caracteres.
- username: un nombre para mostrar del bot, opcional, hasta 100 caracteres.
- icon_url: una URL de avatar para el bot, opcional.
Los mensajes publicados así aparecen en el canal etiquetados como webhook, con el nombre de bot que indiques. El diálogo de configuración también incluye un ejemplo de cURL que puedes copiar para probar rápidamente.
Usos comunes
- Notificaciones de compilación: publica los resultados de las canalizaciones de CI y CD, como éxito o fallo.
- Alertas de monitoreo: reenvía alertas desde herramientas de monitoreo externas.
- Actualizaciones de estado: envía actualizaciones automáticas desde servicios de terceros.
Regenerar el token
Si un token de webhook pudo quedar expuesto, usa Regenerar Token en la pestaña Webhook. La regeneración invalida la URL actual del webhook, así que actualiza tus servicios externos con la nueva URL después. Para gestionar el canal en sí, consulta Uso de canales de chat de equipo.
Automatiza las actualizaciones de tu equipo en el chat. Comienza tu prueba gratuita de 14 días.