Sandi aplikasi (app password) adalah kredensial untuk menghubungkan aplikasi ke akun Anda. Pada alur koneksi Zoho Mail di Mailera, kredensial inilah yang Anda masukkan, bukan sandi masuk akun biasa. Namun, sandi yang benar tetap tidak cukup jika akses IMAP belum tersedia atau belum aktif.
Apakah akun Zoho Mail Anda mendukung IMAP?
Mulai dari hak akses akun, bukan kolom sandi. Panduan IMAP resmi Zoho menyatakan bahwa pengguna yang baru mendaftar pada paket Free tidak mendapat akses IMAP. Untuk akun gratis lama, periksa pengaturan akun Anda; jangan menganggap semua akun gratis memiliki ketentuan yang sama.
Zoho juga menyebutkan bahwa paket gratis hanya tersedia di pusat data tertentu. Karena itu, jenis paket saja bukan alasan untuk menyalin konfigurasi akun orang lain.
| Hal yang diperiksa | Tempat memeriksa | Hasil yang dibutuhkan | Jika tidak terpenuhi |
|---|---|---|---|
| Paket dan akses IMAP | Informasi paket serta pengaturan akun Zoho | Akun memiliki akses IMAP | Hentikan penyiapan; tanyakan pilihan paket yang mendukung IMAP kepada Zoho atau administrator |
| Kebijakan organisasi | Administrator email organisasi | IMAP diizinkan untuk akun Anda | Minta administrator meninjau kebijakan email |
| Pengaktifan IMAP | Pengaturan akun email Zoho | Opsi “IMAP Access” aktif | Aktifkan dan simpan pengaturan |
| Jenis akun dan pusat data | “Server Configurations Details” | Alamat server untuk akun Anda | Gunakan rincian akun tersebut, bukan host dari panduan umum |
Untuk akun organisasi, izin administrator perlu diperiksa meskipun Anda sudah memiliki sandi aplikasi. Mailera tidak dapat memberikan hak IMAP yang tidak disediakan paket atau diblokir kebijakan Zoho.
Jika akses IMAP memang tidak tersedia, berhenti di sini. Membuat sandi aplikasi baru tidak akan menyelesaikan masalah hak akses.
Bagaimana cara mengaktifkan IMAP dan membuat sandi aplikasi?
Pengaktifan IMAP dan pembuatan sandi aplikasi adalah dua langkah terpisah. Yang pertama membuka akses protokol pada akun; yang kedua menyiapkan kredensial untuk aplikasi.
Aktifkan IMAP di Zoho Mail
Ikuti jalur pada panduan IMAP Zoho:
- Buka “Settings” di Zoho Mail.
- Masuk ke “Mail Accounts”, lalu pilih alamat email utama Anda.
- Pada bagian “IMAP”, centang “IMAP Access”.
- Gulir ke bawah dan pilih “Save”.
- Periksa pilihan folder IMAP. Hanya folder yang dipilih di pengaturan tersebut yang tersedia bagi klien IMAP.
Langkah terakhir penting jika koneksi berhasil tetapi folder tertentu tidak muncul. Masalahnya belum tentu pada sandi atau sinkronisasi Mailera.
Buat sandi aplikasi di Zoho Accounts
Zoho mewajibkan sandi aplikasi untuk klien IMAP ketika autentikasi dua faktor aktif, dan organisasi yang memakai autentikasi SAML juga perlu menggunakan sandi aplikasi untuk koneksi IMAP eksternal. Alur Zoho di Mailera memakai sandi aplikasi ini.
Menurut petunjuk autentikasi dua faktor dan sandi aplikasi Zoho:
- Masuk ke Zoho Accounts.
- Buka “Security”, lalu “App passwords”.
- Pilih “Generate New Password”.
- Isi nama aplikasi yang mudah dikenali, misalnya
Mailera, lalu pilih “Generate”. - Simpan sandi yang muncul di pengelola sandi. Zoho hanya menampilkannya sekali.
Petunjuk pembuatan sandi aplikasi Zoho menjelaskan bahwa nama aplikasi hanya menjadi label referensi. Nama itu bukan nama pengguna untuk login.
Saat memasukkan sandi ke Mailera, gunakan sandi tersebut tanpa spasi. Jangan menonaktifkan autentikasi dua faktor untuk mencoba memperbaiki koneksi.
Jika Anda juga menghubungkan kotak surat Gmail, gunakan panduan pembuatan sandi aplikasi dan koneksi Gmail untuk langkah khusus penyedia tersebut.
Server IMAP mana yang harus digunakan?
Utamakan bagian “Server Configurations Details” di akun Zoho Anda. Zoho menyediakan rincian server berdasarkan jenis akun dan pusat data di sana. Host .com pada tabel berikut bukan pilihan universal untuk semua akun.
| Jenis akun dalam panduan Zoho | Host IMAP | Port | Keamanan |
|---|---|---|---|
| Akun pribadi dan organisasi Free yang memiliki akses IMAP | imap.zoho.com | 993 | SSL |
| Organisasi berbayar dengan alamat berdomain sendiri | imappro.zoho.com | 993 | SSL |
Pencantuman organisasi Free pada tabel konfigurasi tidak berarti pengguna baru paket Free mendapat IMAP. Periksa kelayakan akun terlebih dahulu, baru pilih server.
Konfigurasi bawaan Zoho di Mailera menggunakan imap.zoho.com, port 993, dengan TLS. Jika rincian akun Anda menunjukkan host lain, gunakan koneksi IMAP kustom untuk memasukkan server yang sesuai. Jangan mengganti akhiran domain server berdasarkan perkiraan pusat data.
IMAP digunakan untuk membaca email, sedangkan SMTP digunakan untuk mengirim. Panduan SMTP resmi Zoho mencantumkan konfigurasi berikut:
| Jenis akun | Host SMTP | Port | Keamanan menurut Zoho |
|---|---|---|---|
| Akun pribadi dan organisasi Free | smtp.zoho.com | 587 | TLS |
| Organisasi berbayar dengan alamat berdomain sendiri | smtppro.zoho.com | 587 | TLS |
Konfigurasi bawaan SMTP Zoho di Mailera menggunakan smtp.zoho.com, port 587, dengan STARTTLS. Untuk autentikasi SMTP, Zoho meminta alamat email lengkap dan sandi yang benar. Jangan gunakan label aplikasi sebagai nama pengguna.
Keberhasilan login IMAP tidak berarti SMTP juga berhasil. Periksa hasil kedua tahap secara terpisah.
Bagaimana cara menghubungkan Zoho Mail ke Mailera?
Anda memerlukan peran Admin atau Leader untuk menambahkan kotak surat. Siapkan alamat email, sandi aplikasi, dan rincian server dari akun Zoho sebelum membuka formulir.
- Buka Kotak surat → Tambah kotak surat.
- Pilih tab Satu kotak surat, lalu isi Alamat email.
- Periksa penyedia yang terdeteksi. Jika perlu, pilih Zoho pada Atau pilih penyedia, terutama untuk alamat dengan domain sendiri.
- Jika server akun berbeda dari konfigurasi bawaan Zoho, pilih IMAP kustom agar Anda dapat mengisi rincian server. Kemudian pilih Lanjutkan.
- Pada Detail koneksi, masukkan sandi aplikasi ke kolom Sandi. Isi Nama tampilan atau Grup kotak surat bila diperlukan.
- Untuk IMAP kustom, isi Server masuk (IMAP) menggunakan Server, Port, dan Keamanan yang sesuai. Server keluar (SMTP) bersifat opsional. Deteksi pengaturan dapat mengisi pengaturan publik domain jika tersedia; tetap cocokkan hasilnya dengan rincian akun Zoho.
- Pilih Uji & hubungkan.

