Panduan Admin
Admin mengelola akun dan cara masuk di server perusahaannya. Perintah di halaman ini dijalankan di server, di folder pemasangan (misalnya /opt/wiratalk).
Peran
Setiap akun adalah anggota atau admin. Admin membuat akun dan tautan undangan, menonaktifkan akun, membuat tautan atur ulang kata sandi, menjadikan akun admin, mengatur login kantor, dan mengganti nama serta logo perusahaan. Selalu ada paling sedikit satu admin aktif, dan setiap tindakan admin tercatat di catatan keamanan server.
Akun Karyawan
Tidak ada pendaftaran mandiri. Admin membuat akun dengan nama, nama pengguna, dan email lewat API admin (Referensi API, bagian 14.2), lalu membagikan tautan undangan yang berlaku 7 hari; karyawan membuat kata sandinya sendiri di tautan itu. Bila email (SMTP) diatur, tautan bisa langsung dikirim ke email karyawan. Sepuluh kata sandi salah berturut-turut mengunci masuk selama 15 menit; admin bisa membukanya lebih cepat.
Dari server, tautan undangan atau atur ulang baru dibuat dengan ./wiratalk admin link @namapengguna. Tautan itu berlaku 24 jam, hanya bisa dipakai sekali, dan ditampilkan sekali saja.
Admin Lupa Kata Sandi
./wiratalk admin password @namapengguna
Perintah ini menanyakan kata sandi baru tanpa menampilkannya, menggantinya, dan mengakhiri semua sesi akun itu. Untuk membuat admin lain dari server: ./wiratalk admin create --name "Nama" --username nama --email nama@perusahaan.co.id --another. Perintah ini menanyakan kata sandi dua kali dan langsung membuat akun dengan kata sandi itu; tidak ada tautan yang dicetak.
Login Kantor (OpenID Connect)
- Di penyedia (Google Workspace, Microsoft Entra ID, Keycloak, atau sejenisnya), daftarkan aplikasi dengan alamat pengalihan https://alamat-server-anda/v1/auth/oidc/callback.
- Tambahkan penyedia lewat API admin (Referensi API, bagian 14.3) dengan issuer, client ID, client secret, dan domain email yang diizinkan. Paling sedikit satu domain wajib diisi, supaya hanya karyawan Anda yang bisa masuk.
- Karyawan yang masuk pertama kali lewat penyedia itu langsung mendapat akun.
Email harus sudah diverifikasi oleh penyedia. Untuk Microsoft Entra ID dengan satu tenant, yang tidak mengirim tanda verifikasi email, aktifkan pilihan percaya email (trustEmail) untuk penyedia itu.
Email (SMTP)
Isi SMTP_HOST, SMTP_PORT, SMTP_SECURE (1 untuk TLS sejak awal di port 465, 0 untuk STARTTLS di port 587), SMTP_USER, SMTP_PASS, dan SMTP_FROM di .env, lalu jalankan ./wiratalk restart. Tanpa SMTP, admin menyalin tautan undangan dan membagikannya sendiri.
Nama dan Logo Perusahaan
Nama dari pemasangan (WT_COMPANY_NAME) tampil di aplikasi sebelum karyawan masuk, bersama logo. Admin bisa mengganti keduanya lewat API admin (Referensi API, bagian 14.4).
Status WiTalk Hub
./wiratalk status menampilkan status server di WiTalk Hub. ok berarti server terdaftar dan notifikasi berjalan. menunggu berarti pendaftaran belum selesai, dan mati berarti server tidak memakai Hub (tidak ada kunci lisensi, atau alamatnya bukan https di port 443). ditolak berarti kunci lisensi ditolak: notifikasi berhenti, tetapi chat tetap berjalan untuk karyawan Anda. Arti setiap kode ada di Panduan pemasangan.
Kunci Lisensi Baru
Bila kunci lisensi bocor, minta kunci baru ke support@wiracode.com. Kunci lama langsung tidak berlaku. Ganti WT_LICENCE_KEY di .env, jalankan ./wiratalk restart, lalu masuk lagi ke registri paket dengan kunci baru (langkah 1 Panduan pemasangan).
Kebijakan Privasi Server
Server Anda menampilkan kebijakan privasi, syarat penggunaan, dan halaman hapus akun di /privacy, /terms, dan /delete-account, dengan perusahaan Anda sebagai pengelola. Isinya diatur di .env:
- WT_LEGAL_NAME: nama resmi perusahaan (bawaan: nama perusahaan).
- WT_PRIVACY_EMAIL: email kontak privasi.
- WT_DATA_COUNTRY: kode negara tempat server dan datanya berada, misalnya ID.
- WT_PROCESSORS: penyedia yang ikut memproses data, dipisah titik koma, misalnya hosting=PT Penyedia Cloud;cdn=Cloudflare, Inc. Peran yang dikenal: hosting (mesin server), cdn (jaringan dan HTTPS di depan server), storage (penyimpanan berkas), email (pengirim email), backup (salinan cadangan).
- WT_FILES_VERSION_DAYS: berapa hari penyimpanan berkas Anda menyimpan versi lama berkas yang dihapus (0 bila tidak menyimpan).
Sesudah mengubahnya, jalankan ./wiratalk restart dan periksa halaman /privacy.
Mengubah Pengaturan Lain
Semua pengaturan ada di .env di folder pemasangan; artinya dijelaskan di env.example. Sesudah mengubahnya, jalankan ./wiratalk restart. Jangan bagikan isi .env: berkas itu memuat kunci lisensi dan kata sandi basis data.