Skip to content

Send Push Notifications from GitHub Actions

ci-cdgithub-actionstutorial

CI/CD pipelines fail silently. You find out 20 minutes later when you check the GitHub tab. Deployments succeed and nobody notices. Approval requests sit in a queue until someone refreshes the page.

BotBell's GitHub Action sends push notifications straight to your phone for any workflow event -- build failures, successful deploys, or manual approvals.

Step 1: Get Your Bot Token

Create a bot at botbell.app and copy the Bot Token. Add it as a repository secret named BOTBELL_TOKEN.

Step 2: Add the Action to Your Workflow

Build Notifications

name: CI
on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

      - name: Notify on failure
        if: failure()
        uses: qq418716640/botbell-github-action@v1
        with:
          token: ${{ secrets.BOTBELL_TOKEN }}
          title: "Build Failed"
          message: "${{ github.repository }} build failed on ${{ github.ref_name }}"

      - name: Notify on success
        if: success()
        uses: qq418716640/botbell-github-action@v1
        with:
          token: ${{ secrets.BOTBELL_TOKEN }}
          title: "Build Passed"
          message: "All tests passed on ${{ github.ref_name }}"

Deployment Approval

- name: Request approval
  uses: qq418716640/botbell-github-action@v1
  with:
    token: ${{ secrets.BOTBELL_TOKEN }}
    title: "Deploy to Production?"
    message: "Commit ${{ github.sha }} is ready to deploy"
    wait_for_reply: true
    actions: '[{"label":"Approve","action":"approve"},{"label":"Reject","action":"reject"}]'

The workflow pauses until you tap a button on your phone. No browser needed.

Step 3: Install the App

Download BotBell from the App Store to receive notifications on your iPhone, iPad, or Mac.

What's Next?

← Blog