Webhooks

Un webhook envía un POST a una dirección tuya cuando ocurre algo en los paquetes que eliges: para iniciar un despliegue, abrir un pull request o publicar en un canal de chat.

Antes de empezar

Necesitas una dirección https:// que acepte peticiones POST, o la URL del webhook entrante de un canal de Slack o Discord. Los webhooks de un equipo están en la organización: tu organización → Webhooks, con las mismas páginas.

Añade un webhook

1. Abre Configuración → Webhooks y luego Añadir un webhook.
2. Introduce la URL de destino (1).
3. Elige el Formato (2): JSON (firmado) para tu propio servidor, Slack o Discord para un canal.
4. Marca los Eventos (3): Nuevas versiones, Avisos de seguridad, Paquetes retirados.
5. Elige los Paquetes (4): los paquetes que sigues, los paquetes que enumeras por su nombre de Composer o todos los paquetes (una entrega por compilación del repositorio).
6. Selecciona Añadir webhook (5).

En los webhooks JSON, la página muestra a continuación el secreto de firma una sola vez: cópialo en tu servidor.

Verifica una entrega JSON

Cada entrega JSON lleva la cabecera X-MeteorGPL-Signature: sha256=<HMAC-SHA256 of the body with your secret>. Calcula el mismo HMAC sobre el cuerpo sin procesar y compáralo antes de confiar en el contenido. El cuerpo indica el evento y, por paquete, su nombre de Composer, título, tipo, las nuevas versiones, un enlace y el comando de instalación.

Tus webhooks

Cada webhook muestra su dirección y su formato con su estado: Activo, En pausa o Desactivado tras varios fallos (1); después, sus eventos y paquetes (2).

• Enviar una prueba (3) envía de inmediato una entrega ping.
• Pausar y Activar detienen y reanudan las entregas; Eliminar borra el webhook.
• Entregas recientes (4) muestra cada entrega con su resultado, el estado HTTP con el que respondió tu servidor y el número de intentos; Volver a entregar repite una.

Una entrega fallida se vuelve a intentar más tarde: seis intentos en total, repartidos a lo largo de unas 15 horas. Tras 20 fallos seguidos, el webhook se desactiva y se te avisa; corrige el endpoint y selecciona Activar.