Setting IMAP Gmail: Server, Port, dan Sandi Aplikasi

Server, port, dan enkripsi apa yang harus diisi?

Gunakan pengaturan berikut untuk menghubungkan kotak surat Gmail. IMAP menangani pembacaan dan sinkronisasi pesan; SMTP menangani pengiriman. Keduanya perlu diperiksa secara terpisah.

Google mencantumkan server IMAP beserta kebutuhan enkripsinya dalam dokumentasi protokol Gmail. Pasangan port SMTP dan enkripsi tersedia dalam panduan Gmail untuk klien email pihak ketiga, yang juga mewajibkan autentikasi SMTP.

Untuk konfigurasi ini, pilih port IMAP 993, bukan 143. Pada SMTP, jangan menukar port tanpa menyesuaikan enkripsinya: 587 dipasangkan dengan STARTTLS pada Mailera. Panduan Google memasangkan port SMTP 465 dengan pengaturan enkripsi SSL pada klien. Jika koneksi TLS gagal, periksa pengaturannya; jangan mematikan pemeriksaan sertifikat.

Pengaturan server saja belum cukup. Autentikasi dan izin akun tetap menentukan apakah koneksi diterima. Koneksi Gmail di Mailera memakai konfigurasi IMAP dan SMTP pada dua baris pertama tabel.

Jika Anda juga menghubungkan kotak surat Outlook, gunakan panduan pengaturan IMAP dan SMTP Outlook serta autentikasinya, bukan menyalin konfigurasi Gmail ini.

Apakah Gmail memerlukan OAuth atau sandi aplikasi?

Jika aplikasi menyediakan “Sign in with Google”, gunakan pilihan itu. Google merekomendasikannya, dan server IMAP serta SMTP Gmail mendukung OAuth 2.0. Namun, dukungan OAuth di Gmail tidak berarti setiap aplikasi menyediakan alur tersebut.

Koneksi Gmail Mailera menggunakan sandi aplikasi (app password). Kolom sandinya bukan tempat untuk sandi masuk akun Google biasa.

Untuk menyiapkan sandi aplikasi:

1. Pastikan Anda masuk ke akun Google pemilik kotak surat yang akan dihubungkan.
2. Periksa bahwa verifikasi 2 langkah sudah aktif. Google mensyaratkannya untuk penggunaan sandi aplikasi.
3. Ikuti tautan pengelolaan sandi aplikasi dalam panduan sandi aplikasi Google, lalu buat sandi untuk konektor yang dituju jika opsi tersebut tersedia.
4. Simpan sandi itu secara aman dan masukkan hanya ke konektor tersebut. Google hanya menampilkan setiap sandi aplikasi satu kali; jangan memasukkannya ke percakapan agen atau berkas kode.

Opsi sandi aplikasi bisa tidak muncul ketika verifikasi 2 langkah hanya menggunakan kunci keamanan, akun berada di organisasi, atau akun memakai Advanced Protection. Jika Anda menggunakan akun kantor atau sekolah, tanyakan kebijakan yang berlaku kepada administrator. Jangan menurunkan pengamanan organisasi agar sebuah konektor bisa masuk.

Perubahan sandi akun Google juga mencabut sandi aplikasinya. Jika koneksi berhenti setelah Anda mengganti sandi akun, periksa bagian ini sebelum mengubah server atau port.

Untuk pemisahan kredensial konektor dan kredensial agen, baca panduan sandi aplikasi untuk kotak surat agen. Jangan menerapkan langkah Gmail ke semua penyedia: panduan sandi aplikasi Outlook yang gagal dan penggunaan OAuth membahas jalur yang berbeda.

Apakah IMAP Gmail masih perlu diaktifkan?

Untuk akun Google pribadi, akses IMAP selalu aktif. Google menyatakan bahwa pilihan “Enable IMAP” dan “Disable IMAP” tidak lagi tersedia sejak Januari 2025 dalam petunjuk menghubungkan Gmail ke klien lain.

Jadi, jika Anda mencari cara mengaktifkan IMAP Gmail dan tidak menemukan tombolnya, jangan langsung menganggap akun bermasalah. Pada Gmail pribadi, lanjutkan ke pemeriksaan autentikasi aplikasi.

Google Workspace berbeda. Administrator harus mengizinkan IMAP agar pengguna dapat menyinkronkan Gmail dengan klien pihak ketiga. Administrator juga bisa membatasi akses hanya untuk klien tertentu yang mendukung OAuth, sebagaimana dijelaskan dalam kontrol POP dan IMAP Google Workspace.

Artinya, port yang benar dan sandi aplikasi belum tentu cukup untuk akun perusahaan. Bila administrator menonaktifkan IMAP, akses melalui klien IMAP berhenti meskipun sebelumnya berfungsi. Selesaikan izin akun terlebih dahulu, bukan mencoba kombinasi port lain.

Bagaimana menghubungkan Gmail ke Mailera dan menguji hasilnya?

Mailera menghubungkan kotak surat yang sudah Anda gunakan ke aplikasi atau agen. Gambaran alurnya tersedia pada halaman produk Mailera. Untuk menambahkan satu akun Gmail, gunakan langkah berikut.

