Tovanix
Tovanix

Menggunakan API agregasi SMTP

Menggabungkan beberapa akun SMTP milik Anda menjadi satu jalur pengiriman, dengan rotasi oleh platform:

  • Versi gratis aktif otomatis saat pertama kali dipakai; kuota, fitur, dan batas jumlah mengikuti paket; beralih paket dengan Ganti paket, dan sisa waktu yang belum terpakai diperhitungkan sesuai harga asli
  • Tambahkan akun di Akun SMTP terlebih dahulu, lalu buat kunci di API key; membuat dan mengatur ulang kunci memerlukan verifikasi identitas, dan kunci hanya ditampilkan sekali
  • Tiga cara mengirim: tulis daring, kampanye massal, dan panggilan API; kampanye massal otomatis menggabungkan, menghapus duplikat, dan melewati daftar berhenti berlangganan
  • Akun SMTP yang gagal mengirim 3 kali berturut-turut karena masalah akun itu sendiri berubah menjadi Kesalahan, dan pulih otomatis setelah lolos pemeriksaan platform
  • Error umum: 400 ditangani sesuai message (kuota habis, penerima sudah dilaporkan sebagai pantulan, dan sebagainya), 401 berarti kunci tidak valid, 403 berarti akun dibatasi, dan 429 berarti permintaan terlalu sering

Fungsi layanan ini

API agregasi SMTP menggabungkan beberapa akun pengiriman SMTP milik Anda menjadi satu jalur pengiriman: sistem Anda cukup terhubung ke platform sekali, dan platform merotasi pengiriman di antara akun-akun tersebut. Anda dapat mengirim langsung dari konsol atau melalui API dari sistem Anda sendiri.

  • Cocok untuk email transaksional seperti kode pendaftaran dan notifikasi pesanan, maupun pengiriman massal ke grup kontak.
  • Versi gratis aktif otomatis saat pertama kali dipakai. Setelah menambahkan akun SMTP dan membuat API key, Anda sudah dapat mengirim; ganti paket saat membutuhkan kuota atau fitur yang lebih banyak.
  • Masuk melalui "SMTP API" di konsol, yang dibagi menjadi tiga kelompok halaman: "Pengiriman", "Integrasi", dan "Konfigurasi".

Pahami istilah dahulu

Ada banyak halaman. Memahami konsep berikut mencegah Anda memilih halaman yang salah.

  • Paket — Menentukan berapa email yang dapat dikirim per hari dan per bulan, fitur apa yang dapat dipakai (templat email, kontak, kampanye massal, webhook), serta batas jumlah masing-masing; semuanya dirinci di kartu halaman "Berlangganan". Versi gratis aktif otomatis saat pertama kali dipakai; setelah paket berbayar berakhir, akun kembali ke versi gratis.
  • Akun SMTP — Akun pengiriman SMTP milik Anda sendiri (dari penyedia email atau server sendiri); platform tidak menyediakan jalur pengiriman. Anda dapat menambahkan beberapa akun, masing-masing dengan prioritas dan batas pengiriman harian, dan platform merotasi pengiriman di antaranya.
  • API key — Kredensial yang dipakai sistem Anda saat memanggil endpoint pengiriman. API key menentukan "siapa yang memanggil", sedangkan akun SMTP menentukan "email mana yang dipakai untuk mengirim".
  • Domain pengiriman — Domain setelah @ pada alamat email pengirim Anda. Periksa catatan SPF, DKIM, dan DMARC-nya di halaman "Domain pengiriman"; setelah lengkap, email lebih mudah masuk kotak masuk.
  • Daftar berhenti berlangganan — Alamat penerima yang berhenti berlangganan melalui tautan berhenti berlangganan, serta alamat yang dilaporkan sistem Anda melalui API sebagai pantulan atau keluhan. Platform otomatis melewati alamat-alamat ini sesuai daftar, tanpa perlu Anda kelola manual.

