# En cuanto termina un despliegue.

> Recibe una notificación push cuando un despliegue termine bien o falle. Añade un paso a GitHub Actions, GitLab CI o Jenkins y los resultados llegan a tu teléfono en segundos.

<!-- source: https://pocketalert.app/es/use-cases/deployment-alerts -->

Última actualización: 2026-08-11

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.

## 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.

## 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.

## 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](https://info.pocketalert.app/api/webhooks/settings.html) explica la API de mensajes y la asignación de campos con GJSON.

## Preguntas frecuentes

### ¿Cómo recibo notificaciones de despliegue?

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.

### ¿Puedo recibir alertas solo de despliegues fallidos?

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.

### ¿Puedo incluir el commit y el entorno?

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.

### ¿Qué herramientas de CI/CD son compatibles?

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.

### ¿Puedo separar las alertas de producción y de staging?

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.

### ¿Un despliegue fallido en producción puede saltarse No molestar?

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.
