Tovanix
Tovanix

API SMTP terpadu

Hubungkan akun pengirim SMTP milik Anda sendiri ke platform dan kirim email melalui satu API HTTP. Platform merotasi pengiriman di antara akun-akun Anda, mencoba ulang dengan akun berikutnya saat satu akun gagal, serta menyediakan templat, kontak, kampanye, daftar berhenti berlangganan, dan callback Webhook. Paket gratis aktif secara default; paket berbayar ditagih dari saldo akun Anda.

Cara kerja

Platform tidak menyediakan layanan pengiriman maupun IP pengirim. Email dikirim melalui akun yang Anda hubungkan; platform memilih akun, mencoba ulang, menyimpan catatan, dan mengirim callback.

  1. Hubungkan akun pengirim: Tambahkan akun SMTP di konsol: host, port, enkripsi, nama pengguna, dan kata sandi (atau kata sandi aplikasi). Anda dapat menguji koneksi dan mengirim email uji terlebih dahulu. Kata sandi disimpan dalam bentuk terenkripsi.
  2. Buat kunci API: Buat kunci yang diawali smk_ dan kirimkan di header Authorization: Bearer. Anda dapat membuat beberapa kunci dan mencabut masing-masing secara terpisah.
  3. Panggil API pengiriman: Akun dipilih berdasarkan prioritas yang Anda tetapkan dan jumlah email yang sudah dikirimnya hari ini. Jika terjadi kegagalan autentikasi, kegagalan koneksi, atau kesalahan sementara, akun berikutnya dicoba, hingga 3 kali percobaan.
  4. Periksa hasilnya: Log pengiriman menampilkan status setiap email, akun yang digunakan, dan kesalahan jika ada. Setelah server penerima menerima email, email tersebut ditandai terkirim, dan peristiwanya dapat diteruskan ke Webhook Anda.

Fitur

  • Rotasi akun dan percobaan ulang: Akun dipilih berdasarkan prioritas dan volume hari ini, dan setiap akun dapat memiliki batas hariannya sendiri. Kegagalan akun dan kesalahan sementara dicoba ulang dengan akun lain; kesalahan yang tidak dapat diatasi oleh akun mana pun, seperti alamat yang tidak ada atau konten yang ditolak, tidak dicoba ulang. Anda juga dapat menetapkan agar suatu pengiriman hanya memakai satu akun.
  • Jeda dan pemulihan otomatis: Akun yang gagal 3 kali berturut-turut dijeda dan Anda diberi tahu. Setelah itu platform menguji koneksinya dengan interval yang makin panjang, dari 30 menit hingga 12 jam, dan baru mengembalikannya ke rotasi setelah pengujian berhasil. Akun yang Anda jeda sendiri tidak pernah diaktifkan kembali secara otomatis.
  • Templat dan variabel: Isi email HTML dan teks biasa dengan substitusi {{variable}}. Setiap penyimpanan mencatat satu versi, dan Anda dapat melihat riwayat versinya. API dapat mengirim berdasarkan kode templat.
  • Kontak dan kampanye: Impor kontak dari CSV (maksimal 10 MB per file) dan kelompokkan. Kampanye dikirim ke kelompok atau daftar, dapat dijadwalkan, dijeda, dan dibatalkan, serta otomatis melewati alamat yang telah berhenti berlangganan dan alamat yang dipantulkan.
  • Pelacakan buka dan klik, berhenti berlangganan sekali klik: Email HTML kampanye dapat mengaktifkan pelacakan buka dan klik, dan {{unsubscribe_url}} di isi email diganti dengan tautan berhenti berlangganan milik setiap penerima. Setiap email kampanye menyertakan header berhenti berlangganan sekali klik.
  • Daftar berhenti berlangganan dan pantulan: Alamat yang pernah dipantulkan atau mengajukan keluhan tidak menerima email apa pun lagi, termasuk email transaksional. Alamat yang mengeklik tautan berhenti berlangganan atau ditambahkan secara manual hanya dilewati untuk kampanye dan pengiriman massal, tidak untuk email transaksional seperti kode verifikasi dan pengaturan ulang kata sandi.
  • Callback peristiwa Webhook: Peristiwa terkirim, dibuka, diklik, dipantulkan, keluhan, berhenti berlangganan, dan lainnya diteruskan ke URL Anda dengan tanda tangan HMAC-SHA256. Peristiwa ini juga dapat langsung dikirim ke bot grup Slack, Discord, Feishu, DingTalk, dan WeCom.
  • Pemeriksaan domain pengirim: Memeriksa catatan SPF, DKIM, dan DMARC domain pengirim, lalu memberikan skor dan catatan DNS yang perlu ditambahkan.

