Menghosting sendiri WATeamInbox berarti menjalankan aplikasi web, layanan data, dan worker koneksi WhatsApp di infrastruktur yang dikendalikan tim Anda.
Artikel ini membahas keputusan dan pemeriksaan di seputar sebuah deployment. Untuk perintah dan konfigurasi terkini, ikuti dokumentasi self-hosting dan file-file di repositori GitHub.
Putuskan apakah tim Anda sebaiknya mengoperasikannya
Self-hosting adalah pilihan yang masuk akal jika ada orang di tim Anda yang nyaman dengan Linux, Docker, basis data, TLS, backup, dan pembaruan rutin. Ini bisa menjaga aplikasi dan data percakapan pelanggan tetap di dalam lingkungan yang Anda kelola.
Ini kurang cocok jika tidak ada yang bisa merespons saat sebuah layanan berhenti, disk penuh, atau migrasi gagal. Dalam kasus itu, WATeamInbox Cloud mungkin lebih sederhana karena kami yang mengoperasikan tumpukan aplikasinya.
Kenali layanan yang terlibat
Baseline produksi saat ini mencakup:
- inbox web
- API di balik router internal HAProxy yang sadar kesiapan (readiness-aware) (dengan replika API homogen opsional)
- PostgreSQL untuk data aplikasi dan pencarian
- NATS untuk perintah dan event
- Centrifugo untuk pembaruan inbox secara langsung
- proses worker dan orchestrator WhatsApp
- Cloudflare R2 privat melalui endpoint API S3 akunnya untuk media
- Caddy untuk HTTPS dan perutean edge
Anda tidak perlu menjadi ahli di setiap layanan sebelum menjalankan tumpukan pengembangan. Namun Anda perlu tahu di mana setiap layanan menyimpan data, port mana yang harus privat, dan bagaimana Anda akan menyadari sebuah kegagalan.
Baca peringatan WhatsApp lebih dulu
WATeamInbox memakai pustaka klien WhatsApp tidak resmi. WhatsApp bisa mengubah protokol atau kebijakannya, pairing bisa berhenti berfungsi, dan pembatasan akun mungkin terjadi. WATeamInbox tidak bisa menjamin keamanan akun dan tidak berafiliasi dengan WhatsApp atau Meta.
Gunakan nomor non-kritis untuk deployment pertama bila memungkinkan. Jangan memindahkan nomor pelanggan penting sampai tim Anda sudah menguji pemulihan koneksi dan menyepakati proses cadangan.
Catat di mana data akan disimpan
Sebelum membuat server, putuskan:
- di mana data PostgreSQL disimpan
- object store mana yang menyimpan gambar, dokumen, dan pesan suara
- ke mana backup disalin
- siapa yang bisa mengadministrasi host
- bagaimana rahasia dibuat, disimpan, dan dirotasi
- berapa lama log dan data pelanggan disimpan
Jaga agar port administrasi basis data, NATS, pencarian, dan penyimpanan objek tetap di luar internet publik. Titik masuk web harus memakai HTTPS.
Gunakan peluncuran bertahap
1. Jalankan secara lokal
Mulai dengan penyiapan pengembangan di repositori. Buat sebuah ruang kerja, undang pengguna lain, dan ikuti sebuah pesan dari WhatsApp hingga ke inbox web.
Konfigurasi Compose lokal memakai kredensial pengembangan dan port yang terekspos. Jangan perlakukan itu sebagai konfigurasi produksi.
2. Bangun server staging
Gunakan baseline produksi single-host yang terdokumentasi di server kecil yang non-kritis. Konfigurasikan file rahasia asli, TLS, volume persisten, dan tujuan backup.
Sebelum mengundang tim, pastikan Anda bisa:
- menjalankan migrasi basis data
- memasangkan (pair) dan menyambungkan kembali nomor WhatsApp
- mengirim dan menerima pesan uji
- membuka media yang didukung
- menugaskan sebuah percakapan di antara dua pengguna
- membatasi aksi dengan peran dan izin
- memulihkan basis data dan referensi media di sistem yang bersih
3. Lakukan pilot dengan dua atau tiga rekan tim
Jalankan satu antrean kecil melalui inbox. Sepakati siapa yang memantau pesan yang belum ditugaskan, kapan seorang agen menugaskan sebuah percakapan, dan informasi apa yang pantas masuk ke catatan internal.
Amati layanan selama pilot. Periksa pertumbuhan disk, ukuran backup, restart worker, dan perilaku pencarian alih-alih menunggu pelanggan melaporkan masalah.
4. Siapkan nomor utama
Jika Anda memutuskan untuk memindahkan nomor penting, jadwalkan perubahannya dan catat cara kembali ke proses sebelumnya. Simpan backup terbaru dan pastikan tim tahu siapa yang harus dihubungi jika koneksi WhatsApp terputus.
Backup pesan dan media sekaligus
Backup basis data saja tidak cukup jika dokumen dan pesan suara pelanggan disimpan terpisah. Backup PostgreSQL dan penyimpanan objek dengan jadwal yang sesuai dengan jumlah data yang mampu ditoleransi hilang oleh tim Anda.
Pulihkan keduanya bersama-sama di mesin lain. Pastikan pengguna, percakapan, penugasan, dan media masih dapat dimuat. Uji pemulihan adalah satu-satunya bukti andal bahwa backup itu berguna.
Tinjau akses sebelum peluncuran
Beri setiap rekan tim akun mereka sendiri. Sisakan peran pemilik dan administrator untuk orang yang perlu mengelola koneksi, anggota, pengaturan, dan ekspor.
Tinjau juga akses host. Izin produk tidak melindungi data dari seseorang yang memegang kredensial basis data, penyimpanan objek, atau server yang luas.
Checklist peluncuran minimum
Sebelum mengandalkan deployment, verifikasi:
- HTTPS berfungsi di domain produksi
- hanya port yang dimaksudkan yang publik
- setiap rekan tim masuk dengan akun individual
- koneksi WhatsApp pulih setelah restart worker
- penugasan dan catatan bertahan melewati serah terima
- media yang didukung bisa ditampilkan
- backup berjalan di luar host utama
- sebuah pemulihan telah berhasil di sistem yang bersih
- ada yang menerima peringatan untuk kegagalan layanan atau penyimpanan
- tim punya cadangan ketika konektivitas WhatsApp tidak tersedia
Panduan deployment publik adalah baseline single-host. Ia bisa memakai beberapa proses API untuk ketahanan proses dan rilis, tetapi bukan desain high-availability atau multi-region, jadi sesuaikan ekspektasi. Orchestrator tetap berupa singleton.
Ketika pemeriksaan-pemeriksaan itu sudah menjadi rutin, lanjutkan dengan perintah dan konfigurasi di dokumentasi self-hosting. Jika mengoperasikan tumpukan ini menjadi lebih banyak pekerjaan daripada yang diinginkan tim Anda, bandingkan paket Cloud terkini.