Mengirim email pertama

  • Periksa paket: Versi gratis aktif otomatis saat pertama kali masuk. Buka "SMTP API → Berlangganan" untuk melihat paket saat ini dan kuota setiap paket; berlangganan tingkat yang lebih tinggi saat membutuhkan kuota atau fitur yang lebih banyak.
  • Tambahkan akun SMTP: Di halaman "Akun SMTP", klik "Tambah akun", lalu isi alamat host, port, nama pengguna, kata sandi, dan email pengirim. Jumlah akun yang dapat ditambahkan bergantung pada paket; jika ada beberapa akun, platform merotasi pengiriman otomatis.
  • Buat kunci API: Di halaman "API key", klik "Buat kunci API". Membuat dan mengatur ulang kunci memerlukan verifikasi identitas terlebih dahulu: jika autentikasi dua faktor aktif, masukkan kode dinamis; jika tidak, gunakan kode verifikasi email. Setelah verifikasi sekali, Anda tidak perlu memverifikasi ulang dalam 10 menit pada sesi login yang sama. Kunci hanya ditampilkan sekali, jadi segera salin dan simpan; setiap akun dapat memiliki maksimal 50 kunci.
  • Kirim email uji: Di halaman "Akun SMTP", klik "Uji" untuk menguji koneksi atau mengirim email uji ke alamat Anda sendiri. Email uji tidak memakai kuota pengiriman, jadi Anda bisa mencobanya beberapa kali.

Jika sudah memiliki paket berbayar, pilih tingkat lain di halaman "Berlangganan" dan klik "Ganti paket" untuk beralih paket, yang langsung berlaku: sisa waktu paket saat ini diperhitungkan sesuai harga aslinya, sehingga Anda hanya membayar selisihnya; jika nilai yang diperhitungkan melebihi harga paket baru, kelebihannya dikonversi menjadi tambahan masa berlaku, bukan dikembalikan ke saldo; kuota yang sudah dipakai bulan ini terbawa ke paket baru.

Setelah API key dihapus, semua permintaan yang masih memakainya akan gagal; mengatur ulang juga langsung membuat kunci asli tidak berlaku. Untuk kunci yang sedang dipakai sistem produksi, pasang kunci baru terlebih dahulu sebelum mengubah kunci lama.

Tiga cara mengirim

Satu kuota, tiga jalur — pilih sesuai kebutuhan:

  • Tulis secara daring — Tulis dan kirim dari konsol. Cocok untuk notifikasi sesekali atau kirim ulang manual.
  • Kampanye — Pilih templat dan grup kontak untuk pengiriman massal dengan batas laju, pelacakan, dan jadwal. Sistem menggabungkan, menghapus duplikat, dan melewati daftar berhenti berlangganan.
  • Panggilan API — Sistem Anda memanggil endpoint langsung. Satu permintaan dapat mencakup beberapa penerima dengan variabel templat masing-masing.

Templat dan variabel

Simpan isi dalam templat dan kirim variabel saja agar konten terpisah dari kode.

  • Kelola templat pada halaman Templat dan gunakan ID saat mengirim; platform mengganti variabel.
  • Platform membuat alternatif teks biasa dari HTML agar email tetap terbaca tanpa dukungan HTML.

Kontak dan berhenti berlangganan

Halaman "Kontak" mengelola alamat dan grup, serta mendukung impor dan ekspor CSV; kampanye massal memilih target menurut grup.

  • Beberapa grup digabung dan dihapus duplikatnya agar tidak ada penerima mendapat email sama dua kali.
  • Saat mengimpor CSV, alamat yang sudah berhenti berlangganan otomatis dilewati.
  • Tautan berhenti berlangganan menuju halaman konfirmasi; persetujuan memasukkan alamat ke daftar dan menandai kontak.

Daftar berhenti berlangganan berlaku otomatis. Alamat yang dilaporkan sebagai pantulan atau keluhan tidak akan lagi menerima email apa pun; alamat yang berhenti berlangganan melalui tautan hanya dilewati dalam kampanye massal dan pengiriman massal, sedangkan email tunggal seperti kode verifikasi tetap dikirim seperti biasa.

Domain pengiriman

Di halaman "Domain pengiriman", tambahkan domain yang Anda pakai untuk mengirim (bagian setelah @ pada email pengirim), dan Anda juga dapat mengisi selektor DKIM (dari penyedia email Anda). Platform memeriksa catatan SPF, DKIM, dan DMARC, lalu menampilkan catatan DNS yang disarankan untuk ditambahkan beserta tingkat kesehatannya. Setelah catatan lengkap, email lebih mudah masuk kotak masuk. Langkah ini bukan syarat untuk mengirim; jumlah domain yang dapat ditambahkan bergantung pada paket.