Integrasi

API HTTP dengan isi permintaan JSON dan autentikasi kunci API. Di konsol, Anda juga dapat menulis satu email atau membuat kampanye tanpa kode.

  • POST /api/v1/smtp/send: Kirim satu email. Mendukung CC dan BCC, lampiran, gambar sisipan, alternatif teks biasa, header kustom, dan pengiriman terjadwal, dengan Idempotency-Key untuk mencegah pengiriman ganda.
  • POST /api/v1/smtp/send/batch: Kirim satu email ke masing-masing dari beberapa penerima dalam satu panggilan; batas jumlah penerima bergantung pada paket.
  • POST /api/v1/smtp/send/template: Kirim berdasarkan kode templat dan isi variabel templatnya.
  • GET /api/v1/smtp/status/{message_id}: Cek status pengiriman sebuah email.
  • GET /api/v1/smtp/quota: Cek sisa kuota hari ini dan bulan ini.
  • POST /api/v1/smtp/inbound: Laporkan pantulan atau keluhan; alamat tersebut ditambahkan ke daftar berhenti berlangganan.

Batasan

  • Maksimal 20 permintaan per detik per kunci API dan 60 per detik per akun.
  • Maksimal 20 lampiran per email, dengan total 15 MB setelah didekode.
  • Pengiriman terjadwal harus setidaknya 30 detik dari sekarang, dengan maksimal 500 email dalam antrean per akun.
  • Hanya API HTTP yang tersedia; akses melalui protokol SMTP tidak disediakan.

Aturan paket dan kuota

  • Paket gratis aktif secara default tanpa langganan, dan diperpanjang dengan sendirinya saat berakhir.
  • Kuota harian direset pada tengah malam di zona waktu akun Anda; kuota bulanan direset pada tanggal 1 setiap bulan.
  • Paket berbayar ditagih bulanan atau tahunan dari saldo akun Anda dan dapat diperpanjang di konsol sebelum berakhir. Paket berbayar tidak diperpanjang secara otomatis.
  • Saat paket berbayar berakhir, Anda kembali ke kuota dan fitur paket gratis. Akun yang terhubung, templat, dan kontak tidak dihapus.
  • Perubahan paket berlaku seketika. Sisa waktu paket lama yang belum terpakai dihitung sebagai kredit sesuai harga aslinya; kredit yang melebihi harga paket baru memperpanjang masa berlaku Anda, bukan dikembalikan sebagai dana. Penggunaan bulan ini terbawa ke paket baru.
  • Email dikirim melalui akun yang Anda hubungkan, sehingga masuk tidaknya ke kotak masuk bergantung pada reputasi akun tersebut dan domain pengirim Anda. Platform tidak menjanjikan tingkat keterkiriman.

Paket dan harga

PaketBulananTahunanEmail per hariEmail per bulanAkun pengirimPenerima per panggilan kirim massalTemplat emailKontakKampanye per bulanPemeriksaan domain pengirimEndpoint Webhook
GratisGratisGratis50010,0002100201,000Tidak termasuk1Tidak termasuk
Dasar$1.00/bln$10.00/thn5,000100,00051,00010020,0005053
Profesional$5.00/bln$50.00/thn50,0001,000,0002010,0001,000200,0005002020
Perusahaan$20.00/bln$200.00/thn200,0005,000,00010050,0009,9992,000,0009,999100100

