Nunca mais perca uma falha do GitHub Actions: alertas instantâneos com o Echobell

Sumário

• Configuração
• 1. Criar um canal no Echobell
• 2. Adicionar ao seu workflow
• Dicas
• Relacionados

Notificações por e-mail e pelo Slack sobre falhas de CI passam despercebidas com facilidade. A Echobell Notification Action envia alertas webhook direto para o seu celular — notificações push para builds normais, chamadas telefônicas para falhas em produção — para que pipelines quebrados não passem batido.

Configuração

1. Criar um canal no Echobell

1. Baixe o Echobell / Google Play e faça login
2. Crie um canal com um nome como "GitHub CI/CD Alerts"
3. Copie a URL do webhook nas configurações do canal
4. No seu repositório do GitHub: Settings → Secrets and variables → Actions → New repository secret
5. Dê a ele o nome ECHOBELL_WEBHOOK_URL e cole a URL

2. Adicionar ao seu workflow

Configuração básica (workflows de um único job):

name: Build and Test

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Build
        run: npm run build

      - name: Test
        run: npm test

      - name: Notify on Failure
        if: failure()
        uses: weelone/echobell-action@v1
        with:
          webhook-url: ${{ secrets.ECHOBELL_WEBHOOK_URL }}

Pipelines com vários jobs — use um job de notificação dedicado que dependa de todos os jobs críticos:

name: Deploy Pipeline

on:
  push:
    branches: [main]

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

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

  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Deploy
        run: npm run deploy

  notify_on_failure:
    runs-on: ubuntu-latest
    needs: [test, build, deploy]
    if: failure()
    steps:
      - name: Send Failure Notification
        uses: weelone/echobell-action@v1
        with:
          webhook-url: ${{ secrets.ECHOBELL_WEBHOOK_URL }}

O job de notificação dedicado entrega um único alerta consolidado para falhas em cascata, em vez de várias notificações separadas.

Dicas

Os títulos das notificações devem responder: o que falhou, onde e quando. Use padrões como ❌ Main Branch CI Failed ou 🚨 Deploy Pipeline Down - Production.

Use canais separados por severidade. Mantenha um canal padrão para alertas normais de CI e um segundo canal configurado como Chamada para falhas em produção. Aponte workflows diferentes para URLs de webhook diferentes. Veja notificações em chamada para mais detalhes.

Compartilhe canais com seu time. Crie um canal para falhas de CI/CD que todo o time deve acompanhar e outro separado para problemas restritos à infraestrutura. Os canais compartilhados do Echobell permitem que colegas de time se inscrevam com suas próprias preferências de notificação — sem que cada um precise configurar webhooks individualmente.

Relacionados

• Documentação de webhook — referência completa da API de webhook
• Modelos e Condições — personalize o conteúdo e a filtragem das notificações
• Notificações em chamada do Grafana — alertas por chamada telefônica para sistemas de monitoramento
• Notificações do WebhookMCP — alertas para a conclusão de tarefas de IA
• Documentação de recursos: Canais, Webhooks, Gatilhos por e-mail, Notificações em chamada