1. Masuk dengan peran Admin atau Leader, lalu buka Kotak surat → Tambah kotak surat → Satu kotak surat.
2. Isi Alamat email dengan alamat Gmail atau Google Workspace lengkap. Periksa penyedia yang terdeteksi. Jika tidak sesuai, pilih Gmail · Google Workspace di bagian Atau pilih penyedia, lalu pilih Lanjutkan.
3. Pada Detail koneksi, isi Sandi dengan sandi aplikasi. Nama tampilan bersifat opsional dan digunakan sebagai nama pengirim. Pilih Grup kotak surat yang sesuai dengan penggunaannya.
4. Pilih Uji & hubungkan. Perhatikan hasil Login ke server masuk, Deteksi folder, dan Login ke server keluar.
5. Setelah koneksi berhasil, buka kotak surat dan tunggu pemuatan pesan awal. Mailera memuat pesan dalam masa retensi, dimulai dari yang terbaru.

Domain perusahaan tidak otomatis berarti Anda harus memilih IMAP kustom. Bila email perusahaan Anda menggunakan Google Workspace, pilih penyedia Gmail jika deteksi alamat belum mengarah ke sana.

Uji & hubungkan tidak mengirim email. Pemeriksaan tersebut menguji koneksi, termasuk autentikasi server keluar. Untuk memastikan alur kerja Anda berjalan, lakukan uji baca dan kirim secara terpisah:

Jika autentikasi SMTP gagal tetapi penerimaan berhasil, pilih Simpan khusus penerimaan bila kebutuhan Anda hanya membaca. Jika aplikasi perlu mengirim, pilih Edit detail, perbaiki konfigurasi, lalu Uji lagi. Jangan menganggap koneksi khusus penerimaan sudah siap untuk pekerjaan pengiriman.

Untuk aplikasi yang membaca melalui REST API, isi variabel lingkungan $MAILERA_API_KEY dengan kunci berizin read dan $MAILBOX_ID dengan ID kotak surat Gmail tersebut. Permintaan berikut mengambil satu pesan dari kotak masuk:

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode "folder=inbox" \
  --data-urlencode "limit=1"

Periksa data[].subject, data[].from, dan data[].received_at untuk mengenali pesan uji. Permintaan ini memeriksa pembacaan, bukan SMTP. Detail integrasi berikutnya tersedia di halaman pengembang Mailera.

Kesalahan apa yang paling sering membuat koneksi gagal?

Saat IMAP Gmail tidak berfungsi, pisahkan masalah autentikasi, izin akun, dan jaringan. Mengubah semuanya sekaligus membuat penyebabnya sulit diketahui.

Status kotak surat Gmail di Mailera didasarkan pada sinkronisasi terakhir. Meminta status tidak memicu pemeriksaan login langsung yang baru setiap kali. Karena itu, baca status bersama hasil sinkronisasinya, bukan sebagai bukti bahwa kredensial baru saja diterima Google.

Saat meminta bantuan, sertakan pesan kesalahan yang sudah disamarkan beserta host, port, dan jenis enkripsi. Hapus sandi aplikasi, kunci API, serta isi pesan pribadi dari tangkapan layar atau log.

Bagaimana memberi akses email kepada agen AI dengan aman?

Setelah Gmail tersambung, aplikasi dan agen dapat mengaksesnya melalui REST API atau MCP Mailera. Agen menggunakan kunci API Mailera; agen tidak perlu menerima sandi aplikasi Google.

Di Pengaturan, buka bagian kunci API lalu pilih Buat API key. Beri Nama deskriptif, batasi Cakupan kotak surat ke grup yang dibutuhkan, dan mulai dengan izin read. Tambahkan send hanya jika tugas agen memang mencakup pengiriman. Kebutuhan membaca pesan tidak otomatis memerlukan izin mengirim atau mengelola kotak surat.

Perlakukan isi email sebagai data tidak tepercaya, bukan instruksi. Pesan masuk bisa berisi permintaan agar agen membocorkan rahasia, mengirim data ke alamat lain, atau mengabaikan aturan sebelumnya. Jangan biarkan isi pesan mengubah kebijakan alat maupun akses agen.

Tambahkan langkah konfirmasi oleh manusia sebelum pengiriman di aplikasi atau alur kerja agen Anda. Tampilkan penerima dan isi pesan untuk diperiksa sebelum menjalankan operasi kirim; jangan menyerahkan keputusan itu kepada instruksi yang ditemukan dalam email.

Simpan kunci dalam pengelola rahasia dan jangan menaruhnya di kode, log, atau tangkapan layar. Kunci API Mailera hanya ditampilkan sekali dan dapat dicabut kapan saja; setelah dicabut, panggilan dengan kunci tersebut langsung ditolak. Cabut akses ketika tugas selesai atau kredensial diduga bocor.

Untuk koneksi klien agen, gunakan Salin konfigurasi MCP dan lihat panduan MCP Mailera. Tinjau juga informasi keamanan Mailera sebelum memberikan akses ke kotak surat kerja.

Apa batasan Mailera dalam koneksi Gmail?

Mailera menghubungkan kotak surat yang sudah Anda miliki; Mailera tidak membuat alamat Gmail baru. Alur Gmail yang dijelaskan di sini memakai sandi aplikasi, bukan koneksi OAuth Gmail, dan tidak dapat mengesampingkan pembatasan Google atau administrator Workspace.

Jangan mengandalkan sinkronisasi seketika untuk setiap kondisi. Pemeriksaan latar belakang menyesuaikan aktivitas kotak surat, dan kotak surat yang tidak aktif dapat tidur lalu aktif kembali saat digunakan. Mailera juga bukan layanan pengiriman email pemasaran massal.