Haz que un workflow terminado haz vibrar tu teléfono.
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.
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.
Tres pasos para recibir alertas de GitHub Actions en tu teléfono
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.
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.
Mapea y envía
Incluye repo, sha y workflow en el mensaje. La siguiente ejecución hará vibrar tu teléfono.
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 muestra todos los campos que acepta la API de mensajes.
Preguntas y respuestas
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.
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.
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.
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.
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ó.
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.
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.
Sabe que el despliegue salió bien sin mirar la ejecución.
Crea una aplicación, copia tu clave de API y añade el paso de Pocket Alert a tu workflow.