Panduan Awal Integrasi API dan Webhook pada 138 Email Perusahaan untuk Pengembang

Untuk Siapa Artikel Ini?

Artikel ini ditujukan bagi administrator IT, pengembang internal perusahaan, atau integrator sistem yang ingin menghubungkan 138 Email Perusahaan ke dalam alur kerja otomatis, aplikasi bisnis, atau platform kolaborasi internal. Jika tim Anda mengelola puluhan hingga ratusan akun email domain sendiri secara terpusat, dan membutuhkan integrasi dengan sistem HR, CRM, atau alat pemantauan keamanan, maka API dan Webhook 138 Email Perusahaan adalah solusi yang tepat.

API dan Webhook: Apa yang Ditawarkan 138 Email Perusahaan?

API (Application Programming Interface)

138 Email Perusahaan menyediakan antarmuka API yang memungkinkan pengembang melakukan operasi administrasi secara terprogram. Berdasarkan kemampuan yang telah dikonfirmasi di panel admin, API dapat mencakup (tidak terbatas pada):

• Manajemen akun: membuat akun email baru, mengatur kata sandi awal, menghapus akun, memulihkan akun yang dihapus dalam periode tertentu, serta mengubah peran (pengguna biasa, admin departemen, admin organisasi).
• Konfigurasi keamanan: mengikat alamat IP pada akun tertentu, mengaktifkan/menonaktifkan batasan login, serta mengelola pengaturan SPF, DKIM, dan DMARC untuk domain.
• Pemantauan dan pelaporan: mengambil log login, log pengiriman, dan log serangan (misalnya upaya login mencurigakan, email palsu yang terdeteksi).
• Manajemen kapasitas: mengatur kuota penyimpanan tiap akun, memperluas kapasitas tanpa batas (sesuai paket).

Catatan: Dokumentasi API resmi dan endpoint spesifik hanya tersedia bagi pelanggan terverifikasi. Hubungi tim dukungan 138 Email Perusahaan untuk mendapatkan akses dokumentasi teknis terbaru.

Webhook (Callback HTTP)

Webhook memungkinkan sistem Anda menerima notifikasi instan ketika peristiwa tertentu terjadi di server email 138, tanpa perlu melakukan polling berulang. Contoh peristiwa yang dapat di-webhook-kan:

• Email baru masuk: ketika email diterima di kotak masuk tertentu (misalnya untuk departemen penjualan atau dukungan).
• Email gagal terkirim: notifikasi jika pengiriman ke server tujuan gagal (bounce) atau masuk antrian spam.
• Aktivitas mencurigakan: deteksi email palsu, login dari lokasi tidak dikenal, atau perubahan kata sandi.
• Peringatan kapasitas: saat penyimpanan akun mendekati batas.

Dengan webhook, Anda dapat mengintegrasikan notifikasi ini ke dalam Slack, Microsoft Teams, sistem tiket, atau dashboard internal – sehingga tim bisa merespons lebih cepat.

Skenario Integrasi Nyata

1. Otomatisasi Provisioning Akun untuk Karyawan Baru

Saat HR menambahkan karyawan baru di sistem SDM, API 138 Email Perusahaan dapat secara otomatis membuat akun email dengan nama domain perusahaan, menetapkan kata sandi sementara, dan mengirimkan kredensial melalui email atau portal internal. Proses ini menggantikan pembuatan manual di panel admin, mengurangi kesalahan dan waktu tunggu.
Fakta dari pengetahuan dasar: Panel admin 138 menyediakan fitur "Buat pengguna email baru" di menu Organisasi & Pengguna > Manajemen Pengguna. API memungkinkan langkah yang sama dilakukan secara batch dari sistem eksternal.

2. Sinkronisasi Keamanan dengan Sistem SIEM

Via API, Anda dapat mengambil log login dan log pengiriman secara periodik, lalu memasukkannya ke dalam sistem SIEM (Security Information and Event Management) untuk analisis ancaman. Webhook dapat mengirimkan peringatan real-time ketika terdeteksi email spam dalam jumlah besar dari satu akun – memungkinkan tim keamanan untuk segera membekukan akun.

3. Notifikasi Otomatis untuk Pelanggan atau Mitra

Perusahaan e-commerce lintas batas (seperti studi kasus Điện tử Lạc Hào Vietnam) sering mengirimkan konfirmasi pesanan, notifikasi pengiriman, atau faktur melalui email. Dengan webhook, ketika status pesanan berubah di sistem ERP, sistem dapat memicu pengiriman email melalui API 138, atau menerima notifikasi balasan dari pelanggan untuk memperbarui status.

Langkah Integrasi (Panduan Umum)

1. Dapatkan kredensial API: Setelah berlangganan 138 Email Perusahaan, hubungi tim dukungan untuk mendapatkan API key dan secret. Pastikan Anda memiliki hak akses administrator organisasi.
2. Baca dokumentasi: Pelajari endpoint yang tersedia – biasanya mencakup operasi CRUD untuk akun, domain, alias, dan pengaturan keamanan.
3. Konfigurasi webhook endpoint: Siapkan URL publik di server Anda yang dapat menerima permintaan POST. Di panel admin 138, daftarkan URL tersebut untuk peristiwa yang diinginkan.
4. Uji di lingkungan staging: Gunakan akun uji coba terbatas untuk memverifikasi bahwa API dan webhook berfungsi sesuai harapan, terutama untuk pembuatan akun, pengiriman email, dan penerimaan notifikasi.
5. Terapkan otomatisasi: Mulai dari skenario sederhana (misalnya sinkronisasi akun) lalu perluas ke pemantauan keamanan dan notifikasi.

Batasan dan Pertimbangan

• Keamanan kredensial: API key harus disimpan dengan aman, jangan pernah disematkan di kode klien. Gunakan environment variable atau vault.
• Rate limiting: API mungkin memiliki batas jumlah permintaan per menit. Konsultasikan dengan dukungan untuk mengetahui batas normal.
• Webhook reliability: Pastikan endpoint Anda selalu tersedia dan dapat menangani retry. 138 Email Perusahaan akan mengirim ulang webhook yang gagal hingga batas waktu tertentu.
• Kepatuhan: Jika Anda menggunakan fitur pemantauan email (seperti yang disebutkan di FAQ harga), pastikan Anda telah mendapatkan persetujuan dari karyawan sesuai peraturan ketenagakerjaan dan privasi yang berlaku.

Langkah Selanjutnya

Untuk memulai integrasi, hubungi tim dukungan 138 Email Perusahaan melalui saluran resmi. Mereka akan memberikan akses ke dokumentasi API dan contoh kode (jika tersedia). Jika Anda belum memiliki akun, Anda dapat mendaftar uji coba terlebih dahulu untuk mengeksplorasi panel admin dan memahami kemampuan yang dapat diotomatisasi.
Ingat: Dokumentasi teknis yang akurat dan endpoint spesifik hanya diberikan kepada pelanggan terdaftar. Jangan ragu untuk bertanya tentang kemungkinan kustomisasi atau fitur yang belum tercantum.