Panduan Post Metabox: Guest Integrations: BukuTamu Pro Deep Integration

Sub-Section BukuTamu Pro Deep Integration pada metabox RSVPKit adalah jembatan sinkronisasi langsung dengan platform manajemen tamu fisik pro.bukutamu.net melalui Event ID resmi, mengaktifkan pengisian nama otomatis (auto-prefill) berbasis token URL, penguncian identitas tamu (Readonly Lock), serta hierarki prioritas kuota tertinggi (Pax Gating Priority #1).


Memahami Kebutuhan Sinkronisasi Meja Penerima Tamu

Dalam resepsi pernikahan berskala besar, koordinasi antara tim undangan digital dan tim buku tamu fisik di lokasi acara (on-site greeting team) sering kali mengalami kesenjangan data. Tamu yang telah mengonfirmasi kehadiran di website kerap tidak terdata pada aplikasi scanner meja registrasi, atau sebaliknya, kuota pendamping yang dibawa tamu melebihi kursi yang dialokasikan di denah ruangan.

Kesenjangan data ini memicu antrean panjang yang mengular di pintu masuk gedung resepsi, perdebatan dengan petugas penerima tamu, serta ketidaknyamanan keluarga besar pengantin. Calon pengantin menginginkan satu ekosistem terpadu di mana konfirmasi di website undangan langsung terhubung detik itu juga dengan sistem check-in scanner di lokasi resepsi.

WDP RSVPKit memecahkan masalah ini melalui BukuTamu Pro Deep Integration. Dengan menghubungkan Event ID dari platform pro.bukutamu.net, seluruh data tamu, nomor meja, hingga tiket QR Code tersinkronisasi secara otomatis tanpa perlu ekspor-impor berkas manual.


Prasyarat Sebelum Konfigurasi

Pastikan hal-hal berikut telah siap sebelum mengaktifkan integrasi:

  1. Akun BukuTamu Pro Aktif: Memiliki acara aktif yang telah didaftarkan pada dasbor pro.bukutamu.net.
  2. Event ID Terverifikasi: Dapatkan kode unik Event ID dari panel acara BukuTamu Pro Anda.
  3. Format Tautan Undangan Personal: Pastikan tautan sebar undangan menggunakan struktur parameter pengenal token tamu resmi.

Tata Letak Antarmuka WDP RSVPKit BukuTamu Pro Deep Integration dengan Verifikasi Event ID dan Pax Gating Priority
Tata Letak Antarmuka WDP RSVPKit BukuTamu Pro Deep Integration dengan Verifikasi Event ID dan Pax Gating Priority

Bedah Mendalam Fitur BukuTamu Pro Deep Integration

Untuk mengonfigurasi fitur ini, buka editor postingan undangan di WP Admin, lalu navigasikan ke sub-tab Guest Integrations dan temukan bagian BukuTamu Pro Deep Integration:

1. Saklar Aktivasi & Verifikasi Event ID

Langkah pertama untuk menghubungkan website dengan server cloud BukuTamu Pro:

  • Enable BukuTamu Pro Integration: Toggle master untuk mengaktifkan pemrosesan data berbasis token BukuTamu Pro.
  • BukuTamu Pro Event ID / Event URL: Masukkan kode unik acara (contoh: evt_live_andy_zhea_royal_2026) atau tempelkan URL dasbor acara Anda.
  • Tombol Verify Event ID: Menguji komunikasi API antara server hosting WordPress dan server cloud BukuTamu Pro. Jika sukses, label hijau Event Valid (Active) akan muncul.

2. Mekanisme Token Resolution & Auto-Prefill Data

Ketika tamu membuka tautan undangan personal yang memuat token unik (?to=Bambang+Soediro&token=bt_98a7c):

  • Sistem secara otomatis menguraikan (resolve) token tersebut ke basis data cloud BukuTamu Pro dalam hitungan milidetik.
  • Kolom Nama Tamu, Nomor Telepon, dan Alokasi Meja langsung terisi secara otomatis (auto-prefill) di layar formulir tanpa perlu diketik manual oleh tamu.

3. Readonly Name Lock (Penguncian Identitas)

Untuk mencegah tamu iseng mengganti nama resmi undangan menjadi nama lain atau julukan yang tidak pantas, fitur ini secara otomatis mengunci kolom nama menjadi mode hanya-baca (readonly). Tamu hanya berfokus memilih status kehadiran dan menuliskan doa restu.

4. Pemberlakuan Pax Gating Priority #1

WDP RSVPKit menerapkan aturan hierarki validasi kuota yang sangat ketat:

  • Kuota pax yang ditetapkan di BukuTamu Pro secara mutlak mengungguli (override) kuota dari Google Sheets maupun nilai default metabox.
  • Jika di sistem BukuTamu Pro tamu dialokasikan 2 Pax, tamu tidak akan dapat memilih lebih dari 2 orang, menjamin kapasitas kursi di lokasi acara selalu aman terkendali.

5. Injeksi Otomatis E-Tiket QR Code

Begitu tamu terverifikasi menekan tombol konfirmasi kehadiran:

  • Sistem menghasilkan e-tiket QR Code unik yang terdaftar pada sistem scanner resepsionis.
  • QR Code ini langsung ditampilkan di layar konfirmasi dan disematkan pada pesan balasan WhatsApp otomatis tamu.

Tabel Parameter Post Meta BukuTamu Pro

Nama Opsi MetaboxKunci Post Meta WordPressNilai ContohPenjelasan Fungsi
Enable BukuTamu_rsvpkit_bukutamu_activeyes / noSaklar penghubung ke cloud BukuTamu Pro
Event ID_rsvpkit_bukutamu_event_idevt_live_xxxxKode unik acara pada pro.bukutamu.net
Readonly Lock_rsvpkit_bukutamu_lock_nameyes / noMengunci kolom nama dari perubahan manual
Auto Inject QR_rsvpkit_bukutamu_inject_qryes / noMenyisipkan tiket QR Code saat status hadir
Priority Level_rsvpkit_pax_prioritybukutamu_firstMemprioritaskan kuota pax BukuTamu Pro

Skenario Praktik Lapangan: Andy & Zhea

Vendor pernikahan Andy & Zhea mengelola resepsi mewah di ballroom hotel bintang lima dengan 800 undangan resmi dan 6 meja penerima tamu berteknologi scanner barcode:

  1. Sinkronisasi Event: Vendor menautkan Event ID evt_live_andy_zhea_royal_2026 di metabox undangan Andy & Zhea dan mengaktifkan Readonly Name Lock.
  2. Penyebaran Undangan Ber-Token: Tim WO menyebarkan tautan berformat khusus kepada seluruh tamu VIP keluarga besar.
  3. Pengalaman Tamu: Saat tamu VIP membuka undangan, nama mereka langsung muncul lengkap beserta jatah 3 kursi keluarga. Tamu memilih Hadir dan seketika mendapatkan e-tiket QR Code di layar ponsel mereka.
  4. Hari-H di Meja Penerima Tamu: Di lokasi resepsi, tamu cukup mengarahkan layar ponsel ke scanner kamera resepsionis. Check-in sukses dalam waktu 1 detik, printer mencetak label nomor meja secara otomatis, dan tamu dipersilakan masuk tanpa antrean.

Tips & Praktik Terbaik Integrasi BukuTamu Pro

  • Lakukan Uji Coba Token Sebelum Sebar Massal: Buat minimal 3 data tamu uji coba di dasbor BukuTamu Pro untuk menguji alur pengisian dari link ber-token hingga pemindaian scanner check-in.
  • Kombinasikan dengan Smart WA Tamu: Gunakan tag [qr_url] pada template WhatsApp tamu hadir agar tamu menyimpan salinan tiket QR Code langsung di aplikasi chat mereka.
  • Pantau Konektivitas Internet Lokasi: Pastikan perangkat laptop atau tablet resepsionis di lokasi acara memiliki koneksi internet yang stabil untuk kelancaran sinkronisasi data check-in secara real-time.

Pertanyaan yang Sering Diajukan (FAQ)

Di mana saya bisa menemukan Event ID BukuTamu Pro? +
Event ID dapat dilihat pada bagian akhir tautan URL acara di dasbor admin pro.bukutamu.net atau pada menu Pengaturan Event.
Apakah nama tamu yang di-prefill secara otomatis dapat diubah oleh tamu? +
Tidak bisa jika Anda mengaktifkan fitur 'Readonly Name Lock'. Fitur ini mengunci kolom nama agar tamu tidak dapat mengganti identitas resmi undangan mereka.
Apa yang dimaksud dengan Pax Gating Priority #1 pada integrasi BukuTamu Pro? +
Artinya alokasi kuota pax yang ditentukan di sistem cloud BukuTamu Pro akan mengesampingkan (override) pengaturan kuota lainnya, menjamin sinkronisasi mutlak dengan buku tamu fisik di meja resepsi.
Bagaimana cara kerja token tamu saat membuka tautan undangan? +
Sistem mendeteksi parameter token unik pada URL undangan (contoh: ?to=Nama&token=bt_xxx) lalu mencocokkannya ke basis data BukuTamu Pro secara asinkron.
Apakah integrasi ini otomatis memunculkan e-tiket QR Code untuk tamu hadir? +
Ya. Setiap tamu terverifikasi yang memilih status hadir akan langsung menerima e-tiket QR Code pada kartu konfirmasi untuk dipindai oleh scanner petugas penerima tamu di lokasi acara.