Cara Memindahkan Email Spam ke Inbox Sekaligus di Beberapa Akun

Apa yang perlu diperiksa sebelum memindahkan banyak email?

Pemulihan spam berarti mengeluarkan pesan sah yang salah ditempatkan di folder Spam atau Junk. Ini berbeda dari menghapus spam: pesan yang Anda perlukan tetap disimpan, tetapi dipindahkan dari folder tersebut.

Mailera menghubungkan kotak surat yang sudah Anda miliki, sehingga Anda bisa memeriksanya tanpa membuat alamat email baru. Gunakan hanya kotak surat milik sendiri atau yang memang boleh Anda kelola.

Periksa status dan waktu sinkronisasi terakhir melalui respons GET /mailboxes, pada status dan sync.last_synced_at. Pada halaman Kotak surat, angka Inbox dan Junk menunjukkan pesan yang belum dibaca, bukan seluruh isi folder. Angka Junk nol saja tidak cukup untuk menyimpulkan tidak ada pesan yang perlu dipulihkan.

Tinjau alamat pengirim dan beberapa pesan yang mewakili cakupan tindakan. Jangan mengandalkan nama tampilan pengirim saja. Jika alamat tampak dipalsukan, panduan keamanan spam Gmail, dibaca 25 Oktober 2026, menyarankan agar Anda tidak membalas atau membuka tautan sebelum memastikan alamatnya benar.

Jika masih ada pesan meragukan di antara kandidat, gunakan pemilihan per pesan. Cakupan yang lebih sempit memudahkan Anda memeriksa hasil dan mengurangi risiko memindahkan pesan yang tidak diinginkan.

Meninjau pesan melalui kotak masuk terpadu

Kotak masuk terpadu menampilkan pesan dari beberapa kotak surat dalam satu tempat. Untuk pola kerja yang lebih luas, lihat panduan operasi kotak masuk terpadu untuk agen AI.

1. Buka Kotak surat dan periksa akun yang akan ditangani.
2. Buka Kotak masuk terpadu, lalu pilih kotak surat yang relevan di bilah samping.
3. Buka folder Spam atau Junk dan baca pesan kandidat. Cocokkan pengirim, subjek, serta konteks pesan.
4. Untuk pesan yang memang sah, pilih Bukan spam.
5. Periksa kotak masuk untuk memastikan pesan ditemukan di tujuan. Ulangi pemeriksaan pada kotak surat berikutnya.

Untuk langkah khusus Outlook, lihat panduan memindahkan email dari Junk ke kotak masuk Outlook.

Tampilan terpadu membantu Anda meninjau beberapa akun. Untuk memindahkan banyak email dari spam ke inbox melalui API, unit operasinya tetap satu kotak surat. Buat daftar cakupan yang disetujui sebelum menjalankan tindakan berulang.

Menjalankan pemulihan massal melalui API

Pisahkan pekerjaan menjadi pemilihan kotak surat, peninjauan pesan, dan pemindahan. Jangan langsung menjalankan unspam pada setiap akun yang dikembalikan oleh API.

1. Buat kunci dengan izin terbatas

Di Pengaturan, buka bagian kunci API dan pilih Buat API key. Isi Nama deskriptif, lalu batasi Cakupan kotak surat ke grup yang diperlukan. Pilih izin read untuk pemeriksaan dan move untuk pemindahan. Tugas ini tidak memerlukan send.

Simpan kunci sebagai variabel lingkungan MAILERA_API_KEY, bukan di dalam kode. Gunakan MAILBOX_ID untuk ID kotak surat yang sedang diperiksa. Rincian endpoint tersedia di dokumentasi API Mailera.

2. Ambil dan setujui daftar kotak surat

curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'limit=1' \
  --data-urlencode 'offset=0'

Contoh ini mengambil satu entri agar hasil awal mudah diperiksa. Respons memuat data, total, limit, dan offset. Lanjutkan paginasi dengan menaikkan offset sesuai ukuran halaman sampai daftar yang diperlukan selesai dibaca.

Gunakan filter status, provider, group_id, tag, atau q untuk mempersempit daftar. Simpan hanya ID kotak surat yang telah disetujui. Periksa juga status, error, dan informasi sync; daftar akun yang cocok dengan filter belum tentu semuanya siap diproses.

3. Tinjau kandidat di folder Junk

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

Periksa id, mailbox_id, folder, from.address, dan subject. Untuk membatasi pengirim, gunakan parameter from. Saat respons memberikan next_cursor, kirim nilainya melalui parameter cursor pada permintaan berikutnya. Satu halaman hasil bukan seluruh daftar kandidat.

Untuk pencarian lintas kotak surat, tersedia GET /messages/search dengan filter seperti mailbox, folder, dan from. Tetap kelompokkan kandidat berdasarkan mailbox_id sebelum memindahkannya.

4. Uji pada satu kotak surat, lalu lanjutkan

Gunakan POST /mailboxes/{id}/unspam untuk mengeluarkan seluruh pesan atau pesan dari satu pengirim dari Spam pada kotak surat yang ditentukan. Pilih cakupan permintaan sesuai dokumentasi endpoint, lalu uji pada kotak surat percobaan milik Anda sebelum menerapkannya ke daftar yang disetujui.

