Panduan Post Metabox: Guest Integrations: Webhook 2-Way Sync & REST API Feed
Sub-Section Webhook 2-Way Sync & REST API Feed pada metabox RSVPKit adalah fasilitas integrasi pengembang yang memungkinkan pengiriman data konfirmasi secara instan ke endpoint eksternal (Google Apps Script, Zapier, Make, n8n) dengan perlindungan Secret Passkey Token, serta menyediakan saluran data terstruktur (REST API JSON Feed) untuk monitor layar panggung resepsi.
Memahami Kebutuhan Otomatisasi & Penayangan Layar Panggung
Di era pernikahan serba digital, kebutuhan integrasi data tidak lagi terbatas pada pencatatan di spreadsheet. Vendor dan calon pengantin menginginkan otomatisasi alur kerja yang lebih kaya: mengirimkan notifikasi ke grup Telegram panitia keluarga, mencatat data ke CRM database pengantin, hingga menampilkan ucapan selamat dari para tamu secara langsung (live streaming feed) pada layar LED videotron panggung pelaminan.
Membangun koneksi integrasi manual yang rumit sering kali menghabiskan banyak waktu dan rentan terhadap kebocoran data sensitif para tamu undangan. Tanpa filter otentikasi yang kuat, endpoint data dapat disusupi pihak luar atau memunculkan data privat seperti nomor telepon pribadi ke layar monitor publik.
WDP RSVPKit mengatasi tantangan integrasi modern ini melalui sub-tab Webhook & REST API Feed. Anda dapat menghubungkan website undangan ke ratusan platform otomatisasi cloud sekaligus menyajikan feed doa restu yang steril dan aman untuk monitor resepsi.
Prasyarat Sebelum Konfigurasi
Pastikan hal-hal berikut telah siap sebelum mengatur webhook:
- Endpoint Webhook Tujuan: Siapkan URL Web App Google Apps Script, Webhook URL Zapier, atau webhook listener n8n Anda.
- Editor Postingan Terbuka: Buka lembar kerja postingan undangan Anda di WP Admin.
- Kebutuhan Layar Resepsi: Tentukan apakah acara resepsi pengantin menggunakan layar monitor interaktif untuk penayangan doa tamu.
Bedah Mendalam Fitur Webhook & REST API Feed
Untuk mengakses modul ini, buka postingan undangan di WP Admin, lalu navigasikan ke sub-tab Guest Integrations dan temukan bagian Webhook & REST API Feed:
1. Apps Script Webhook URL (Realtime Outgoing Sync)
Mengatur alamat tujuan pengiriman data saat formulir berhasil diserahkan:
- Webhook URL Field: Tempelkan URL lengkap tujuan pengiriman HTTP POST.
- Tombol Test Ping Webhook: Menguji konektivitas server secara instan melalui AJAX. Sistem akan menembakkan data uji coba dan menampilkan respon kode status HTTP (contoh:
HTTP 200 OK) untuk memastikan koneksi aktif. - Asynchronous Processing: Transmisi webhook diproses tanpa mengganggu kenyamanan pengguna di layar formulir frontend.
2. Secret Passkey Token (X-RSVPKit-Token)
Sebagai standar keamanan pengiriman data API modern:
- Anda dapat menentukan string token rahasia (contoh:
whsec_andyzhea_89a71b2c). - Nilai token ini dikirimkan dalam header HTTP
X-RSVPKit-Tokenpada setiap permintaan transmisi. - Skrip penerima di Google Apps Script atau Zapier dapat memeriksa token ini untuk menolak kiriman data palsu dari pihak yang tidak berhak.
3. Public REST API Feed untuk Layar Panggung Resepsi
RSVPKit secara otomatis membuka endpoint REST API bawaan WordPress:
- Endpoint URL:
https://domainanda.com/wp-json/rsvpkit/v1/feed?post_id=108&limit=50. - Allowed Public Fields: Anda memiliki kendali penuh atas kolom apa saja yang boleh dikeluarkan ke endpoint publik ini:
- Nama Tamu (Guest Name): Ditampilkan untuk apresiasi tamu.
- Status Kehadiran: Ditampilkan sebagai lencana konfirmasi.
- Teks Doa Restu (Wishes): Ditampilkan sebagai materi teks animasi di layar LED panggung.
- Nomor WhatsApp: Otomatis Disembunyikan (Hidden) secara permanen dari endpoint untuk melindungi privasi keluarga dan tamu undangan dari pencurian kontak.
Tabel Struktur Payload JSON Webhook Outgoing
| Kunci Properti JSON | Tipe Data | Contoh Nilai | Keterangan Data |
|---|---|---|---|
event | STRING | rsvp.created | Nama aksi pemicu event webhook |
post_id | INTEGER | 108 | Identitas unik postingan undangan terkait |
guest_name | STRING | Dr. H. Bambang Soediro | Nama lengkap tamu yang mengisi form |
whatsapp | STRING | +6281233445566 | Nomor telepon kontak terverifikasi |
attendance | STRING | attending | Status kehadiran tamu konfirmasi |
pax | INTEGER | 2 | Jumlah alokasi kehadiran porsi katering |
wishes | STRING | Selamat menempuh hidup baru... | Kalimat doa restu untuk mempelai |
timestamp | STRING | 2026-09-09T16:45:00+07:00 | Stempel waktu otentik pengiriman data |
Skenario Praktik Lapangan: Andy & Zhea
Vendor pernikahan Andy & Zhea merancang konsep resepsi interaktif modern dengan layar monitor LED videotron berukuran besar di samping panggung pelaminan:
- Konfigurasi Webhook Lembar Kerja: Vendor menempelkan URL Webhook Google Apps Script keluarga pengantin untuk rekapitulasi data katering otomatis.
- Pengamanan Token: Diberikan token rahasia
whsec_andyzhea_89a71b2cpada kolom Secret Passkey Token. - Penyambungan Layar Panggung: Tim multimedia resepsi menarik data ucapan selamat secara berkala menggunakan endpoint
/wp-json/rsvpkit/v1/feed?post_id=108. - Hasil Mengesankan: Setiap kali tamu di meja resepsi mengetikkan ucapan selamat dari ponsel mereka, ucapan tersebut langsung muncul di layar videotron panggung secara otomatis dengan tampilan animasi yang indah, tanpa pernah membocorkan nomor ponsel pribadi tamu.
Tips & Praktik Terbaik Integrasi Webhook
- Selalu Uji Ping Sebelum Acara: Gunakan tombol Test Ping Webhook minimal 1 hari sebelum hari-H untuk memastikan skrip Google Apps Script tidak mengalami masa kedaluwarsa izin (authorization expired).
- Gunakan Parameter Limit pada Feed: Selalu sertakan parameter pembatas (contoh:
limit=50) pada endpoint REST API Feed untuk menghemat alokasi penggunaan memori server hosting Anda saat acara berlangsung. - Jaga Kerahasiaan Secret Token: Jangan pernah membagikan kode Secret Passkey Token di repositori kode publik atau dokumen terbuka demi keamanan website Anda.