Los emails de Vercel y la pestaña del dashboard se pasan por alto en un lanzamiento. Los equipos que ya usan webhooks salientes de Netlify quieren el mismo patrón en Vercel: HTTP POST en eventos de deploy, no otra integración de Slack que cuidar.
Los Webhooks del proyecto Vercel pueden hacer POST JSON a AlertHub. Plantillas título y descripción con placeholders, y Slack, Telegram, WhatsApp, Discord o Teams comparten los eventos warning/critical.
A qué suscribirse
| Evento Vercel | Nivel recomendado | Por qué importa |
|---|---|---|
deployment.error | Critical | Producción (o preview) no salió |
deployment.canceled | Warning | Alguien abortó un release |
deployment.succeeded / deployment.ready | Info | Historial en el panel; no inundes Slack |
deployment.created | Info | Ruido opcional |
Solo warning y critical se reparte. Los deploys correctos deben quedarse en info salvo que seas un fundador solo y quieras un toque en Telegram en cada promote a producción.
Las formas del payload evolucionan; los campos anidados usan la misma sintaxis Mustache que Stripe ({{payload.deployment.url}}). Si un placeholder queda vacío, inspecciona una entrega en Vercel y ajústalo — o usa el constructor de webhooks.
Configuración (una sola vez)
- Crea un proyecto en app.thealerthub.com y copia la clave secreta.
- Construye la URL (widgets de abajo).
- En Vercel: Settings → Webhooks del proyecto → añadir endpoint → elige
deployment.error(y los que quieras) → pega la URL.
Conecta destinos en AlertHub. Si la fuente de verdad es el CI y no el host, usa GitHub Actions.
Alerta 1: Deploy fallido (la de las 2 de la madrugada)
Si payload.* llega vacío en tu cuenta, prueba {{deployment.url}} o {{type}} tras la primera entrega. El campo type del evento es un título de respaldo fiable: Vercel: {{type}}.
Alerta 2: Producción lista (solo info)
Crea un segundo webhook de Vercel para deployment.succeeded / deployment.ready con ah_level=info para que no pagine WhatsApp.
Alerta 3: Preview vs producción
Vercel envía preview y producción en el mismo flujo. Pon ah_level=critical solo en el webhook de producción, o filtra después en n8n si necesitas lógica de rama antes de AlertHub.
Otra opción: deja todos los eventos del host en info y que GitHub Actions if: failure() sea quien pagine.
Ideas para sacarle más partido
- Mismos destinos que Netlify. Las agencias con hosts mixtos usan un proyecto AlertHub y
ah_sourceVercelvsNetlify. - No pongas la URL de Slack en Vercel. Rota el chat en AlertHub.
- Enlaza la URL de inspect en la descripción cuando exista el placeholder para que la guardia salte al deploy fallido.
Preguntas frecuentes
¿Vercel admite un webhook GET con query string?
AlertHub acepta POST con cuerpo JSON y/o query (ah_key, ah_title, …). Configura el webhook HTTP de Vercel como POST a la URL generada.
¿Por qué es MDX?
Para copiar una URL viva del widget sin armar query strings a mano.
¿Puedo alertar desde vercel.json?
Los webhooks del host viven en el dashboard de Vercel. GitHub Actions sigue siendo la opción portable.
Siguientes pasos
Añade el webhook de error, conecta Telegram y fuerza un build roto. Compáralo con alertas de deploy Netlify.
Relacionado: fallos de GitHub Actions · constructor de webhooks