Apidog

Platform Pengembangan API Kolaboratif All-in-one

Desain API

Dokumentasi API

Debug API

Mocking API

Pengujian Otomatis API

Mengirim Email dengan Postmark API dan Node.js

Sederhanakan email dengan API Postmark. Pesan terkirim, bukan spam. Analitik detail & integrasi Node.js mudah. Tingkatkan pemasaran email Anda!

Ardianto Nugroho

Ardianto Nugroho

Updated on April 15, 2025

Di era pesan instan dan media sosial, mudah untuk meremehkan kekuatan email. Namun, email tetap menjadi saluran komunikasi penting bagi bisnis dan individu. Email mendorong keterlibatan merek, menyampaikan pembaruan penting, dan memfasilitasi interaksi yang dipersonalisasi. Namun, efektivitas email bergantung pada satu faktor penting: kemampuan pengiriman. Metode pengiriman email tradisional seringkali bermasalah dengan filter spam dan tingkat kotak masuk yang rendah, membuat pesan Anda tergeletak di jurang digital.

Di sinilah Postmark hadir. Sebagai layanan API email transaksional yang ramah pengembang, Postmark memberdayakan Anda untuk mengirim email dengan percaya diri. Layanan ini menyederhanakan proses, memastikan pesan Anda sampai ke penerima yang dituju sambil memberikan wawasan berharga tentang kinerja email.

Apa itu Postmark?

Postmark adalah layanan API email transaksional berbasis cloud. Ini berarti layanan ini beroperasi sepenuhnya secara online, menghilangkan kebutuhan untuk mengelola server atau perangkat lunak email Anda sendiri. Berikut adalah rincian istilah-istilah penting:

Berbasis cloud: Infrastruktur Postmark berada di server jarak jauh, dapat diakses melalui internet. Anda tidak perlu menginstal atau memelihara perangkat lunak apa pun di mesin Anda sendiri.

Email Transaksional: Email transaksional adalah email yang dikirim ke pengguna tergantung pada tindakan yang mereka lakukan di situs web atau aplikasi Anda. Postmark berfokus pada email yang dipicu oleh tindakan pengguna tertentu dalam aplikasi. Email ini biasanya pesan satu-ke-satu yang dipersonalisasi, seperti:

  • Konfirmasi pengaturan ulang kata sandi
  • Konfirmasi pesanan dan tanda terima
  • Email verifikasi akun
  • Email notifikasi (misalnya, peringatan keamanan, pengingat janji temu)

Layanan API: API adalah singkatan dari Application Programming Interface. Ini adalah seperangkat alat dan instruksi yang memungkinkan aplikasi Anda berkomunikasi dengan Postmark. Menggunakan Postmark API, Anda dapat dengan mudah mengintegrasikan fungsionalitas pengiriman email ke dalam aplikasi Node.js Anda hanya dengan beberapa baris kode.

Mengapa Memilih Postmark?

Intinya, Postmark menyederhanakan dan merampingkan pengiriman email untuk pengembang dan bisnis dengan:

  • Dalam hal mengirim email transaksional, metode tradisional seperti webmail atau server Anda sendiri bisa jadi rumit dan tidak dapat diandalkan. Di sinilah Postmark bersinar. Layanan ini menawarkan banyak keuntungan dibandingkan metode ini:
  • Peningkatan Kemampuan Pengiriman: Ini bisa dibilang kekuatan terbesar Postmark. Metode pengiriman email tradisional seringkali bermasalah dengan filter spam dan tingkat kotak masuk yang rendah. Postmark menawarkan kemampuan pengiriman terdepan di industri berkat:
  • Teknik perutean tingkat lanjut: Postmark secara cerdas merutekan email Anda melalui jaringan yang dioptimalkan untuk kemampuan pengiriman.
  • Manajemen reputasi: Postmark mempertahankan reputasi murni dengan penyedia email, memastikan email Anda cenderung tidak ditandai sebagai spam.

Analitik Terperinci: Lewat sudah hari-hari mengirim email secara membabi buta tanpa mengetahui dampaknya. Postmark menyediakan laporan dan wawasan komprehensif tentang kinerja email Anda. Anda dapat melacak metrik seperti Tingkat Buka, CTR, dan Tingkat Pentalan.

Analitik ini memberdayakan Anda untuk mengoptimalkan konten email Anda, meningkatkan keterlibatan, dan mengidentifikasi masalah pengiriman apa pun yang mungkin perlu ditangani.

Pengembangan yang Disederhanakan: Mengintegrasikan fungsionalitas email ke dalam aplikasi Anda bisa menjadi sakit kepala dengan metode tradisional. API Postmark yang mudah digunakan membuat proses ini menjadi mudah. Hanya dengan beberapa baris kode, Anda dapat memanfaatkan kemampuan pengiriman email Postmark yang kuat dalam aplikasi Anda. Hal ini memungkinkan pengembang untuk fokus pada fungsionalitas inti tanpa terjebak dalam kompleksitas email.