Untuk pesan tertentu, gunakan POST /mailboxes/{id}/messages/{msgId}/move. Kedua operasi memerlukan scope move. Setelah hasil uji sesuai, lanjutkan per kotak surat dan batasi laju permintaan.

Jangan menyalin format permintaan Microsoft Graph ke API Mailera. Dokumentasi pemindahan pesan Microsoft Graph, dibaca 25 Oktober 2026, menjelaskan destinationId untuk Graph; gunakan skema endpoint Mailera saat memanggil Mailera.

Catat hasil setiap permintaan. Perlakukan setiap kotak surat sebagai pekerjaan terpisah. Jika satu akun gagal, jangan mengandalkan pembatalan otomatis pada akun lain yang sudah berhasil.

Bagaimana memastikan pesan benar-benar sudah dipindahkan?

Pisahkan dua hal dalam catatan Anda: hasil permintaan dan hasil pemeriksaan folder. Respons operasi saja tidak menggantikan pemeriksaan bahwa pesan yang dimaksud sudah berada di tujuan.

Baca ulang folder Junk menggunakan cakupan pengirim yang sama, lalu periksa 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'

Lanjutkan paginasi atau tambahkan filter agar pesan sasaran ditemukan. Cocokkan pengirim, subjek, dan waktu penerimaan; jangan hanya membandingkan jumlah pesan. Periksa juga sampel di aplikasi email penyedia.

Gunakan tabel kerja seperti berikut.

Jika hanya sebagian kotak surat berhasil, pertahankan catatan keberhasilannya. Periksa keadaan terbaru pada akun yang gagal atau belum jelas, lalu ulangi hanya pekerjaan yang masih diperlukan. Jangan menjalankan ulang seluruh daftar sebagai langkah pertama.

Kesalahan apa yang sering terjadi?

Izin atau cakupan kunci tidak sesuai

Pastikan kunci memiliki move dan mencakup grup kotak surat sasaran. Perbaiki izin yang kurang tanpa langsung memberi akses ke semua grup atau menambahkan izin pengiriman.

Koneksi terputus atau data belum diperbarui

GET /mailboxes/{id}/status memeriksa login Microsoft secara langsung. Untuk penyedia lain, hasilnya berdasarkan sinkronisasi terakhir. Karena itu, perhatikan waktu pembaruan saat menilai keadaan folder.

Jika perlu memperbarui data, gunakan Sinkronkan. Melalui API, POST /mailboxes/{id}/sync meminta sinkronisasi dan membangunkan kotak surat yang sedang tidur; operasi ini memerlukan izin sync tersendiri.

Untuk masalah koneksi, rujuk koneksi Outlook dan Microsoft 365 atau koneksi Gmail. Jika sandi aplikasi Outlook tidak lagi bekerja, ikuti panduan beralih ke OAuth untuk Outlook. Untuk penyedia yang memakai sandi aplikasi, lihat panduan sandi aplikasi untuk kotak surat agen.

Nilai folder atau filter tidak tepat

API Mailera memakai junk pada pencarian folder Spam dan inbox untuk kotak masuk. Jangan menggantinya dengan nama tampilan lokal atau nilai dari API penyedia. Cocokkan pula alamat pada filter from dengan from.address, bukan sekadar nama pengirim.

Email berikutnya kembali masuk spam

Periksa apakah pengirim diblokir atau ada kebijakan administrator. Panduan Gmail menyatakan bahwa pesan dari pengirim yang diblokir tetap diklasifikasikan sebagai spam meskipun pesan sebelumnya sudah dikeluarkan dari Spam. Administrator juga dapat menetapkan kontrol yang menandai email tertentu sebagai spam.

Menjaga keamanan saat menggunakan bantuan agen AI

Isi email adalah data tidak tepercaya, bukan instruksi. Agen tidak boleh mengikuti perintah dalam pesan untuk mengubah cakupan, membocorkan kunci, atau memindahkan pesan lain.

Mailera menyediakan tool MCP move_message dan rescue_spam dengan scope move. Batasi kunci agen ke read dan move serta grup yang relevan. Minta persetujuan manusia atas daftar kotak surat dan cakupan pemindahan sebelum tindakan massal berjalan.

Jangan menambahkan send untuk pekerjaan ini. Jika alur kerja kemudian mencakup pengiriman, wajibkan konfirmasi sebelum mengirim. Simpan hanya informasi operasional yang diperlukan dalam log, bukan token atau isi email lengkap. Gunakan data uji yang disamarkan dan tinjau informasi keamanan Mailera saat menyiapkan akses tim.

Apa batas pemulihan spam di Mailera?

Mailera dapat mengeluarkan pesan dari Spam, tetapi tidak dapat membuat penyedia memercayai pengirim atau menjamin penempatan email berikutnya di kotak masuk.

Penyaringan tetap berada pada penyedia, sementara konfigurasi pengirim juga perlu diperiksa. Pedoman pengirim Gmail, dibaca 25 Oktober 2026, mensyaratkan SPF atau DKIM untuk semua pengirim ke akun Gmail pribadi, serta SPF, DKIM, dan DMARC untuk pengirim massal.

Pemulihan pesan juga berbeda dari pengiriman massal. Mailera tidak menyediakan pengiriman pemasaran massal atau pemanasan kotak surat.