Echobell
App Store Google Play

Integrazione GitHub - Eventi del repository e avvisi CI/CD

Configura i webhook di GitHub con Echobell e ricevi avvisi istantanei sul telefono per pull request, issue, release e workflow CI/CD falliti.

GitHub è la principale piattaforma al mondo per il controllo di versione e la collaborazione, usata da milioni di sviluppatori. In questa guida vedrai come integrare i webhook di GitHub con Echobell per ricevere notifiche istantanee sugli eventi dei tuoi repository - dalle pull request e dai commit fino alle release e alle esecuzioni dei workflow.

Se ti servono notifiche istantanee da GitHub Actions, puoi usare la Echobell Notification Action per inviare notifiche direttamente da GitHub Actions.

Prerequisiti

  1. Un account Echobell con un canale attivo
  2. Accesso da amministratore al repository GitHub che vuoi monitorare
  3. L'URL del webhook di Echobell (lo trovi nella schermata dei dettagli del canale)

Configurare i webhook di GitHub

1. Crea un canale Echobell

  1. Apri l'app Echobell
  2. Crea un nuovo canale (ad esempio "Notifiche GitHub")
  3. Configura i modelli di notifica:

Modello del titolo:

[{{repository.name}}] {{action}} di {{sender.login}}

Modello del corpo:

🔔 Evento: {{action}}
👤 Autore: {{sender.login}}
📦 Repository: {{repository.full_name}}

2. Recupera l'URL del webhook

  1. Nelle impostazioni del canale, individua la sezione Trigger
  2. Copia l'URL del webhook che trovi lì
  3. Conserva questo URL in modo sicuro, perché lo userai nella configurazione di GitHub

3. Configura il webhook su GitHub

Screenshot delle impostazioni dei webhook su GitHub

  1. Vai al tuo repository GitHub
  2. Apri Settings → Webhooks
  3. Fai clic su Add webhook
  4. Configura il webhook:
    • Payload URL: l'URL del webhook di Echobell
    • Content type: application/json
    • Secret: (facoltativo) aggiungi un token segreto per maggiore sicurezza
    • Attiva la verifica SSL
  5. Scegli quali eventi devono attivare il webhook:
    • Seleziona "Let me select individual events"
    • Le scelte più comuni sono:
      • Pull request
      • Eventi push
      • Issue
      • Discussioni
      • Release
  6. Fai clic su Add webhook per salvare

Testare l'integrazione

  1. Subito dopo la configurazione, GitHub invia un evento ping
  2. Controlla le notifiche di Echobell per verificare che sia arrivato
  3. Crea una issue o una pull request di prova per confermare che tutto funzioni

Buone pratiche

  1. Sicurezza:
    • Tieni riservato l'URL del webhook
    • Usa un secret del webhook per verificare le richieste
    • Attiva la verifica SSL
  2. Scelta degli eventi:
    • Iscriviti solo agli eventi che ti servono davvero
    • Tieni conto delle dimensioni e dell'attività del repository quando scegli gli eventi
  3. Gestione degli errori:
    • Controlla su GitHub lo stato di consegna dei webhook
    • Verifica nella cronologia delle notifiche di Echobell che la consegna sia andata a buon fine

Risoluzione dei problemi

Se non ricevi le notifiche:

  1. Verifica che l'URL del webhook sia corretto
  2. Controlla su GitHub la cronologia di consegna dei webhook per individuare eventuali errori
  3. Assicurati che il canale Echobell sia attivo
  4. Verifica di avere iscritti attivi nel canale
  5. Controlla se gli eventi selezionati vengono effettivamente attivati

Privacy e sicurezza

  • Gli URL dei webhook vanno trattati come segreti
  • Invia solo i dati degli eventi strettamente necessari
  • Tutto il contenuto delle notifiche viene memorizzato localmente sui dispositivi degli iscritti
  • I nostri server si limitano a elaborare la richiesta webhook e a instradare le notifiche

Ti serve aiuto? Visita il nostro Centro assistenza o scrivici a echobell@weelone.com.