Hubungkan GitHub ke Notion
Simpan Pull Request bersama rencana proyek tim Anda di Notion.
Sinkronisasi GitHub terkelola membawa pekerjaan GitHub yang Anda pilih ke dalam Notion: Pull Request, Issue, atau keduanya. Notion mengimpor catatan Anda yang sudah 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 dan Issue 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.
Jika Anda menggunakan sinkronisasi lama untuk membawa Issue, Anda juga dapat menyinkronkan Issue dengan versi ini.
Pilih apa yang akan dibawa ke Notion dari repositori yang tersedia melalui instalasi Aplikasi GitHub: Pull Request, Issue, atau keduanya. Repositori yang Anda pilih akan masuk ke 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.
Anda dapat menyinkronkan Issue GitHub secara mandiri atau bersamaan dengan Pull Request. Sinkronisasi ini tidak menyertakan komentar Pull Request atau detail tinjauan.
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.
Beri nama sinkronisasi Anda dan pilih apa yang akan dibawa ke Notion: Pull Request, Issue, atau keduanya.
Pilih semua riwayat yang tersedia atau jendela riwayat tertentu.
Pilih Buat sinkronisasi.
Notion membuat database yang disinkronkan di bagian bilah sisi Pribadi Anda dan mulai mengimpor catatan 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 dan Issue yang Anda pilih 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 catatan baru dan yang diperbarui. Perubahan seperti label baru, Pull Request yang ditutup, atau Issue yang dibuka kembali akan memperbarui properti yang cocok 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 atau Issue 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.
Tambahkan atau hapus Issue atau Pull Request: Ubah apa yang dibawa oleh sinkronisasi dan pilih Simpan perubahan. Menambahkan tipe akan mengimpor catatan yang cocok. Menghapus tipe akan menghapus halaman tersebut. Catatan yang sudah Anda impor untuk tipe yang Anda pertahankan akan tetap ada.
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 dan Issue dengan proses perencanaan tim Anda. Nilai properti Anda sendiri tetap ada di Notion.
Untuk mengubah properti GitHub, buka catatan 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.
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.
Buka pengaturan repositori sinkronisasi, tinjau pilihan repositori, dan simpan kembali. Jika repositori dipindahkan ke organisasi yang berbeda, pastikan koneksi memiliki akses di lokasi baru.
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.
Pastikan tipenya disertakan dalam sinkronisasi, repositorinya dipilih, pembaruan terakhirnya berada dalam jendela riwayat, dan tampilan Notion Anda tidak memfilternya. Impor pertama mungkin masih berjalan.
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 →
