GitHub Actions

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.

Push en <1sClave como secretoUn paso de curlActualizado el
Funciones

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.

Primeros pasos

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.

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.

FAQ

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.