Keamanan yang Ditingkatkan: Keamanan sangat penting saat berurusan dengan data pengguna. Postmark memprioritaskan keamanan data dengan menerapkan langkah-langkah keamanan yang kuat untuk melindungi informasi Anda dan penerima Anda. Mereka mematuhi standar dan peraturan industri untuk memastikan data Anda tetap aman.

Singkatnya, Postmark menawarkan paket menarik bagi bisnis dan pengembang yang membutuhkan cara yang andal, aman, dan berbasis data untuk mengirim email transaksional. Layanan ini menyederhanakan proses, meningkatkan kemampuan pengiriman, dan memberikan wawasan berharga untuk mengoptimalkan upaya pemasaran email Anda.

Cukup basa-basinya, mari kita mulai mengirim email dengan Postmark API & Node.js!

Mengirim Email dengan Postmark API dan Node.js

Prasyarat: Tentang Kunci API Postmark

Sebelum kita dapat melanjutkan, sangat penting bagi Anda untuk sudah memiliki akun dengan Postmark. Pada saat artikel ini ditulis, sayangnya Postmark tidak mengizinkan pembuatan akun menggunakan Google, Yahoo, atau domain publik lainnya. Ini berarti Anda HARUS menggunakan nama domain Anda untuk membuat akun. Contohnya sam@samuelblog.com Jadi pastikan untuk membuat akun Anda, verifikasi domain Anda, dan dapatkan kunci API Anda. Kita membutuhkan kunci itu untuk mengirim email.

Saat Anda membuat akun, akun tersebut akan berada dalam mode pengujian. Anda kemudian perlu meminta persetujuan untuk menikmati semua layanan mereka.

Kita juga membutuhkan alat untuk menguji API yang akan kita buat. Kita perlu tahu apa respons dan statusnya. Untuk ini, saya akan menggunakan alat pengujian API yang disebut Apidog untuk menguji pengaturan ini.

Apidog adalah alat lengkap untuk pengembangan API yang menangani perancangan, debugging, dokumentasi, pengujian, dan mocking.
An Image of Apidog's homepage
button

Saat Anda membuat akun, Anda akan diberi folder proyek otomatis tempat Anda dapat menguji berbagai API. Anda dapat merujuk ke dokumentasi ini untuk mempelajari tentang Apidog dan cara kerjanya.

Jika Anda sudah mengerjakan aplikasi Node.js, Anda perlu menginstal Postmark Node.js SDK menggunakan npm: npm install postmark --save dan itu akan menginstal paket untuk kita.

Jika Anda belum memiliki direktori kerja, silakan buat menggunakan mkdir. Sekarang jalankan npm init -y untuk menginisialisasi npm. Setelah Anda melakukannya, jalankan npm install express postmark --save dan buka folder itu di editor kode favorit Anda - vsCode untuk sebagian besar dari kita.

Sekarang buat file index.js atau server.js. File itu akan menyimpan semua logika kode kita untuk mengirim email menggunakan Postmark API.

Buka file server.js itu dan tempel kode berikut;

const express = require("express");

const app = express();
app.disable("x-powered-by"); // menyembunyikan server express.
app.use(express.json());

app.post("/send-email", (req, res) => {
  res.send("Send email endpoint hit!");
});

app.listen(8080, () => {
  console.log(`Backend server listening on port 8080`);
});

Kode di atas hanyalah pengaturan node.js sederhana. Pastikan untuk menyimpannya, dan mulai server node.js menggunakan node server.js.

Kita perlu menguji rute yang dibuat dan untuk melakukan ini, saya akan menggunakan Apidog. Buka aplikasi, baik di browser Anda atau komputer Anda, dan klik New project untuk membuat proyek baru, atau klik proyek default yang ditugaskan kepada Anda.

Apidog project page

Klik proyek yang Anda buat atau yang ditugaskan kepada Anda dan klik tombol "New Request" untuk mengirim permintaan pertama Anda.

Di Apidog, ketik rute di bidang input, dan klik "Run" untuk melihat respons.

Apidog response page

Anda dapat melihat bahwa respons di badan cocok dengan respons yang kami kirim di rute yang kami definisikan. Itu menunjukkan bahwa aplikasi kita berfungsi, dan sekarang kita perlu melanjutkan dan mengirim email!

Selanjutnya, buka file server.js dan perbarui basis kode dengan yang berikut;

const express = require("express");
const postmark = require("postmark");

const app = express();
app.disable("x-powered-by"); // menyembunyikan server express.
app.use(express.json());

const client = new postmark.ServerClient(
  "acXXXXXXX_XXX" // Anda dapat menggunakan file .env
);

app.post("/send-email", async (req, res) => {

  try {
    await client.sendEmail({
      From: "iroro@yourdomain.com",
      To: "test@blackhole.postmarkapp.com",
      Subject: "Hello from Postmark",
      HtmlBody: "<strong>Hello</strong> dear Postmark user.",
      TextBody: "Hello from Postmark!",
      MessageStream: "outbound",
    });
    res.send("Email sent successfully!");
  } catch (error) {
    console.error("Error sending email:", error);
    res.status(500).send("Error sending email"); // Tangani respons kesalahan
  }
});

app.listen(8080, () => {
  console.log(`Backend server listening on port 8080`);
});

