Integrasi GitHub - Peringatan Peristiwa Repo & CI/CD

GitHub adalah platform kontrol versi dan kolaborasi terdepan di dunia, dipakai jutaan pengembang. Panduan ini menunjukkan cara mengintegrasikan webhook GitHub dengan Echobell untuk menerima notifikasi instan atas peristiwa di repositori — mulai dari pull request dan commit hingga rilis dan workflow run.

Prasyarat

1. Akun Echobell dengan saluran yang aktif
2. Akses admin ke repositori GitHub yang ingin Anda pantau
3. URL webhook Echobell Anda (ada di tampilan detail saluran)

Menyiapkan Webhook GitHub

1. Buat Saluran Echobell

1. Buka aplikasi Echobell
2. Buat saluran baru (misalnya, "GitHub Notifications")
3. Atur templat notifikasi:

Templat Judul:

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

Templat Isi:

🔔 Event: {{action}}
👤 Actor: {{sender.login}}
📦 Repository: {{repository.full_name}}

2. Ambil URL Webhook Anda

1. Di pengaturan saluran Anda, cari bagian Pemicu (Triggers)
2. Salin URL webhook yang tersedia
3. Jaga kerahasiaan URL ini karena akan dipakai di konfigurasi GitHub

3. Konfigurasikan Webhook GitHub

1. Buka repositori GitHub Anda
2. Masuk ke Settings → Webhooks
3. Klik Add webhook
4. Atur webhook-nya:
   • Payload URL: URL webhook Echobell Anda
   • Content type: application/json
   • Secret: (Opsional) Tambahkan token rahasia untuk keamanan ekstra
   • Aktifkan verifikasi SSL
5. Pilih peristiwa mana yang akan memicu webhook:
   • Pilih "Let me select individual events"
   • Pilihan yang umum antara lain:
     • Pull requests
     • Push events
     • Issues
     • Discussions
     • Releases
6. Klik Add webhook untuk menyimpan

Menguji Integrasi Anda

1. Setelah webhook disiapkan, GitHub akan mengirim peristiwa ping
2. Periksa notifikasi Echobell Anda untuk memastikan pesannya sampai
3. Buat issue atau pull request percobaan untuk memverifikasi integrasinya

Praktik Terbaik

1. Keamanan:
   • Jaga kerahasiaan URL webhook Anda
   • Gunakan secret webhook agar permintaannya terverifikasi
   • Aktifkan verifikasi SSL
2. Pemilihan Peristiwa:
   • Berlangganan hanya peristiwa yang Anda perlukan
   • Pertimbangkan ukuran dan tingkat aktivitas repositori saat memilih peristiwa
3. Penanganan Kesalahan:
   • Pantau status pengiriman webhook di GitHub
   • Periksa riwayat notifikasi Echobell untuk memastikan pengirimannya berhasil

Pemecahan Masalah

Jika Anda tidak menerima notifikasi:

1. Pastikan URL webhook-nya benar
2. Periksa riwayat pengiriman webhook GitHub untuk melihat kesalahan
3. Pastikan saluran Echobell Anda aktif
4. Pastikan saluran Anda punya pelanggan yang aktif
5. Periksa apakah peristiwa yang dipilih memang terpicu

Privasi dan Keamanan

• URL webhook harus diperlakukan sebagai rahasia
• Kirim hanya data peristiwa yang diperlukan
• Semua isi notifikasi disimpan secara lokal di perangkat pelanggan
• Server kami hanya memproses permintaan webhook dan meneruskan notifikasi

Butuh bantuan? Kunjungi Pusat Dukungan kami atau hubungi kami di echobell@weelone.com.