Lewati ke konten

Sinkronisasi Notion

Tautkan sebuah templat ke salah satu database Notion Anda, dan setiap pengiriman menjadi satu baris di sana — dibuat saat formulir dikirim, diperbarui saat dokumennya berubah setelah itu.

1 · Hubungkan ruang kerja Anda

Di Notion, buat sebuah integrasi internal (di notion.so/my-integrations — halaman Pengaturan Pocper menautkan ke sana) dan salin secret-nya (internal integration secret). Tempelkan di Pengaturan → Integrasi → Notion pada Pocper. Hanya pemilik tim yang bisa melakukan ini, dan secret itu disimpan terenkripsi. Untuk menggantinya, pakai Ganti token di halaman yang sama: secret baru diverifikasi dulu sebelum menggantikan yang lama.

Lalu bagikan database yang ingin Anda isi, atau halaman tempat database itu berada, ke integrasi itu: buka di Notion, pilih ••• → Connections → Add connections (di beberapa versi, Connections ada di bawah ••• → More), lalu pilih integrasi Anda. Tanpa langkah ini, database itu tidak muncul di daftar Pocper, dan tautan yang ditempelkan dilaporkan tidak ditemukan.

2 · Tautkan templat ke database

Buka panel Ruang kerja templat, pilih tab Integrasi, lalu tekan Tautkan database Notion. Pilih database yang bisa dilihat integrasi Anda (ketik untuk mencari) atau tempelkan tautannya. Baris pertama, Database baru, membuat database di dalam halaman yang Anda pilih, dengan satu kolom untuk tiap bidang yang sudah dipetakan, plus kolom Pocper ID.

Setiap bidang mendapat menu pilihan berisi kolom yang tipenya cocok: bidang tanggal ke kolom tanggal, kotak centang ke kotak centang, teks ke teks atau ke judul. Di bawah Detail kiriman, Anda juga bisa memetakan klien, waktu pengiriman, status, dan siapa yang mengirim.

Setiap dokumen yang dibuat dari templat menyalin pengaturan ini saat dibuat, dan tab Integrasi-nya sendiri bisa mengubahnya untuk dokumen itu saja. Perubahan templat sesudahnya hanya sampai ke dokumen baru; untuk dokumen lama yang masih mengikuti pengaturan sebelumnya, templat menawarkan Terapkan juga ke dokumen ini. Dokumen yang dibuat sebelum templat ditautkan menawarkan Pakai pengaturan templat.

3 · Apa yang terjadi saat dikirim

Saat sebuah formulir dikirim — oleh orang yang mengisinya, atau oleh Anda yang menandainya sebagai terkirim — sebuah baris dibuat dalam hitungan detik. Di bagian Sinkronisasi, tab Integrasi dokumen lalu menyebut kapan sinkronisasi terakhir beserta tautan ke barisnya, atau bahwa ada perubahan yang menunggu atau gagal dikirim; Sinkronkan sekarang hanya muncul bila pengiriman gagal atau dokumen belum pernah dikirim. Agar baris dibuat begitu dokumen ada, ubah "Waktu sinkronisasi" di pengaturan Integrasi templat.

Suntingan berikutnya memperbarui baris yang sama beberapa detik setelah perubahan terakhir, dan membatalkan dokumen memperbarui kolom statusnya.

Halaman baris itu mendapat bookmark kembali ke dokumen dan jawaban dalam bentuk daftar (yang sangat panjang dipendekkan, paling banyak seratus). Pengaturan Integrasi templat bisa mematikan isi halaman ini.

4 · Berkas, tanda tangan, dan duplikat

Berkas yang diunggah dan tanda tangan bisa masuk ke kolom Files & media: berkasnya disalin ke Notion, hingga 20 MB (yang lebih besar dilewati dan dicatat di log sinkronisasi). Mengirimnya sebagai tautan ke kolom URL adalah sakelar terpisah yang nonaktif secara bawaan, karena siapa pun yang bisa melihat baris itu bisa membuka tautan semacam itu tanpa masuk ke Pocper.

Pencegah duplikat menjaga pengiriman yang dicoba ulang agar tidak muncul dua kali: Pocper menulis Pocper ID tiap dokumen ke kolom teks bernama sama dan menemukan barisnya lewat itu. Database yang sudah punya kolom itu memakainya; bila belum, dialog penautan menambahkannya (kotaknya tercentang secara bawaan), atau bagian Pengaturan di tab Integrasi menambahkannya sekali klik.

5 · Perubahan yang dibuat di Notion

Nyalakan sinkronisasi balik di tab Integrasi, dan dua hal kembali dari Notion. Mengubah kolom status menjadi Submitted, Cancelled, atau Collected memindahkan dokumen ke status itu; menyunting sel yang dipetakan ke bidang teks, kotak centang, tanggal, atau waktu menulis nilainya ke dokumen, dan riwayat dokumen menampilkan suntingan itu sebagai berasal dari Notion. Jika kedua sisi mengubah sebuah sel, nilai Notion yang menang — kecuali selama klien masih mengisi formulir (belum dikirim, dan disimpan dalam sepuluh menit terakhir): nilainya dipertahankan, sel di Notion dikembalikan, dan tab Integrasi mencatatnya.

Sinkronisasi balik memerlukan webhook, yang disiapkan sekali per tim oleh pemilik di Pengaturan → Integrasi → Notion: buat URL webhook, tambahkan sebagai langganan di tab Webhooks integrasi Anda di Notion, lalu tempel kembali token verifikasi yang dikirim Notion. Pocper tidak pernah mem-polling Notion, jadi tanpa webhook suntingan di Notion tetap di sana. Kolom yang tidak bisa menerima nilai balik — tanda tangan, berkas, bidang apa pun dari dokumen yang terkunci — dikembalikan seperti semula di Notion, dan tab Integrasi mencatatnya.

6 · Saat ada yang tidak beres

Baris yang gagal dikirim dicoba ulang, dengan jeda yang makin panjang, selama sehari. Bila percobaannya habis, atau Notion menolaknya mentah-mentah — secret dicabut atau database tidak lagi dibagikan — sinkronisasi berhenti, dan pemilik tim serta orang yang menautkan database menerima notifikasi di aplikasi yang membuka tab Integrasi dokumen. Kesalahan di sana menyebut apa yang perlu dilakukan; pesan asli Notion ada di balik Tampilkan pesan Notion.

Sinkronisasi yang berhenti berjalan lagi dengan sendirinya setelah penyebabnya diperbaiki: saat Anda menghubungkan kembali atau mengganti token di Pengaturan, saat Pocper membaca database lagi (Muat ulang kolom dari Notion di samping judul Bidang, atau perubahan apa pun yang disimpan di tab Integrasi), atau saat dokumen disunting. Di templat, baris Log sinkronisasi menghitung kegagalan dan bisa menampilkan kegagalan saja, dan baris seperti "3 dokumen belum ada di Notion" punya tombol Kirim yang mengirim semuanya — menambahkan kolom Pocper ID dulu bila belum ada; buka baris itu untuk melihat dokumen mana dan sebabnya. Jeda sinkronisasi, di samping judul Sinkronisasi, menghentikan pengiriman perubahan sampai Anda menekan Lanjutkan sinkronisasi.