Cara Mengambil Kode OTP dari Email Outlook melalui API

Hubungkan kotak surat Outlook milik sendiri ke Mailera melalui OAuth, buat kunci API berizin read, lalu panggil GET /mailboxes/{id}/otp. Parameter yang didukung mencakup from, subject, dan since_minutes. Endpoint ini mengambil kode terbaru dari email yang sudah diterima. Gunakan kotak surat uji sendiri dan pisahkan sesi pengujian agar kode tidak tertukar.

Apa yang perlu disiapkan sebelum membaca OTP Outlook?

Siapkan kotak surat Outlook.com atau Microsoft 365 milik sendiri, aplikasi yang berwenang Anda uji, serta akses Mailera. Gunakan kotak surat khusus pengujian supaya email pribadi tidak ikut masuk ke alur otomatisasi.

OTP dalam panduan ini adalah kode verifikasi yang dikirim aplikasi melalui email. API mengambil kode tersebut dari pesan yang sudah diterima. Jangan tertukar dengan API yang berada di sisi pengiriman.

Dalam referensi resmi peristiwa emailOtpSend, Microsoft menjelaskan bahwa Entra mengirim kode sekali pakai ke REST API yang Anda miliki. Itu berbeda dari mengambil pesan yang sudah tiba di Outlook.

Mailera menghubungkan kotak surat yang sudah Anda gunakan. Untuk Microsoft, koneksinya memakai OAuth melalui Microsoft Graph, bukan sandi aplikasi (app password). Halaman koneksi Outlook dan Microsoft 365 menjelaskan jalur penyedia ini; untuk konsep lintas penyedia, lihat panduan membaca OTP dari kotak surat sendiri.

Bagaimana menghubungkan Outlook dan menyiapkan kunci API?

Ada dua lapisan otorisasi. Persetujuan OAuth Microsoft memberi akses untuk koneksi kotak surat. Kunci API Mailera memberi aplikasi pengujian akses ke endpoint Mailera. Keduanya bukan kredensial yang bisa saling menggantikan.

Microsoft menjelaskan proses login dan persetujuan tersebut dalam panduan akses Microsoft Graph atas nama pengguna. Sementara itu, izin read di bawah ini adalah izin kunci Mailera, bukan nama izin Microsoft Graph.

1. Buka Kotak surat → Tambah kotak surat. Penambahan kotak surat memerlukan peran Admin atau Leader.
2. Pilih tab Masuk dengan Microsoft, lalu selesaikan login dan persetujuan OAuth di Microsoft. Pastikan Anda memilih akun uji, bukan akun kerja lain yang kebetulan sedang terbuka.
3. Buka Pengaturan, masuk ke tab API key, lalu pilih Buat API key. Isi Nama deskriptif, batasi Cakupan kotak surat ke grup pengujian, dan pilih izin "Read" (read). Atur Masa berlaku sesuai kebutuhan pengujian.
4. Saat muncul API key dibuat — salin sekarang, simpan kunci ke penyimpanan rahasia sisi server. Nilai kunci hanya ditampilkan sekali. Sediakan nilainya sebagai variabel lingkungan MAILERA_API_KEY, bukan di kode peramban.

Jika Anda sedang mengganti koneksi berbasis sandi, baca mengatasi sandi aplikasi Outlook yang gagal dengan OAuth. Untuk memahami perbedaan antarpenyedia, panduan sandi aplikasi untuk kotak surat agen membahas konteks yang lebih luas; jangan menerapkan langkah sandi aplikasi penyedia lain ke Outlook.

Selanjutnya, ambil daftar kotak surat yang dapat diakses kunci tersebut:

curl --silent --show-error \
  'https://mailera.app/api/public/v1/mailboxes' \
  -H "Authorization: Bearer $MAILERA_API_KEY"

Cocokkan email dan provider pada objek di dalam data, lalu simpan id kotak surat uji sebagai variabel lingkungan MAILBOX_ID. Jangan otomatis memilih objek pertama: kunci Anda mungkin memiliki akses ke lebih dari satu kotak surat.

Endpoint daftar kotak surat dan endpoint OTP sama-sama memerlukan read. Halaman pengembang Mailera menjelaskan pilihan integrasi, sedangkan dokumentasi API Mailera menjadi rujukan endpoint saat Anda menulis klien aplikasi.

Bagaimana meminta kode OTP terbaru untuk pengujian?

Lanjutkan setelah kotak surat yang benar terhubung dan kedua variabel lingkungan tersedia di proses pengujian.

5. Catat waktu mulai sesi pengujian di aplikasi Anda.
6. Picu satu email verifikasi dari aplikasi yang diuji ke kotak surat Outlook tersebut.
7. Panggil endpoint OTP dengan parameter from, subject, dan since_minutes seperti pada contoh berikut.
8. Gunakan kode yang ditemukan hanya dalam sesi pengujian yang sesuai, lalu hentikan pengambilan setelah alur selesai.

Contoh berikut memakai alamat pengirim fiktif dan subjek contoh. Ganti keduanya dengan pengirim serta subjek aplikasi uji Anda sebelum menjalankannya. Nilai 5 adalah nilai since_minutes yang digunakan dalam contoh.

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  -H "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verifikasi@example.com' \
  --data-urlencode 'subject=Verifikasi aplikasi uji' \
  --data-urlencode 'since_minutes=5'