Webhook dan peristiwa

Atur webhook untuk mengetahui hasil setiap email; platform mengirim peristiwa pengiriman ke layanan Anda.

  • Peristiwa mencakup proses dan hasil pengiriman, berhenti berlangganan, serta kampanye selesai.
  • Callback ditandatangani; server harus memverifikasi sebelum mempercayainya. Ini batas keamanan yang tidak boleh dilewati.

Error umum dan penanganannya

Jika panggilan API gagal, periksa dulu kode status HTTP dan message dalam respons, lalu tangani sesuai tabel berikut.

  • Respons 400 — Permintaan ditolak: kuota habis, penerima sudah dilaporkan sebagai pantulan atau keluhan, tidak ada akun SMTP yang tersedia, parameter salah, dan sebagainya — Tangani sesuai message. Jika kuota habis, tunggu reset (kuota harian direset pukul 0 di zona waktu akun Anda, yang dapat diubah di pengaturan akun; kuota bulanan direset di awal setiap bulan), atau beralih ke paket yang lebih tinggi; jika muncul pesan tidak ada akun SMTP yang tersedia, periksa statusnya di halaman "Akun SMTP".
  • Respons 401 — API key tidak disertakan, atau kunci tidak valid, dinonaktifkan, sudah dihapus, atau sudah diatur ulang — Periksa statusnya di halaman "API key", lalu ganti kunci di sistem Anda dengan kunci yang berlaku saat ini.
  • Respons 403 — Akun dibekukan atau sedang dibatasi — Akun yang dibatasi (kode error 4031) masih dapat memanggil endpoint kueri, tetapi pengiriman akan ditolak. Hubungi dukungan untuk penanganan.
  • Respons 429 — Permintaan terlalu sering: setiap API key maksimal 20 permintaan per detik, dan total setiap akun maksimal 60 permintaan per detik — Tunggu sesuai header respons Retry-After sebelum mengirim lagi. Untuk mengirim ke banyak orang, gunakan satu permintaan dengan beberapa penerima atau kampanye massal, jangan memanggil cepat satu per satu.
  • Email terkirim tetapi masuk spam — Domain belum diatur atau konten memicu filter — Periksa SPF, DKIM, dan DMARC di halaman "Domain pengiriman", lengkapi catatan DNS sesuai saran, lalu periksa kontennya; sebelum kampanye massal sungguhan, Anda dapat memeriksanya dulu dengan "Simulasi pengiriman".

Jika akun SMTP gagal mengirim 3 kali berturut-turut karena masalah pada akun itu sendiri, seperti gagal login atau tidak dapat terhubung ke server, statusnya berubah menjadi "Kesalahan" dan akun berhenti ikut rotasi. Platform memeriksanya otomatis secara berkala dan memulihkannya setelah lolos; Anda juga dapat menguji koneksi atau mengirim email uji dari halaman "Akun SMTP" (jika berhasil, akun langsung pulih), memperbaiki informasi koneksi, atau mengaktifkannya secara manual.

Pertanyaan umum

Semua sudah diatur, mengapa email masih tidak terkirim?

Periksa berurutan: apakah ada akun yang aktif di "Akun SMTP" (akun berstatus "Kesalahan" tidak ikut mengirim); apakah API key yang dipakai adalah kunci yang berlaku saat ini; dan apakah kuota hari ini atau bulan ini sudah habis. message yang dikembalikan endpoint menyebutkan penyebab pastinya.

Apakah email uji memakai kuota?

Tidak. Pengiriman uji di halaman "Akun SMTP" tidak memakai kuota pengiriman, jadi Anda bisa mencobanya berkali-kali selama tahap konfigurasi.

Apa yang terjadi setelah paket berbayar berakhir?

Setelah berakhir, akun kembali ke kuota dan fitur versi gratis. Untuk melanjutkan, klik "Perpanjang" di halaman "Berlangganan" sebelum masa berakhir, atau berlangganan lagi setelah berakhir.

Halaman terkait: Pusat Bantuan · Panduan & Tanya Jawab · API SMTP terpadu · Dokumentasi API

Memuat…