Despliegues y CI/CD

En cuanto termina un despliegue.

Añade un paso de notificación a GitHub Actions, GitLab CI o Jenkins, o apunta un webhook de despliegue de Vercel o Netlify a Pocket Alert. El resultado llega a tu teléfono en menos de un segundo desde que termina la tarea, con el commit, la rama y el entorno incluidos.

Se activa con el estado de la tareaUn paso del pipelinewebhook de Vercel · NetlifyActualizado el
Funciones

Cada versión en tu teléfono

Cuando una versión falla en silencio, te enteras en segundos, mucho antes de que un usuario reporte la web rota.

Se integra en cualquier pipeline

GitHub Actions, GitLab CI, Jenkins y CircleCI necesitan cada uno un solo paso al final del pipeline.

Éxito o fallo

Envía en caso de éxito, de fallo o de ambos. Ejecuta el paso de notificación con if: failure() para recibir solo avisos de versiones rotas.

Contexto del despliegue

Incluye en el mensaje el commit, la rama, el entorno y la URL de la ejecución para saber exactamente qué se ha publicado.

Canales por entorno

Una aplicación distinta por entorno mantiene los despliegues de producción, staging y preview en canales separados.

Instantánea al terminar

La notificación llega cuando termina la tarea, así que puedes cerrar la pestaña del pipeline.

Sin configuración

Una llamada a la CLI o a curl en tu tarea. No hay ningún bot de Slack que instalar.

Primeros pasos

Tres pasos para alertas de despliegue

1

Obtén la clave o la URL del webhook

Crea una clave de API para una llamada con la CLI o con curl, o un webhook, y copia su URL de recepción.

2

Añade un paso o un webhook

Añade un paso de notificación a tu pipeline o pega la URL de recepción en las notificaciones de despliegue de Vercel o Netlify.

3

Publica con confianza

Publica una versión y tu teléfono vibrará con el resultado, el commit y el entorno.

Notifica cada despliegue

1. Pipeline de CI/CD (CLI o curl)

Añade un paso al final de tu tarea de GitHub Actions, GitLab CI, Jenkins o CircleCI. Con la CLI:

pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"

O llama directamente a la API de mensajes con curl para no tener que instalar nada en el runner:

curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Deploy succeeded","message":"prod @ v2.4.0","level":"silent"}'

2. Vercel o Netlify (webhook)

Crea un webhook para que Vercel o Netlify envíen su propio payload de despliegue a Pocket Alert. El campo message es una plantilla GJSON que asigna sus campos a la notificación push:

curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Vercel deploy","message":"%type%: %payload.project.name% on %payload.deployment.target%","application_id":"qm47b9pzxzxg"}'

Obtendrás una URL de recepción como https://p4a.me/wh/1234abcd. Pégala en la configuración de webhooks de Vercel (eventos como deployment.succeeded). En Netlify, añádela como webhook saliente de notificaciones de despliegue y asigna sus campos, por ejemplo %name% is %state% on %branch%.

La documentación de configuración de webhooks explica la API de mensajes y la asignación de campos con GJSON.

FAQ

Preguntas y respuestas

Añade un paso de notificación al final de tu pipeline en GitHub Actions, GitLab CI, Jenkins o CircleCI. Ejecuta la CLI de Pocket Alert o una llamada con curl, y el resultado del despliegue llegará como notificación push en cuanto termine la tarea.

Sí. Usa el estado de la tarea para enviar un mensaje de éxito o de fallo, y ejecuta el paso de notificación solo con if: failure() para que el aviso que recibas sea el de una versión rota.

Incluye el commit, la rama, el entorno y la URL del pipeline en el cuerpo del mensaje. La alerta te dirá qué se ha publicado y dónde, y enlazará directamente con la ejecución.

Funciona cualquier herramienta que ejecute comandos: GitHub Actions, GitLab CI, Jenkins, CircleCI, Bitbucket Pipelines o un script de despliegue sencillo. Para Vercel y Netlify, crea un webhook de Pocket Alert y pega su URL de recepción en la configuración de notificaciones de despliegue.

Crea una aplicación distinta para cada entorno: producción, staging y preview. Así, los despliegues de producción llegan a su propio canal y distingues las versiones de un vistazo.

Sí. Envía los despliegues fallidos con level=critical: en Android se publican en un canal específico que omite No molestar, y en iPhone aparecen como notificaciones sensibles al tiempo que atraviesan Concentración. Los avisos rutinarios de éxito pueden enviarse con level=silent, de modo que quedan en el historial sin vibrar.

Entérate de cómo ha salido cada versión.

Añade un paso a tu pipeline y el resultado de cada versión llega a tu teléfono en cuanto se publica.