Send Telegram messages when GitHub Actions jobs fail.

This action allows your CI/CD workflow to notify your team instantly on Telegram if a job fails, including default GitHub context like repository, branch, commit, and actor.

• Sends Telegram messages on job failure (failure() condition)
• Prepend default GitHub context to all messages:
  • Repository
  • Branch
  • Commit
  • Actor
• Fully customizable message body (supports <b> and <i> HTML formatting)
• Configurable retry count and retry delay
• Supports HTML or Markdown parse modes

Note: Telegram Bot must be added to your group/channel. Channels usually require the bot to be an admin.

name: CI/CD Pipeline on: push: branches: [main] jobs: deploy: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Build & Deploy run: |  echo "Building app..."  ./deploy.sh # This may fail   - name: Notify Telegram on Failure if: failure() uses: devlopersabbir/telegram-action-notifier@v1.0.1 with: bot_token: ${{ secrets.TELEGRAM_BOT_TOKEN }} chat_id: ${{ secrets.TELEGRAM_CHAT_ID }} message: |  <b>🚨 Deployment Failed!</b>  Please check logs immediately.  retry_count: 3 retry_delay: 3 parse_mode: HTML

🚨 Deployment Failed! Please check logs immediately. Actor: sabbir Branch: main Commit: a1b2c3d Repository: my-org/my-app

• User message appears on top

• GitHub context is always appended automatically

• Never hardcode secrets in your workflow.
• Use GitHub Secrets:
  • TELEGRAM_BOT_TOKEN
  • TELEGRAM_CHAT_ID

• Use if: failure() to send messages only when jobs fail
• Use always() for cleanup steps, if needed
• Use HTML formatting for rich messages (<b>, <i>, <a> links)
• Limit message length (~4096 characters) to avoid Telegram API errors

Sabbir Hossain Shuvo