Harga dalam USD dan merupakan harga standar sebelum masuk. Poin dapat menutup sebagian biaya; jumlah yang tertera di halaman pesanan adalah yang berlaku. Kuota dihitung berdasarkan jumlah email yang dikirim, dan pada pengiriman massal maupun kampanye, setiap penerima dihitung sebagai satu email.

Pertanyaan umum

Apa fungsi API SMTP terpadu?

Layanan ini memungkinkan Anda menghubungkan satu atau beberapa akun pengirim SMTP milik Anda sendiri dan mengirim email melalui satu API HTTP. Platform merotasi pengiriman di antara akun-akun tersebut, mencoba ulang dengan akun lain saat satu akun gagal, serta menyediakan templat, kontak, kampanye, daftar berhenti berlangganan, dan callback Webhook. Platform sendiri tidak menyediakan layanan pengiriman.

Apa yang saya perlukan?

Setidaknya satu akun pengirim yang dapat Anda gunakan untuk masuk melalui SMTP: SMTP dari penyedia email, email bisnis, atau server email Anda sendiri, semuanya bisa. Anda memerlukan host, port, nama pengguna, dan kata sandi (atau kata sandi aplikasi). Untuk kampanye, siapkan SPF, DKIM, dan DMARC untuk domain pengirim Anda terlebih dahulu.

Apa saja batasan paket gratis?

Volume pengiriman, akun pengirim, templat, dan kontak tercantum di tabel paket. Paket gratis tidak mencakup kampanye maupun Webhook; semua endpoint pengiriman lainnya dapat digunakan. Paket ini tidak memerlukan langganan dan tetap tersedia.

Bisakah Anda menjamin email masuk ke kotak masuk?

Tidak. Email dikirim melalui akun yang Anda hubungkan, dan pihak penerima menentukan apakah email masuk ke kotak masuk atau folder spam berdasarkan reputasi akun dan domain pengirim serta isi email. Platform dapat memeriksa catatan SPF, DKIM, dan DMARC domain Anda dan otomatis melewati alamat yang pernah dipantulkan atau mengajukan keluhan.

Bisakah saya terhubung ke platform langsung melalui SMTP?

Tidak. Yang tersedia hanya API HTTP, serta penulisan email dan pembuatan kampanye di konsol. Platform terhubung ke akun SMTP yang Anda tambahkan untuk mengirim email; platform tidak menyediakan relay SMTP.

Apa yang terjadi jika sebuah akun terus gagal?

Akun yang gagal 3 kali berturut-turut dijeda dan Anda diberi tahu, sementara akun Anda yang lain tetap mengirim. Setelah itu platform menguji koneksi akun tersebut secara berkala dan baru mengembalikannya ke rotasi setelah pengujian berhasil. Mengubah detail koneksinya atau mengaktifkannya sendiri juga langsung memulihkannya.

Bagaimana kuota dihitung, dan apa yang terjadi jika habis?

Kuota dihitung berdasarkan jumlah email yang dikirim, dan pada pengiriman massal maupun kampanye, setiap penerima dihitung sebagai satu email. Kuota harian direset pada tengah malam dan kuota bulanan pada tanggal 1 setiap bulan. Setelah kuota habis, API pengiriman menolak permintaan baru; tunggu hingga reset atau tingkatkan paket, yang berlaku seketika.

Bisakah saya menggunakannya dari klien AI?

Bisa. Setelah menghubungkan akun Anda di klien AI yang mendukung MCP, Anda dapat mengecek paket dan penggunaan, membaca log pengiriman, mengirim ke 1 hingga 10 penerima, serta mengelola kontak, templat, Webhook, dan domain pengirim. Perpanjangan memerlukan kode sekali pakai.

Halaman terkait: Perutean email masuk dan API pengiriman untuk domain · Email bisnis dengan domain Anda sendiri · Verifikasi SMS · API Surel SMTP · Menggunakan API agregasi SMTP

Memuat…