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 diperiksaTempat memeriksaHasil yang dibutuhkanJika tidak terpenuhi
Paket dan akses IMAPInformasi paket serta pengaturan akun ZohoAkun memiliki akses IMAPHentikan penyiapan; tanyakan pilihan paket yang mendukung IMAP kepada Zoho atau administrator
Kebijakan organisasiAdministrator email organisasiIMAP diizinkan untuk akun AndaMinta administrator meninjau kebijakan email
Pengaktifan IMAPPengaturan akun email ZohoOpsi “IMAP Access” aktifAktifkan dan simpan pengaturan
Jenis akun dan pusat data“Server Configurations Details”Alamat server untuk akun AndaGunakan 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:

  1. Buka “Settings” di Zoho Mail.
  2. Masuk ke “Mail Accounts”, lalu pilih alamat email utama Anda.
  3. Pada bagian “IMAP”, centang “IMAP Access”.
  4. Gulir ke bawah dan pilih “Save”.
  5. 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:

  1. Masuk ke Zoho Accounts.
  2. Buka “Security”, lalu “App passwords”.
  3. Pilih “Generate New Password”.
  4. Isi nama aplikasi yang mudah dikenali, misalnya Mailera, lalu pilih “Generate”.
  5. 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 ZohoHost IMAPPortKeamanan
Akun pribadi dan organisasi Free yang memiliki akses IMAPimap.zoho.com993SSL
Organisasi berbayar dengan alamat berdomain sendiriimappro.zoho.com993SSL

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 akunHost SMTPPortKeamanan menurut Zoho
Akun pribadi dan organisasi Freesmtp.zoho.com587TLS
Organisasi berbayar dengan alamat berdomain sendirismtppro.zoho.com587TLS

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.

  1. Buka Kotak surat → Tambah kotak surat.
  2. Pilih tab Satu kotak surat, lalu isi Alamat email.
  3. Periksa penyedia yang terdeteksi. Jika perlu, pilih Zoho pada Atau pilih penyedia, terutama untuk alamat dengan domain sendiri.
  4. Jika server akun berbeda dari konfigurasi bawaan Zoho, pilih IMAP kustom agar Anda dapat mengisi rincian server. Kemudian pilih Lanjutkan.
  5. Pada Detail koneksi, masukkan sandi aplikasi ke kolom Sandi. Isi Nama tampilan atau Grup kotak surat bila diperlukan.
  6. 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.
  7. Pilih Uji & hubungkan.
Formulir koneksi Zoho di Mailera dengan kolom Sandi dan tombol Uji & hubungkan.
Masukkan sandi aplikasi pada kolom Sandi, lalu uji koneksi tanpa mengirim email.

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.

Kotak surat uji Zoho pada halaman Kotak surat di Mailera.
Setelah terhubung, buka kotak surat Zoho dan pastikan pesan uji dapat dibaca.

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.

GejalaPemeriksaanTindakan
Akses IMAP tidak tersediaPaket dan izin administratorSelesaikan hak akses terlebih dahulu; jangan terus membuat sandi baru
IMAP tersedia tetapi belum aktif“IMAP Access” pada akun emailCentang opsi tersebut, lalu pilih “Save”
Sandi ditolakJenis sandi, spasi, dan server tujuanGunakan sandi aplikasi, bukan sandi akun biasa; masukkan tanpa spasi dan cocokkan host
Pilihan sandi aplikasi tidak terlihatJalur 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 gagalHost SMTP, alamat email lengkap, dan sandiPerbaiki rincian pengiriman atau simpan khusus penerimaan
Folder tertentu tidak munculPilihan folder IMAP di ZohoPastikan 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