Kode diperbarui dengan Postmark SDK. Kami menggunakan kunci API kami untuk mengirim permintaan ke Postmark untuk memverifikasi bahwa kami membuat permintaan. Kami juga menggunakan try catch jika kami mengalami kesalahan, catat kesalahan dan lihat dari mana kesalahan itu berasal.

Jika Anda memiliki kode ini, simpan file dan mulai ulang server node Anda. Setelah itu, kembali ke Apidog dan kirim permintaan baru ke endpoint /send-email.

Jika semuanya berjalan dengan baik untuk Anda, Anda seharusnya dapat mengirim email menggunakan Postmark API langsung dari aplikasi Node.js Anda!

Untuk mengonfirmasi bahwa ini berhasil, Anda dapat melihat log Anda atau memeriksa email yang Anda kirim ke, jika Anda telah memverifikasi akun Anda dan itu akan berfungsi dengan baik untuk Anda.

Postmark email logs

Batas Pengiriman Postmark API

Postmark memprioritaskan pengiriman email yang lancar dan andal untuk semua pengguna. Meskipun mereka tidak memberlakukan batas pengiriman harian yang ketat untuk email siaran, mereka memiliki langkah-langkah untuk memastikan praktik pengiriman yang bertanggung jawab. Berikut adalah rinciannya:

Pengiriman Batch:

  • Maksimum Pesan: Hingga 500 email dapat dikirim dalam satu panggilan API menggunakan endpoint batch.
  • Ukuran Payload: Ukuran total payload, termasuk lampiran, tidak boleh melebihi 50 MB per panggilan API.

Aliran Pesan Siaran:

  • Fokus pada Reputasi: Tidak seperti batas harian, Postmark memantau kesehatan Aliran Pesan Siaran Anda berdasarkan dua metrik utama:
  • Tingkat Keluhan Spam: Pertahankan tingkat keluhan spam di bawah 0,1% untuk menghindari peringatan.
  • Tingkat Pentalan: Jaga tingkat pentalan Anda di bawah 10% untuk memastikan pengiriman yang optimal.

Pemantauan dan Peringatan:

  • Indikator Kode Warna: Postmark menggunakan sistem kode warna di dalam akun Anda untuk secara visual mewakili kesehatan Aliran Pesan Siaran Anda:
  • Oranye: Tingkat keluhan spam atau tingkat pentalan Anda mendekati batas.
  • Merah: Tingkat keluhan spam atau tingkat pentalan Anda telah melebihi batas. Ini berpotensi memengaruhi kemampuan pengiriman Anda.

Praktik Terbaik untuk Pengiriman Optimal:

  • Distribusikan Pengiriman: Menyebarkan email sepanjang hari dalam semburan umumnya lebih disukai daripada mengirim volume besar sekaligus.
  • Pantau Volume Anda: Lacak volume pengiriman email harian dan per jam Anda. Jika Anda mengantisipasi peningkatan yang signifikan, hubungi dukungan Postmark untuk membahas kebutuhan Anda.
  • Optimalkan Email Anda: Pastikan format email yang tepat dan hindari konten yang bersifat spam. Tingkat pentalan atau keluhan spam yang tinggi dapat memengaruhi kesehatan akun Anda.

Dengan mengikuti panduan ini dan mempertahankan praktik pengiriman yang bertanggung jawab, Anda dapat memanfaatkan API email Postmark secara maksimal dan memastikan email Anda sampai ke audiens yang dituju.

Kesimpulan

Sebagai kesimpulan, Postmark API dan Node.js menawarkan solusi yang kuat dan mudah digunakan untuk mengirim email. Dengan fokusnya pada kemampuan pengiriman, analitik yang mendalam, dan pengembangan yang disederhanakan, Postmark memberdayakan Anda untuk merampingkan komunikasi email Anda dan memastikan pesan Anda sampai ke audiens yang dituju. Jelajahi Postmark hari ini dan buka potensi pengiriman email yang andal dan efektif.

Selamat Membuat Kode!

Cara Menggunakan Lovable AI (Alternatif Cursor untuk Pengembang Web)Tutorial

Cara Menggunakan Lovable AI (Alternatif Cursor untuk Pengembang Web)

Pelajari cara buat web apa pun dgn Lovable. Panduan lengkap, fitur inovatif, & integrasi Apidog (API gratis).

Ardianto Nugroho

April 15, 2025

Cara Menambahkan Kunci API Kustom ke Cursor: Panduan KomprehensifTutorial

Cara Menambahkan Kunci API Kustom ke Cursor: Panduan Komprehensif

Tutorial ini memandu Anda menyiapkan & mengelola API key khusus di Cursor: OpenAI, Anthropic, Google, & Azure.

Ardianto Nugroho

April 11, 2025

Cara Menggunakan NVIDIA Llama Nemotron API untuk Agen AI Tingkat LanjutTutorial

Cara Menggunakan NVIDIA Llama Nemotron API untuk Agen AI Tingkat Lanjut

Pelajari API NVIDIA Llama Nemotron utk buat agen AI canggih.

Ardianto Nugroho

April 11, 2025