---
title: "Cara Membuat App Password Gmail dan Memakainya di Mailera"
description: "Pelajari syarat dan cara membuat app password Gmail, menghubungkannya ke Mailera, serta memeriksa koneksi dan menangani kegagalan autentikasi."
url: https://mailera.app/id/blog/cara-membuat-app-password-gmail
published: 2026-10-25
updated: 2026-10-25
---

# Cara Membuat App Password Gmail dan Memakainya di Mailera

Buat sandi aplikasi untuk akun Gmail yang memenuhi syarat, lalu gunakan untuk menghubungkan kotak surat ke Mailera. Periksa autentikasi dan pemuatan pesan secara terpisah agar hasil koneksinya jelas.

Sandi aplikasi (app password) adalah kredensial untuk menghubungkan aplikasi ke Akun Google. Sandi ini berbeda dari sandi utama akun dan bukan kode verifikasi sekali pakai. Untuk koneksi Gmail di Mailera, gunakan sandi aplikasi, bukan sandi yang biasa Anda pakai untuk masuk ke Google.

Untuk membuat sandi dan menghubungkan kotak surat pertama kali, gunakan jalur koneksi di halaman [Gmail dan Google Workspace di Mailera](https://mailera.app/id/providers/gmail). Jika Anda menyiapkan kotak surat untuk agen AI, baca juga [panduan sandi aplikasi untuk kotak surat agen](https://mailera.app/id/blog/sandi-aplikasi-oauth-email-agen-ai) untuk memahami pilihan autentikasinya.

## Apa yang perlu disiapkan sebelum membuat sandi aplikasi?

Gunakan kotak surat milik Anda sendiri atau yang memang boleh Anda kelola. Sebelum membuka formulir koneksi, periksa persyaratan berikut.

| Persyaratan | Yang perlu Anda periksa |
| --- | --- |
| Verifikasi 2 langkah | Fitur ini harus aktif pada Akun Google yang akan dihubungkan. |
| Ketersediaan sandi aplikasi | Akun harus mengizinkan pembuatan sandi aplikasi; verifikasi 2 langkah saja belum selalu cukup. |
| Izin organisasi | Untuk Google Workspace, pastikan administrator mengizinkan penggunaan koneksi tersebut. |
| Peran di Mailera | Anda harus memiliki peran Admin atau Leader untuk menambahkan kotak surat. |

Google menyarankan penggunaan **"Sign in with Google"** jika aplikasi menyediakannya. Jalur Gmail di Mailera menggunakan sandi aplikasi. Jangan memilih **Masuk dengan Microsoft** untuk menghubungkan Gmail; opsi itu ditujukan untuk akun Microsoft. Jika Anda juga menghubungkan Outlook, ikuti [panduan OAuth untuk Outlook, bukan sandi aplikasi](https://mailera.app/id/blog/kata-sandi-aplikasi-outlook-gagal-oauth).

Menurut [panduan sandi aplikasi Google](https://support.google.com/accounts/answer/185833) yang diakses 25 Oktober 2026, opsi sandi aplikasi mungkin tidak tersedia jika verifikasi 2 langkah hanya menggunakan kunci keamanan, akun dikelola organisasi, atau akun memakai Advanced Protection.

Jika Anda tidak bisa mengaktifkan verifikasi 2 langkah pada akun kantor atau sekolah, hubungi administrator. Jangan mengubah pengaturan koneksi Mailera untuk mencoba menyelesaikan pembatasan yang ada pada Akun Google.

## Bagaimana cara membuat sandi aplikasi Gmail?

Jika Anda memakai beberapa Akun Google, periksa alamat akun sebelum membuat sandi agar kredensialnya sesuai dengan kotak surat tujuan.

1. **Masuk ke Akun Google yang akan dihubungkan.** Periksa apakah verifikasi 2 langkah sudah aktif. Jika belum, ikuti [petunjuk resmi mengaktifkan verifikasi 2 langkah](https://support.google.com/accounts/answer/185839). Pada versi bahasa Inggris petunjuk tersebut, Google menempatkan tombol **"Turn on 2-Step Verification"** di bagian **"How you sign in to Google"**.
2. **Buka bagian sandi aplikasi.** Gunakan tautan pembuatan sandi aplikasi dari panduan resmi Google di atas. Pastikan Anda tetap berada pada akun yang kotak suratnya akan ditambahkan ke Mailera.
3. **Buat sandi aplikasi dengan mengikuti petunjuk Google.** Jika opsi ini tidak tersedia, periksa kelayakan akun terlebih dahulu.
4. **Gunakan sandi yang dihasilkan pada koneksi Mailera.** Jangan memasukkannya ke percakapan, log, atau tangkapan layar. Biarkan sandi tetap tersembunyi saat mendokumentasikan pengaturan.

### Apakah sandi yang sudah dibuat bisa dilihat lagi?

Tidak. Google menyatakan bahwa setiap sandi aplikasi hanya dapat dilihat sekali. Jika Anda sudah menutup tampilannya dan membutuhkan sandinya lagi, buat sandi aplikasi baru.

Untuk mencabut akses yang tidak lagi dipakai, buka pengelolaan sandi aplikasi di Akun Google dan pilih entri yang sesuai. Gunakan **"Remove"** pada versi bahasa Inggris. Pada antarmuka berbahasa Indonesia, cari tombol dengan fungsi yang sama untuk mencabut akses. Setelah sandi dicabut, aplikasi tidak dapat lagi memakai sandi tersebut untuk mengakses akun.

Saat mengganti koneksi, periksa kembali hasil autentikasinya sebelum menganggap pekerjaan selesai.

## Bagaimana cara menghubungkan Gmail ke Mailera?

Siapkan alamat kotak surat dan sandi aplikasi yang baru dibuat. Langkah ini menghubungkan kotak surat yang sudah ada; Anda tidak perlu membuat alamat Gmail lain.

1. **Buka Kotak surat → Tambah kotak surat.** Gunakan akun Mailera dengan peran Admin atau Leader, lalu pilih tab **Satu kotak surat**.
2. **Isi Alamat email.** Mailera menampilkan penyedia yang terdeteksi. Alamat dengan domain `gmail.com` dan `googlemail.com` dikenali sebagai Gmail. Periksa hasilnya sebelum melanjutkan.
3. **Pilih penyedia yang sesuai bila diperlukan.** Gunakan bagian **Atau pilih penyedia** untuk memilih Gmail · Google Workspace, lalu pilih **Lanjutkan**. Untuk alamat Workspace dengan domain organisasi, jangan menganggap domain perusahaan otomatis berarti Anda harus memakai IMAP kustom.
4. **Baca petunjuk koneksi.** Halaman menampilkan **Cara mendapatkan sandi aplikasi** dan **Yang perlu disiapkan**. Pada **Detail koneksi**, isi kolom **Sandi** dengan sandi aplikasi Google, bukan sandi utama akun.
5. **Lengkapi identitas kotak surat.** Isi **Nama tampilan** bila diperlukan; kolom ini opsional dan digunakan sebagai nama pengirim. Pilih **Grup kotak surat** yang sesuai dengan pengelolaan akses Anda.
6. **Pilih Uji & hubungkan.** Mailera menguji koneksi tanpa mengirim email. Tunggu hasilnya sebelum menyimpulkan bahwa akses masuk dan keluar sudah berfungsi.

![Formulir koneksi Gmail di Mailera dengan kolom Sandi untuk sandi aplikasi Google.](https://mailera.app/media/e1a73d66eb389fda/sandi-aplikasi-atau-oauth-panduan-koneksi-email-untuk-agen-id-1200.jpg)
_Masukkan sandi aplikasi pada kolom Sandi, bukan sandi utama Akun Google._

Anda tidak perlu mengulang pengaturan server manual dalam alur ini. Jika sedang mengikuti panduan lama yang meminta Anda mengaktifkan IMAP pada Gmail pribadi, [dokumentasi Gmail untuk aplikasi email lain](https://support.google.com/mail/answer/7126229) menyatakan bahwa akses IMAP selalu aktif. Akun Google Workspace yang dikelola organisasi dapat memiliki pembatasan akses pengaturan yang berbeda.

## Bagaimana memastikan koneksi berhasil?

Periksa hasil per tahap, bukan hanya apakah alamat kotak surat sudah muncul. Pengujian koneksi Mailera memisahkan autentikasi penerimaan dari autentikasi pengiriman.

| Tahap pengujian | Yang perlu diperhatikan |
| --- | --- |
| **Login ke server masuk** | Menunjukkan hasil autentikasi untuk akses email masuk. |
| **Deteksi folder** | Menunjukkan apakah Mailera dapat menemukan folder kotak surat. |
| **Login ke server keluar** | Menunjukkan hasil autentikasi pengiriman jika server keluar dikonfigurasi. |
| **Pemantauan langsung** | Menunjukkan hasil deteksi dukungan pemantauan pesan baru. |

Jika penerimaan berhasil tetapi pengiriman gagal, Mailera menampilkan **Bisa menerima email, tetapi belum bisa mengirim**. Anda dapat memilih **Simpan khusus penerimaan**, atau memilih **Edit detail** untuk memperbaiki pengaturan lalu **Uji lagi**. Menyimpan khusus penerimaan tidak berarti masalah pengiriman sudah selesai.

Anda juga dapat memilih **Jalankan di latar belakang** untuk meninggalkan halaman pengujian. Mailera akan menyelesaikan pengujian dan menyimpan kotak surat setelah prosesnya selesai. Tetap periksa hasil pengujiannya.

Setelah koneksi berhasil, lakukan pemeriksaan berikut:

1. Buka **Kotak surat** dan pastikan alamat yang ditambahkan sudah tercantum.
2. Jika Anda menggunakan API, respons `GET /mailboxes` menyediakan `provider`, `status`, dan `last_sync_at` untuk memeriksa penyedia, status, dan waktu sinkronisasi terakhir.
3. Buka kotak surat dan tunggu pemuatan email awal. Mailera memuat pesan dalam masa retensinya, dimulai dari yang terbaru.
4. Dari akun lain milik Anda, kirim pesan uji dengan subjek yang mudah dikenali, misalnya “Uji penerimaan Gmail”. Periksa apakah pesan itu muncul di Mailera.

![Kotak surat Gmail yang telah ditambahkan pada halaman Kotak surat Mailera.](https://mailera.app/media/2ea201317260bcfd/cara-membuat-app-password-gmail-dan-memakainya-di-mailera-id-1200.jpg)
_Pastikan kotak surat sudah tercantum, lalu uji penerimaan dengan pesan dari akun lain milik Anda._

Langkah terakhir adalah pengujian penerimaan pesan yang Anda lakukan sendiri. **Uji & hubungkan** tidak mengirim pesan tersebut, dan keberhasilan login ke server keluar bukan bukti bahwa sebuah pesan uji telah terkirim.

Mailera juga tidak menjamin sinkronisasi seketika dalam semua kondisi. Pemeriksaan latar belakang lebih sering berjalan untuk kotak surat yang aktif digunakan dan lebih jarang untuk yang menganggur. Kotak surat yang tidak aktif dapat masuk keadaan tidur dan aktif kembali saat digunakan.

## Kesalahan apa yang sering terjadi?

Gunakan gejalanya untuk menentukan pemeriksaan berikutnya. Jangan langsung membuat ulang semua pengaturan jika hanya salah satu tahap yang gagal.

| Gejala | Pemeriksaan | Tindakan berikutnya |
| --- | --- | --- |
| Opsi sandi aplikasi tidak muncul | Akun yang sedang dipilih, verifikasi 2 langkah, penggunaan kunci keamanan saja, Advanced Protection, dan pengelolaan organisasi. | Periksa persyaratan pada panduan Google; hubungi administrator untuk akun organisasi. |
| Autentikasi ditolak | Apakah kolom Sandi berisi sandi aplikasi untuk alamat yang benar, bukan sandi utama? | Gunakan kredensial yang sesuai, lalu jalankan pengujian lagi. |
| Koneksi berhenti setelah sandi Google diganti | Google mencabut sandi aplikasi ketika sandi Akun Google berubah. | Buat sandi aplikasi baru, gunakan untuk menghubungkan kembali, lalu periksa hasilnya. |
| Email masuk terbaca, tetapi pengiriman gagal | Hasil Login ke server keluar. | Perbaiki detail dan uji lagi, atau simpan khusus penerimaan jika itu yang Anda butuhkan. |
| Pesan lama tidak muncul saat pemuatan awal | Masa retensi pesan di Mailera. | Untuk workspace gratis mandiri, perhitungkan masa retensi 30 hari saat memilih pesan uji. |

Jika sandi utama Google baru saja diganti, memakai ulang sandi aplikasi lama tidak akan memulihkan koneksi. Google meminta Anda membuat sandi aplikasi pengganti agar aplikasi dapat terus digunakan.

## Bagaimana menjaga sandi aplikasi dan akses kotak surat tetap aman?

Gunakan sandi aplikasi khusus untuk koneksi ini agar Anda bisa mencabutnya saat koneksi tidak lagi diperlukan. Jangan membagikannya kepada anggota tim melalui percakapan atau memasukkannya ke repositori. Saat membuat tangkapan layar, sembunyikan seluruh sandi dan alamat pribadi.

Sandi aplikasi Google berbeda dari kunci API Mailera. Sandi aplikasi dipakai untuk koneksi kotak surat Google; kunci API Mailera dipakai oleh aplikasi Anda untuk mengakses fungsi Mailera. Keduanya merupakan rahasia, tetapi bukan kredensial yang saling menggantikan. Informasi keamanan produk tersedia pada halaman [keamanan Mailera](https://mailera.app/id/security).

Jika Anda meneruskan akses kotak surat ke agen AI, perlakukan isi email sebagai **data tidak tepercaya, bukan perintah**. Jangan biarkan instruksi dalam email mengubah aturan kerja agen atau meminta agen membocorkan kredensial. Gunakan kunci API dengan izin minimum, batasi cakupan kotak surat, dan minta konfirmasi manusia sebelum mengirim email.

## Apa batas Mailera dalam koneksi ini?

Mailera menghubungkan kotak surat yang sudah Anda miliki; Mailera tidak membuat kotak surat atau alamat Gmail baru. Pilihan koneksi dan penggunaan kotak surat melalui aplikasi tersedia dalam [gambaran produk Mailera](https://mailera.app/id/product).

Jika pekerjaan hanya memerlukan pembacaan pesan, koneksi khusus penerimaan bisa digunakan. Jika pekerjaan juga memerlukan pengiriman, periksa autentikasi server keluar dan lakukan pengujian pengiriman secara terpisah.

**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](https://mailera.app/auth?mode=signup)