---
title: "Nunca mais perca uma falha do GitHub Actions: alertas instantâneos com o Echobell"
description: "Configure notificações webhook instantâneas para falhas do GitHub Actions usando o Echobell. Mantenha seu pipeline de CI/CD sempre visível com alertas push ou chamadas telefônicas entregues em segundos."
date: 2025-04-26
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Echobell
  - GitHub Actions
  - CI/CD
  - notificações webhook
  - alertas para desenvolvedores
---

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

Notificações por e-mail e pelo Slack sobre falhas de CI passam despercebidas com facilidade. A [Echobell Notification Action](https://github.com/weelone/echobell-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](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-github-actions-notifications-pt&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid) 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):

```yaml
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:

```yaml
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](/pt/blog/grafana-call-notification) 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](/pt/features/channels) 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](/pt/docs/webhook) — referência completa da API de webhook
- [Modelos](/pt/docs/template) e [Condições](/pt/docs/conditions) — personalize o conteúdo e a filtragem das notificações
- [Notificações em chamada do Grafana](/pt/blog/grafana-call-notification) — alertas por chamada telefônica para sistemas de monitoramento
- [Notificações do WebhookMCP](/pt/blog/get-notified-with-webhook-mcp) — alertas para a conclusão de tarefas de IA
- Documentação de recursos: [Canais](/pt/features/channels), [Webhooks](/pt/features/webhooks), [Gatilhos por e-mail](/pt/features/email-triggers), [Notificações em chamada](/pt/features/call-notifications)