Hubungkan GitHub ke Notion
Simpan Pull Request bersama rencana proyek tim Anda di Notion.
Sinkronisasi GitHub terkelola membuat database Pull Request GitHub dari repositori yang Anda pilih. Notion mengimpor Pull Request yang ada dan memeriksa pembaruan di GitHub di latar belakang.
Panduan ini membahas Sinkronisasi database di pengaturan koneksi GitHub Anda. Properti yang disinkronkan bersifat baca-saja. Lakukan perubahan pada Pull Request di GitHub.
Catatan: Integrasi GitHub ini menggantikan versi lama kami. Agar data eksternal Anda tetap terkini, atur sinkronisasi baru Anda paling lambat 30 Oktober 2026. Database yang disinkronkan yang sudah ada akan tetap ada di Notion, tetapi akan berhenti diperbarui setelah tanggal tersebut.
Anda dapat menyinkronkan Pull Request dari beberapa repositori yang tersedia melalui instalasi GitHub App. Repositori yang dipilih akan masuk ke satu database Notion.
Informasi | Properti |
|---|---|
Pull Request | Judul, Nomor PR, URL GitHub, Repositori |
Negara Bagian | Status: Terbuka, Draf, Digabungkan, atau Ditutup |
Penulis | Penulis (GitHub), dan Penulis jika anggota Notion yang cocok dapat ditemukan |
Organisasi | Label, Cabang Dasar, Cabang Head |
Tanggal | Dibuat Pada, Diperbarui Pada, Ditutup Pada, Digabungkan Pada |
Properti Penulis (GitHub) berisi nama pengguna GitHub. Penulis adalah properti orang Notion jika email publik penulis yang tersedia cocok dengan anggota ruang kerja.
Properti Deskripsi menyinkronkan deskripsi Pull Request sebagai teks biasa, disalin persis seperti yang tertulis di GitHub. Deskripsi tidak dirender sebagai Markdown.
Sinkronisasi ini tidak menyertakan issue, komentar, penerima tugas, atau detail tinjauan GitHub.
Anda memerlukan:
Keanggotaan di ruang kerja Notion.
Akun GitHub dengan akses ke repositori yang ingin Anda sinkronkan.
Instalasi GitHub App dengan akses ke repositori tersebut.
Business plan (Mobile Business juga memenuhi syarat). Sinkronisasi GitHub tidak tersedia di paket lain.
Baik akun GitHub maupun instalasi aplikasi Anda memerlukan akses. Organisasi GitHub Anda mungkin mengharuskan pemilik untuk menyetujui atau menginstal aplikasi tersebut.
Di Notion, buka Settings → Koneksi → GitHub.
Buka Database sync dan hubungkan akun GitHub Anda jika Anda belum melakukannya.
Selesaikan langkah-langkah otorisasi dan instalasi GitHub.
Pilih organisasi atau akun yang repositorinya ingin Anda sinkronkan. Gunakan Add organization… jika Anda perlu menambahkan instalasi lain.
Pilih repositori yang akan disertakan.
Pilih semua riwayat yang tersedia atau jendela riwayat tertentu.
Pilih Buat sinkronisasi.
Notion membuat GitHub Pull Requests di bagian bilah sisi Private Anda dan mulai mengimpor Pull Request yang cocok.
Tips: Repositori tidak ditemukan? Gunakan Kelola akses di GitHub untuk memeriksa repositori mana yang dapat diakses oleh aplikasi. Jika penginstalan memerlukan persetujuan, mintalah pemilik organisasi GitHub untuk menyetujuinya.
Selama impor pertama, Notion membaca Pull Request dari setiap repositori yang dipilih, dimulai dengan catatan yang paling baru diperbarui dan terus berlanjut melalui riwayat yang dipilih.
Setelah impor, Notion secara berkala memeriksa setiap repositori untuk mencari Pull Request baru dan yang diperbarui. Perubahan seperti label baru, Pull Request yang ditutup, atau pembaruan penggabungan akan memperbarui properti yang sesuai di Notion.
Sinkronisasi tetap diproses meskipun Anda menutup Notion. Repositori besar, batas permintaan GitHub, dan masalah layanan sementara dapat menunda pembaruan. Periksa status sinkronisasi untuk melihat kemajuan atau kesalahan.
Pilih All history, Last 30 days, Last 90 days, atau Last 365 days. Saat sinkronisasi semua riwayat ditawarkan sebagai tombol alih, biarkan Sync all available history aktif untuk menyertakan semua Pull Request yang tersedia.
Jendela ini menggunakan waktu Updated At Pull Request. Ini tidak bergantung pada kapan Pull Request dibuat atau apakah Pull Request tersebut terbuka, ditutup, atau digabungkan.
Sebagai contoh, Pull Request terbuka yang belum berubah selama lebih dari 90 hari dapat berada di luar jendela 90 hari.
Tip: Halaman yang lebih lama dapat dihapus. Saat Pull Request berada di luar jendela yang dipilih, halamannya akan dihapus dari database yang disinkronkan, termasuk nilai dalam properti Notion Anda sendiri. Gunakan semua riwayat yang tersedia jika Anda perlu mempertahankan Pull Request yang tidak berubah.
Buka sinkronisasi di Settings → Koneksi → GitHub → sinkronisasi database.
Add repositories: Edit pilihan dan pilih Save changes. Notion mengimpor Pull Request yang cocok dari repositori yang ditambahkan.
Remove repositories: Batalkan pilihan dan simpan. Halaman Pull Request yang disinkronkan akan dihapus dari Notion.
Riwayat perubahan: Jendela yang lebih panjang mengimpor catatan tambahan. Jendela yang lebih pendek menghapus catatan di luar jendela baru.
Jeda pembaruan: Pilih Jeda sinkronisasi. Data dan pengaturan yang ada tetap ada.
Lanjutkan pembaruan: Pilih Lanjutkan sinkronisasi untuk melanjutkan sinkronisasi.
Sebelum menghapus repositori atau memperpendek riwayat, simpan informasi khusus Notion yang Anda perlukan dari halaman yang terpengaruh.
Buat tampilan berdasarkan repositori, status, penulis, atau label. Tambahkan properti Anda sendiri untuk melacak kesiapan rilis atau menghubungkan Pull Request dengan proses perencanaan tim Anda. Nilai properti Anda sendiri tetap ada di Notion.
Untuk mengubah properti GitHub, buka Pull Request menggunakan URL GitHub dan lakukan perubahan di GitHub.
Database dimulai sebagai pribadi. Jika Anda membagikannya, pengaturan berbagi Notion menentukan siapa yang dapat melihat data yang diimpor. Pemirsa tidak perlu memiliki akses ke repositori sumber masing-masing, jadi tinjau izin database sebelum membagikan informasi repositori pribadi.
Saya tidak dapat menemukan organisasi atau repositori
Periksa apakah Anda telah memilih akun GitHub dan instalasi aplikasi yang benar. Pastikan akun dan aplikasi Anda memiliki akses repositori. Jika organisasi membatasi instalasi aplikasi, minta pemilik untuk menyetujui akses.
Repositori diganti namanya atau dipindahkan
Buka pengaturan repositori sinkronisasi, tinjau pilihan repositori, dan simpan kembali. Jika repositori dipindahkan ke organisasi yang berbeda, pastikan koneksi memiliki akses di lokasi baru.
Properti Penulis kosong
Nama pengguna GitHub tidak selalu memiliki email publik yang tersedia yang cocok dengan anggota ruang kerja Notion. Gunakan Penulis (GitHub) untuk mengidentifikasi penulis saat properti orang kosong. Perubahan pada email atau keanggotaan ruang kerja penulis mungkin tidak menyegarkan pull request yang disinkronkan sebelumnya secara otomatis.
Pull Request hilang
Pastikan repositorinya dipilih, pembaruan terakhirnya berada dalam jendela riwayat, dan tampilan Notion Anda tidak memfilternya. Impor pertama mungkin masih berjalan.
Database berhenti memperbarui
Buka detail status sinkronisasi. Sambungkan kembali akun GitHub Anda atau pulihkan akses repositori jika diminta. Batas permintaan GitHub dan gangguan sementara dapat menunda pembaruan saat Notion mencoba kembali.
Untuk perbandingan dengan Workers dan panduan pemecahan masalah bersama, lihat Sinkronkan data dari alat lain ke Notion →
