
This document outlines common ways our customers use Bird for general integration. These integrations cover essential topics like “how do I send email?” and “how do I know what happened to the email?”
Dokumen ini menjelaskan cara umum pelanggan kami menggunakan Bird untuk integrasi umum. Integrasi ini mencakup topik penting seperti “bagaimana cara mengirim email?” dan “bagaimana saya tahu apa yang terjadi pada email?” Untuk organisasi yang mempertahankan pengaturan hybrid on-premises dan cloud dengan persyaratan keamanan, panduan implementasi S/MIME untuk platform on-premises kami mencakup konfigurasi PowerMTA dan Momentum untuk pengiriman email yang aman. Jika Anda beralih dari Postfix, Sendmail, atau Exim, dokumen ini harus menjelaskan segala yang perlu Anda ketahui tentang dasar-dasar mengirim dan melaporkan email. Sisa dokumen ini mengasumsikan Anda memiliki akun SparkPost yang ada.
Bagaimana cara mengirim email?
Bird akan menerima email untuk ditransfer dalam beberapa cara. Cara yang paling umum adalah SMTP (Simple Mail Transfer Protocol) dan Bird mempresentasikan dirinya persis seperti agen email aman lainnya di port 587. Jika Anda saat ini memiliki perangkat lunak generasi atau mail merge yang membuat email untuk pengiriman, Bird akan menerimanya sebagai pesan SMTP standar dan mencoba mengirimkannya. Anda akan memerlukan sistem dengan sertifikat TLS yang valid yang dapat menghasilkan pesan SMTP dan mengirimkannya melalui port 587. Postfix, Sendmail, dan Exim semuanya memiliki kemampuan ini secara native.
Contoh 1:
Anda memiliki server web yang menghasilkan pesan gabungan untuk pengiriman email melalui Postfix.
· Sesuaikan perangkat lunak generasi server web untuk mengirim pesan SMTP ke server SparkPost yang telah ditentukan daripada server Postfix
· Ya, memang sesederhana itu
Contoh 2:
Anda memiliki beberapa kode manajemen yang perlu menggunakan fungsi “Mail” server lokal.
· Jika Anda menggunakan Sendmail, edit file /etc/mail/sendmail.mc untuk menambahkan definisi “smart-host”.
IE: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Jika Anda menggunakan Postfix, edit file /etc/postfix/transport untuk menambahkan definisi relay smtp.
IE: * smtp:MyMessageBirdServer.com
· Pastikan Anda mengaktifkan TLS dan mengatur port keluar Anda ke 587.
· Terapkan perubahan dan restart layanan email lokal
· Eksekusi kode manajemen, dan email akan diarahkan ke MessageBird untuk pengiriman
Bagaimana dengan suntikan REST?
Untuk pelanggan yang menggunakan HTTP(S) untuk mengangkut data dalam jaringan mereka, mengonversi pesan ke SMTP bisa merepotkan. Bird memiliki REST API yang komprehensif yang dapat menerima template JSON, daftar penerima, dan data substitusi melalui HTTPS dan kemudian mengonversinya menjadi email yang dihasilkan (digabungkan) untuk dikirim ke dunia melalui SMTP standar. Ini sangat membantu untuk mengalihkan pekerjaan generasi dari server web ke mesin email.
Contoh:
Server Anda menghasilkan buletin ke 50.000 penerima setiap hari yang menggabungkan data pribadi kemudian mengirimkan masing-masing melalui Postfix.
· Buat objek JSON untuk penerima, data substitusi, dan template konten.
· Gunakan REST API untuk mengirim POST objek JSON ke Transmission API Bird. Melakukan ini mengalihkan proses generasi ke SparkPost untuk pengiriman yang lebih cepat.
· Anda bahkan dapat menempatkan JSON dalam file dan menggunakan cURL:
curl -v -H "Content-Type: application/json" -X POST \ https://api.bird.com/api/v1transmissions -d@./newsletter.json
Bagaimana saya mendapatkan informasi pengiriman?
Bird mengumpulkan banyak informasi pengiriman dan membuatnya tersedia untuk Anda dalam format JSON yang dapat “didorong” sebagai webhook atau “ditarik” dengan panggilan API. Data untuk pengiriman tampak seperti ini:
{ "campaign_id":"Welcome_Letter", "customer_id":"108", "delv_method":"esmtp", "event_id":"84769964978165188", "friendly_from":"bounce@sp-send.com", "ip_address":"50.116.50.117", "ip_pool":"default", "message_id":"00046a82565a6d39451a", "msg_from":"abc-bounces-108@sp-send.com", "msg_size":"2164", "num_retries":"0", "queue_time":"1759", "raw_rcpt_to":"fakespark+32@deadboltemail.com", "rcpt_meta":{ }, "rcpt_tags":[ ], "rcpt_to":"fakespark+32@deadboltemail.com", "routing_domain":"deadboltemail.com", "sending_ip":"52.38.47.118", "subject":"Welcome Letter Template", "tdate":"2018-01-10T21:15:24.000Z", "template_id":"welcome-letter", "template_version":"5", "transmission_id":"84769964922735103", "type":"delivery", "timestamp":"2018-01-10T14:15:24.000-07:00" }
Itu mungkin lebih banyak data daripada yang biasa Anda lihat dalam log Postfix dan sudah dalam format yang mudah digunakan. Relatif mudah untuk mengonversi data JSON itu ke format log Postfix jika diperlukan. Data pengiriman, bounce, reject, spam_complaint, open, click, dan delay dapat dibaca dengan cara yang sama.
Contoh:
1) Anda biasanya mengekspor log Postfix ke Excel sehingga Anda dapat mengurutkan dan menganalisis.
A) Eksekusi panggilan message_events API dan jalankan data JSON yang dihasilkan melalui JSON2CSV.
2) Anda suka mengonversi log Postfix Anda ke JSON, kemudian menariknya ke layanan web untuk dibaca dan dianalisis.
A) Gunakan API metrik MessageBird untuk mempolling SparkPost untuk data yang Anda butuhkan, dan secara otomatis diekspor sebagai JSON
3) Anda memiliki proses terpisah yang mengikuti dan mengurai log secara real-time dan memperbarui basis data penerima terpisah.
A) SparkPost dapat menyediakan webhook real-time yang dapat memberi makan proses Anda pelaporan spam_complaintants dan berhenti berlangganan secara khusus untuk tujuan ini. Implementasinya mudah.
-Tom