# Haz que un workflow terminado haz vibrar tu teléfono.

> Recibe los resultados de GitHub Actions como notificaciones push. Añade un paso de Pocket Alert a tu workflow y entérate de los builds fallidos o los despliegues terminados en tu teléfono en menos de un segundo.

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

Última actualización: 2026-08-11

Pocket Alert envía los resultados de GitHub Actions a tu teléfono como notificaciones push. Añade un paso de curl a un workflow y, cuando termine un build, un despliegue o una release, el resultado llega a tu iPhone o Android en menos de un segundo, sin tener que mirar la pestaña Actions.

## Tres pasos para recibir alertas de GitHub Actions en tu teléfono

1. **Crea una aplicación** — Añade una aplicación en Pocket Alert y guarda tu clave de API como el secreto del repositorio POCKETALERT_API_KEY.
2. **Configura el paso** — Añade un paso de notificación que haga curl a la API de mensajes, usando if: failure() e if: success() para elegir los resultados.
3. **Mapea y envía** — Incluye repo, sha y workflow en el mensaje. La siguiente ejecución hará vibrar tu teléfono.

## De la ejecución del workflow a la pantalla de bloqueo

Tu workflow ya sabe cuándo termina un job. Pocket Alert convierte ese momento en una notificación push que no vas a pasar por alto.

- **Un paso en tu workflow** — Una sola llamada de curl a la API de mensajes convierte cualquier paso del workflow en una notificación push. Sin configurar runners ni servicios adicionales.
- **Clave como secreto del repo** — Lee tu clave de API desde ${{ secrets.POCKETALERT_API_KEY }} para que no aparezca en los logs y se rote desde el panel.
- **Alertas según los resultados que elijas** — Combina if: failure() e if: success() para enviar los builds fallidos y los despliegues correctos como mensajes separados y claramente etiquetados.
- **Un canal por repositorio** — Cada aplicación tiene su propio ID, así que las ejecuciones por repositorio y por entorno se mantienen en canales separados.
- **Entrega en menos de un segundo** — El paso se activa en cuanto termina el job, así que el resultado llega a tu teléfono en menos de un segundo.
- **Contexto completo de la ejecución** — Incluye github.repository, github.sha y github.workflow en el mensaje para saber exactamente qué ejecución fue.

## Envía alertas de GitHub Actions a tu teléfono

### 1. Crea una aplicación y guarda tu clave de API

Añade una aplicación en Pocket Alert y copia tu clave de API. Guárdala como secreto del repositorio llamado `POCKETALERT_API_KEY` en Settings → Secrets and variables → Actions.

### 2. Añade un paso de notificación que llame a la API de mensajes

```
- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'
```

### 3. Envía a una aplicación concreta

Añade `application_id` al cuerpo para enviar la notificación a una sola aplicación (encuentra el TID en el panel):

```
-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'
```

La [documentación de primeros pasos](https://info.pocketalert.app/getting-started.html) muestra todos los campos que acepta la API de mensajes.

## Preguntas frecuentes

### ¿Cómo recibo alertas de GitHub Actions en el teléfono?

Añade un paso que ejecute curl contra https://api.pocketalert.app/v1/messages con tu clave de API en la cabecera Token. Ponlo al final del job para que un despliegue terminado o un build fallido envíe una notificación directamente a tu teléfono.

### ¿Cómo mantengo la clave en secreto?

Guarda tu clave de API como secreto del repositorio y léela con ${{ secrets.POCKETALERT_API_KEY }}, enviada en la cabecera Token. La clave nunca aparece en los logs y puedes rotarla desde el panel de Pocket Alert.

### ¿Puedo recibir alertas solo cuando falla?

Usa if: failure() e if: success() en dos pasos separados. Un build fallido envía un mensaje, un despliegue correcto envía otro, así que puedes configurar solo los resultados que te interesan.

### ¿Puedo separar las alertas por repositorio?

Asigna a cada repositorio o entorno su propia aplicación. Los workflows de frontend, backend y release llegan a canales separados que puedes silenciar por separado.

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

Incluye en el cuerpo del mensaje el contexto de la ejecución, como ${{ github.repository }}, ${{ github.sha }} y ${{ github.workflow }}, para que la notificación te indique exactamente qué ejecución terminó.

### ¿Qué endpoint llama el paso?

El paso llama a https://api.pocketalert.app/v1/messages con una cabecera Token y un cuerpo JSON con title y message. Añade application_id para enviar la notificación a una aplicación concreta.

### ¿Puede un build fallido sonar más que uno correcto?

Añade "level":"high" al cuerpo del paso de fallo y la notificación atravesará el modo Concentración en iPhone y sonará de forma destacada en Android; "level":"critical" va más lejos y omite por completo No molestar. Las notificaciones de despliegues correctos pueden enviarse con "level":"silent" para que queden en tu historial sin vibrar.