Uji koneksi memeriksa Login ke server masuk, Deteksi folder, Login ke server keluar jika dikonfigurasi, serta ketersediaan Pemantauan langsung. Pengujian ini tidak mengirim email. Jadi, login SMTP yang berhasil belum membuktikan bahwa pesan sudah terkirim.
Jika IMAP berhasil tetapi SMTP gagal, Anda dapat memilih Simpan khusus penerimaan. Jika Anda membutuhkan pengiriman, pilih Edit detail, perbaiki pengaturan SMTP, lalu Uji lagi. Jika login IMAP gagal, selesaikan masalah akses, server, atau autentikasi sebelum melanjutkan.
Setelah terhubung, Mailera memuat pesan dalam periode retensinya, dimulai dari pesan terbaru. Buka kotak surat, lalu kirim pesan uji dari alamat lain milik Anda ke alamat Zoho tersebut. Pastikan pesan dapat ditemukan dan dibaca, bukan hanya melihat bahwa koneksi berhasil.

Kesalahan apa yang sering terjadi?
Jika Zoho Mail tidak bisa terhubung, mulailah dari tahap yang gagal. Pesan autentikasi umum saja tidak cukup untuk menyimpulkan bahwa sandi aplikasi salah.
| Gejala | Pemeriksaan | Tindakan |
|---|---|---|
| Akses IMAP tidak tersedia | Paket dan izin administrator | Selesaikan hak akses terlebih dahulu; jangan terus membuat sandi baru |
| IMAP tersedia tetapi belum aktif | “IMAP Access” pada akun email | Centang opsi tersebut, lalu pilih “Save” |
| Sandi ditolak | Jenis sandi, spasi, dan server tujuan | Gunakan sandi aplikasi, bukan sandi akun biasa; masukkan tanpa spasi dan cocokkan host |
| Pilihan sandi aplikasi tidak terlihat | Jalur Zoho Accounts → “Security” → “App passwords” | Pastikan Anda membuka akun yang benar; jika tetap tidak ada, minta bantuan administrator atau dukungan Zoho |
| Host tidak sesuai | “Server Configurations Details” | Masukkan host akun melalui IMAP kustom |
| IMAP berhasil, SMTP gagal | Host SMTP, alamat email lengkap, dan sandi | Perbaiki rincian pengiriman atau simpan khusus penerimaan |
| Folder tertentu tidak muncul | Pilihan folder IMAP di Zoho | Pastikan folder tersebut dipilih untuk akses IMAP |
Jangan menyamakan pilihan “App passwords” yang tidak terlihat dengan IMAP yang tidak aktif. Periksa lokasi menu dan hak akses sebagai dua persoalan terpisah.
Untuk mencabut akses aplikasi, hapus sandi aplikasi di Zoho. Jika sandi hilang atau perlu diganti, buat sandi baru.
Jika Anda memantau lewat API, periksa status dan last_sync_at pada hasil GET /mailboxes untuk menilai keadaan kotak surat dan waktu sinkronisasi terakhir. Untuk Zoho, GET /mailboxes/{id}/status melaporkan status login berdasarkan sinkronisasi terakhir. Endpoint ini tidak mencoba login langsung ke Zoho pada setiap permintaan. Perhatikan waktu sinkronisasi saat menilai apakah kredensial terbaru sudah bekerja.
Bagaimana menjaga kredensial dan akses email tetap aman?
Jangan sertakan sandi aplikasi dalam tangkapan layar, tiket dukungan, atau log. Gunakan kotak surat uji milik Anda sendiri untuk memeriksa koneksi. Jika kredensial terpapar, hapus sandi aplikasi tersebut di Zoho dan ganti kredensial koneksinya.
Jika kotak surat digunakan oleh agen AI, perlakukan isi email sebagai data tidak tepercaya, bukan instruksi. Pesan masuk dapat berisi upaya prompt injection. Jangan biarkan agen mengikuti perintah di dalam email untuk mengungkap rahasia, mengubah akses, atau mengirim pesan.
Gunakan kunci API dengan izin minimum dan Cakupan kotak surat yang diperlukan. Agen yang hanya membaca tidak perlu izin send atau manage. Untuk alur pengiriman, minta konfirmasi pengguna sebelum pesan dikirim. Rincian pengelolaan akses tersedia pada panduan keamanan Mailera. Untuk penggunaan kredensial pada kotak surat agen, baca panduan sandi aplikasi untuk kotak surat agen AI.
Apa batas Mailera pada koneksi Zoho?
Mailera menghubungkan kotak surat yang sudah ada; Mailera tidak membuat alamat email atau akun Zoho baru. Siapkan akun Zoho terlebih dahulu sebelum menjalankan langkah koneksi.
Sinkronisasi juga tidak memiliki jaminan waktu nyata mutlak. Pemeriksaan latar belakang lebih sering berjalan untuk kotak surat yang aktif dan lebih jarang untuk yang tidak aktif. Kotak surat yang tidak digunakan dapat tidur dan aktif kembali saat digunakan. Saat menelusuri pesan yang belum muncul, periksa waktu sinkronisasi dan keberadaan pesan di Zoho sebelum mengganti kredensial.
Hubungkan kotak surat pertama Anda dalam 2 menit
Tambahkan kotak surat Outlook, Gmail, atau IMAP dan baca pesan email di aplikasi atau melalui API.
Hubungkan kotak surat