Endpoint ini mendukung id pada path serta parameter kueri from, subject, dan since_minutes. Berikut nilai yang dipakai dalam contoh:

Mulailah dengan nilai pengirim dan subjek dari pesan uji yang Anda kenali. Jangan memasukkan pola regex atau wildcard hanya karena parameter tersebut berupa teks.

Kode terbaru belum tentu milik sesi saat ini. Jika Anda menjalankan beberapa pengujian bersamaan, gunakan kotak surat uji yang terpisah atau jalankan pengujian secara berurutan pada kotak surat yang sama.

Saat perlu menelusuri asal kode, periksa metadata pesan melalui GET /mailboxes/{id}/messages. Respons daftar pesan menyediakan from.address, subject, dan received_at. Bandingkan dengan pengirim yang diharapkan serta waktu mulai pengujian, bukan hanya dengan keberadaan sebuah kode.

Jika kode belum tersedia, atur pengulangan permintaan di aplikasi dengan jeda, tenggat, dan kondisi berhenti. Hentikan ketika kode yang sesuai sudah dipakai atau tenggat pengujian tercapai. Jangan membuat pengulangan tanpa jeda.

Mailera menerima email Microsoft melalui Graph change notifications, dengan pemeriksaan latar belakang berkala sebagai cadangan. Microsoft mendokumentasikan dukungan langganan perubahan pesan dalam panduan notifikasi perubahan Outlook. Mekanisme ini tidak menjamin email selalu tersedia pada permintaan pertama.

Kesalahan umum: mengapa OTP tidak ditemukan atau tidak cocok?

Pisahkan masalah akses, penerimaan pesan, dan pemilihan kode. Mengubah parameter permintaan tidak akan memperbaiki koneksi kotak surat yang terputus; menghubungkan ulang akun juga tidak menyelesaikan kode dari sesi yang salah.

Untuk memeriksa apakah login Microsoft masih berfungsi, gunakan GET /mailboxes/{id}/status. Pemeriksaan Microsoft dilakukan langsung terhadap kondisi login kotak surat.

curl --silent --show-error \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/status" \
  -H "Authorization: Bearer $MAILERA_API_KEY"

Untuk melihat pesan di Inbox, gunakan endpoint daftar pesan:

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages" \
  -H "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'folder=inbox'

Periksa from.address, subject, dan received_at pada pesan yang relevan. Jika perlu membaca isinya, ambil id pesan dan gunakan GET /mailboxes/{id}/messages/{msgId}. Jangan menyalin isi respons yang mengandung OTP ke log bersama.

Periksa juga Junk, bukan hanya Inbox. Anda dapat mengganti nilai folder menjadi junk, atau memakai GET /mailboxes/{id}/placement dengan parameter from, subject, dan since_minutes untuk memeriksa penempatan pesan. Pesan yang berada di Junk saja tidak berarti ekstraksi OTP gagal.

Jika perlu memicu sinkronisasi manual, endpointnya adalah POST /mailboxes/{id}/sync. Endpoint itu memerlukan izin sync; kunci dengan read saja tidak cukup. Sebaiknya pisahkan kunci operasional ini dari kunci pembaca OTP agar aplikasi uji tidak mendapat izin tambahan tanpa kebutuhan.

Bagaimana menjaga keamanan kode dan akses kotak surat?

Batasi alur ini pada kotak surat milik sendiri dan aplikasi yang memang berwenang Anda uji. Jangan menggunakannya untuk membaca kode akun orang lain.

Berikan izin minimum. Pembaca OTP tidak memerlukan send atau manage. Batasi cakupan ke grup pengujian, tetapkan masa berlaku kunci, lalu cabut kunci setelah selesai. Kunci Mailera dapat dicabut kapan saja; panggilan menggunakan kunci itu kemudian ditolak.

Samarkan alamat, isi email, kode OTP, token OAuth, dan kunci API pada tangkapan layar maupun catatan pengujian. Catat hasil pemeriksaan tanpa menyimpan kode mentah. Gunakan halaman keamanan Mailera sebagai rujukan saat meninjau akses integrasi bersama tim.

Jika hasilnya dibaca agen AI, perlakukan email masuk sebagai data tidak tepercaya, bukan perintah. Abaikan instruksi dalam badan email yang meminta agen membuka rahasia, mengganti aturan, atau mengirim informasi. Minta konfirmasi sebelum pengiriman pesan atau tindakan sensitif lainnya.

Apa batasan Mailera dalam alur OTP Outlook?

Mailera menghubungkan kotak surat yang sudah ada; Mailera tidak membuat kotak surat atau alamat email baru. Endpoint OTP mengambil kode terbaru dari email yang sudah diterima.

Mailera dapat memindahkan pesan keluar dari Junk, tetapi tidak dapat membuat penyedia memercayai pengirim atau menjamin penempatan Inbox.

Mailera menggunakan OAuth dan Microsoft Graph untuk koneksi Microsoft, tetapi bukan mitra resmi Microsoft.