Dokumentasi & Ensiklopedia Sistem

MarbleSend mengandalkan satu eksekutor latar belakang: worker.php. Dashboard memeriksa cm_settings['worker_last_run'] untuk memverifikasi cron aktif setiap 60 detik.

Grafik pertumbuhan menampilkan distribusi volume kirim pada empat rentang waktu: 7 Hari, 30 Hari, 90 Hari, dan Tahun Berjalan (YTD). Setiap batang memperlihatkan jumlah terkirim dan terbuka saat disorot.

Feed kolom kanan menampilkan pengiriman Campaign terkini secara real-time, dilengkapi lencana status beranimasi (Completed, Sending berdenyut, Failed, Draft), rasio pengiriman, dan kartu status heartbeat sistem yang persisten.

Tabel audit bawah mencantumkan eksekusi siaran terkini dengan metadata lengkap: nama Campaign, status siklus hidup, penanda asal (manual, jadwal berulang, RSS feed, atau kirim ulang belum dibuka), rasio pengiriman penerima, dan tingkat buka terverifikasi.

Bila domain pengirim Anda belum memverifikasi record SPF, DKIM, atau DMARC, MarbleSend menampilkan banner peringatan tepat di atas metrik KPI. Mengklik Verifikasi DNS Domain membuka wizard diagnostik 4-langkah di /settings?tab=deliverability guna menjaga reputasi pengiriman Anda.

Pemicu tindakan langsung yang menghubungkan dashboard ringkasan dengan alur kerja berkecepatan tinggi: jadwal newsletter otomatis berulang, jalur ringkasan RSS-ke-email, akuisisi daftar kontak, verifikasi double opt-in, dan perlindungan supresi.

Saat broadcast sedang dikirim, banner pemantau muncul di bagian atas /campaigns. Banner ini melakukan polling ke /api/campaigns/:id/progress setiap 1,5 detik tanpa memuat ulang halaman.

Kolom kiri memungkinkan penargetan audiens secara presisi. Admin dapat memfilter berdasarkan tag kontak, mencari sebagian email/nama, dan memilih kontak satuan atau klik Pilih Semua yang Cocok.

Untuk mencegah kesalahan fatal (misal mengirim email dengan placeholder rusak, tanpa tautan berhenti langganan, atau memicu filter spam), MarbleSend mewajibkan cek preflight sebelum meluncurkan broadcast.

Sebelum mengantrekan ribuan email, tombol Kirim Email Tes langsung mengirimkan satu pesan uji coba ke kotak masuk admin atau QA tanpa menyentuh daftar kontak database. Semua tag placeholder ({{first_name}}, {{email}}, {{unsubscribe_link}}) diisi dengan nilai pratinjau simulasi agar Anda dapat meninjau tampilan email di Gmail, Apple Mail, dan Outlook.

Semua tag tautan keluar (<a href="...">) diproses lewat App\Services\TrackingInjector. Parameter UTM (utm_source, utm_medium, utm_campaign, utm_content) disisipkan otomatis sebelum URL dibungkus pelacak klik. Tautan mailto, tel, dan tautan unsubscribe dipertahankan utuh.

Portofolio riwayat lengkap menyediakan filter multi-atribut berdasarkan asal (manual, recurring, rss, resend_unopened), status (completed, sending, failed, draft), dan rentang tanggal. Admin dapat memilih banyak campaign untuk mengunduh log pengiriman CSV gabungan.

Pada /campaigns/:id/report, MarbleSend menyajikan laporan pasca-pengiriman yang komprehensif:

Repositori terpusat untuk semua template email pemasaran, transaksional, dan autoresponder. Dilengkapi filter pencarian instan di sisi klien, ID slug URL yang tidak dapat diubah, dan indikator status draf langsung.

Mesin email desktop modern (khususnya Microsoft Outlook yang menggunakan HTML Word) tidak mendukung CSS Grid atau Flexbox. MarbleSend menyertakan 8 layout responsif berbasis tabel yang telah teruji di Gmail, Outlook, Apple Mail, dan Yahoo:

Editor kode terfokus yang dirancang untuk pengembang email, menampilkan penangkapan indentasi Tab, telemetri jumlah karakter real-time, dan penormal spasi otomatis.

Mensimulasikan klien email desktop dan ponsel dalam kotak pasir iframe yang terisolasi, melindungi antarmuka dashboard dari style liar sekaligus memberikan umpan balik visual instan.

Saat pengiriman, mesin template mengganti token secara dinamis dengan atribut penerima, tautan pelacakan aman, ringkasan artikel RSS, dan Postingan berita.

Alat diagnostik berbasis modal yang memungkinkan pengirim mengirim email uji ke alamat penerima mana pun melalui profil SMTP yang dipilih sebelum penjadwalan atau penyiaran.

AI Copywriter terintegrasi yang beroperasi langsung via BYOK (Bring Your Own Key) untuk menghasilkan dan menyempurnakan template aman email berkonversi tinggi tanpa latensi proxy pihak ketiga.

Memindai baris subjek email di seluruh library template Anda, mengevaluasi probabilitas rasio buka, risiko filter spam, dan pemotongan karakter dengan saran varian 1-klik.

Tulis artikel di tab Postingan pada Template (Markdown dengan pratinjau langsung). Jadwal Newsletter yang diatur ke “Postingan berita” mengirim setiap postingan Siap satu kali, dari yang terlama, dengan mengisi placeholder {{news_posts}} di template-nya. Postingan hanya ada di email Anda — tidak ada halaman publik.

MarbleSend menyediakan dua tampilan operasional tersinkronisasi yang disesuaikan dengan kebutuhan alur kerja: Schedule Manager bergaya Bento (/schedules) yang ringkas dan Kalender Bulanan interaktif yang komprehensif (/schedules/list).

Jadwal berulang dijalankan oleh SchedulerService::computeNextRun(), yang meniadakan perhitungan manual demi matematika DateTimeImmutable PHP yang tangguh.

MarbleSend terhubung langsung ke feed blog atau konten Anda menggunakan SimpleXML dan cURL bawaan, mengubah artikel baru menjadi campaign otomatis tanpa alat integrasi pihak ketiga.

Tidak seperti snapshot campaign statis, siaran terjadwal menentukan daftar penerima secara dinamis pada detik yang sama saat occurrence terpicu.

Setiap eksekusi otomatis mencatat baris audit di tabel cm_schedule_occurrences, merinci waktu eksekusi, hasil, jumlah penerima, dan telemetri error.

Admin dapat melewati hitung mundur jadwal dan langsung memicu siaran seketika dari jadwal apa pun menggunakan aksi "Trigger Send Now".

MarbleSend memiliki parameter konkurensi tingkat enterprise yang dirancang khusus untuk mencegah siaran ganda di hosting hemat sumber daya.

Kartu Optimization Tip dinamis pada halaman Schedules menyajikan 8 rekomendasi operasional teruji untuk keandalan pengiriman di shared hosting:

Jadwal Newsletter kini dapat mengirim artikel, bukan satu template tetap. Atur Sumber konten ke “Postingan berita” dan setiap eksekusi mengirim Postingan Siap berikutnya dari Template → Postingan, disisipkan ke template lewat {{news_posts}}. Tidak ada yang dikirim jika tidak ada postingan yang menunggu.

1. 1Buka Template → Postingan lalu tulis artikel Anda dalam Markdown.
2. 2Buat atau buka template dan letakkan {{news_posts}} di tempat artikel harus muncul (starter “Newsletter Postingan Berita” sudah memilikinya).
3. 3Buka Jadwal → Baru, biarkan tipe Newsletter, dan atur Sumber konten ke “Postingan berita”.
4. 4Pilih template, audiens, profil SMTP, jumlah postingan per email (1–20), dan kadensinya.
5. 5Simpan. Hanya postingan yang menjadi Siap setelah saat ini yang dapat dikirim oleh jadwal ini.
6. 6Tandai postingan Siap. Eksekusi berikutnya — atau Jalankan sekarang — mengirimkannya.

• Beralih dari Hanya template ke Postingan berita menetapkan batas awal baru saat itu; beralih kembali menghapusnya.
• Menyimpan formulir jadwal memeriksa ulang bahwa template memuat {{news_posts}}. Jeda dan Lanjutkan hanya membalik sakelar aktif/nonaktif dan tidak pernah memeriksanya, jadi Anda selalu bisa menjeda.
• Supresi Pintar dimatikan otomatis pada mode Postingan berita: ia akan mengecualikan semua orang yang menerima edisi sebelumnya.
• Postingan berita hanya tersedia untuk jadwal Newsletter; jadwal RSS memakai logika feed-nya sendiri.

• Daftar jadwal memberi label “Postingan berita” alih-alih “Newsletter” pada jadwal ini.
• Panel detail menampilkan berapa postingan Siap yang menunggu untuk jadwal ini.
• Pada formulir, template tanpa {{news_posts}} ditandai, dan peringatan muncul jika Anda memilihnya.

MarbleSend memisahkan eksekusi campaign dari relai pengiriman melalui dua model transport yang tangguh: (1) Bring Your Own (BYO) SMTP untuk menghubungkan server mail mandiri Anda, dan (2) Relay Amazon SES Terkelola via admin.marblesend.com untuk pengiriman cloud kelas enterprise instan tanpa repot setup AWS. Mendukung Opsi 1 Friendly From (0 konfigurasi DNS) dan Opsi 2 Custom Domain Easy DKIM dengan penetapan harga dinamis dan manajemen kredit atomik.

# Check resolution via dig (macOS / Linux):
dig CNAME <token1>._domainkey.yourdomain.com +short

# Check resolution via nslookup (Windows / PowerShell):
nslookup -type=CNAME <token1>._domainkey.yourdomain.com

MarbleSend mengirim email di latar belakang. Cron job adalah pewaktu di panel hosting Anda yang membangunkan MarbleSend setiap menit supaya dapat menjalankan jadwal dan autoresponder, mengulang pengiriman yang gagal, mengumpulkan bounce, dan melanjutkan Campaign yang panjang. Campaign yang Anda kirim langsung dimulai, tetapi semua yang harus terjadi kemudian bergantung pada pewaktu ini. Jika Settings → Sistem menampilkan Cron Belum Terdeteksi, berarti pewaktu itu belum ada, tidak berjalan setiap menit, atau menunjuk ke tempat yang salah. Tiga langkah di bawah ini memperbaikinya.

Untuk pengguna teknis

Kompilasi email, resolusi query audiens, dispatch pengiriman, dan pemrosesan webhook berjalan asinkron melalui worker latar belakang 1-menit. MarbleSend menerapkan arsitektur dual-entrypoint (CLI worker.php atau HTTP cron.php) yang dilindungi oleh file lock non-blocking untuk mencegah eksekusi tumpang tindih di shared hosting.

* * * * * php /home/USER/your-folder/worker.php >/dev/null 2>&1

GET https://your-domain.com/cron.php?token=SECURE_TOKEN

MarbleSend dirancang sebagai platform self-hosted internasional. Dilengkapi 23 kamus bahasa native terkurasi manusia, pembalikan tata letak Right-to-Left otomatis untuk bahasa Arab, kustomisasi tema tri-state persisten, dan perimeter keamanan single-tenant yang tangguh.

REST API memungkinkan website eksternal, landing page, aplikasi mobile, dan plugin resmi WordPress MarbleSend Forms berinteraksi dengan aman ke database kontak dan mesin broadcast Anda. Kunci API menggunakan prefix kriptografis, penyimpanan SHA-256 satu arah, dan pembatasan scope kapabilitas.

Webhook menyediakan streaming event HTTP real-time ke endpoint eksternal, memungkinkan integrasi CRM, notifikasi Slack, atau automasi kustom merespons secara instan terhadap pendaftaran subscriber, pengiriman campaign, unsubscribe, dan hard bounce.

Deliverability email menentukan apakah pesan Anda masuk ke inbox subscriber atau dialihkan ke folder spam. MarbleSend menyediakan mesin inspeksi DNS bawaan yang menjalankan empat kueri berurutan non-blocking langsung ke nameserver otoritatif tanpa dependensi API pihak ketiga.

MarbleSend menyediakan mesin AI dual-mode yang fleksibel untuk copywriting, rekomendasi subject, dan audit skor spam: (1) Bring Your Own Key (BYOK) untuk terhubung langsung ke penyedia LLM terkemuka tanpa markup perantara, dan (2) MarbleSend AI Credits untuk akses instan pay-as-you-go ke model terbaik pilihan tanpa repot membuat akun developer atau mengelola API key.

MarbleSend memverifikasi keaslian produk menggunakan kriptografi asimetris Ed25519 via ekstensi native libsodium PHP. License Grant Token yang ditandatangani diterbitkan saat aktivasi awal dan divalidasi secara lokal tanpa kewajiban koneksi terus-menerus.

Plugin memanggil REST API MarbleSend lewat HTTPS, sehingga WordPress dan MarbleSend bisa berjalan di server berbeda. Plugin tidak punya akses ke database MarbleSend.

curl -X POST https://your-domain.com/api/contacts \
  -H "Authorization: Bearer ms_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"email":"visitor@example.com","name":"John Doe","tags":["newsletter","source:wpforms"]}'

MarbleSend yang lambat atau tidak terjangkau tidak boleh membuat form pengunjung macet atau kehilangan lead. Kiriman dari plugin form diantrekan dan dikirim di latar belakang.

// Non-blocking submission buffer in WordPress
set_transient('marblesend_forms_queue_' . wp_generate_uuid4(), $payload, 3600);
if (!wp_next_scheduled('marblesend_forms_process_queue')) {
    wp_schedule_single_event(time() + 5, 'marblesend_forms_process_queue');
}

Plugin menyertakan form berlangganan, sehingga Anda tidak memerlukan form builder. Pasang dengan shortcode, blok Gutenberg, atau widget. Ketiganya menjalankan kode yang sama.

[marblesend_form tags="newsletter,inbound" show_name="1" consent="I agree to receive email updates and accept the privacy policy."]

WPForms adalah salah satu form builder yang paling banyak dipakai. Plugin membaca kiriman setelah WPForms memvalidasinya, jadi Anda tidak memerlukan add-on WPForms.

add_action('wpforms_process_complete', function($fields, $entry, $form_data, $entry_id) {
    $email = $fields[1]['value'] ?? ''; // Numeric Field ID #1
    $name  = $fields[0]['value'] ?? ''; // Numeric Field ID #0
    MarbleSend_Integration_Base::dispatch('wpforms', $form_data['id'], $email, $name);
}, 10, 4);

Contact Form 7 mendefinisikan field sebagai tag dalam templat teks. Plugin terpasang setelah email form terkirim.

add_action('wpcf7_mail_sent', function($contact_form) {
    $submission = WPCF7_Submission::get_instance();
    $data = $submission ? $submission->get_posted_data() : [];
    $email = $data['your-email'] ?? '';
    $name  = $data['your-name'] ?? '';
    MarbleSend_Integration_Base::dispatch('cf7', $contact_form->id(), $email, $name);
}, 10, 1);

Plugin mendengarkan aksi yang dijalankan Fluent Forms setelah menyimpan entri.

add_action('fluentform/submission_inserted', function($entryId, $formData, $form) {
    $email = $formData['email'] ?? '';
    $name  = is_array($formData['names'] ?? null) ? implode(' ', $formData['names']) : ($formData['first_name'] ?? '');
    MarbleSend_Integration_Base::dispatch('fluentforms', $form->id, $email, $name);
}, 10, 3);

Plugin membaca entri tepat setelah Formidable Forms menyimpannya.

add_action('frm_after_create_entry', function($entryId, $formId) {
    $entry = FrmEntry::getOne($entryId, true);
    $email = $entry->metas[12] ?? $entry->metas['email-address'] ?? '';
    $name  = $entry->metas[11] ?? $entry->metas['full-name'] ?? '';
    MarbleSend_Integration_Base::dispatch('formidable', $formId, $email, $name);
}, 30, 2);

Plugin mendengarkan hook yang dijalankan Forminator saat memproses kiriman.

add_action('forminator_custom_form_submit_before_set_fields', function($formId, $response, $fieldData) {
    $fields = array_column($fieldData, 'value', 'name');
    $email  = $fields['email-1'] ?? '';
    $name   = $fields['name-1'] ?? '';
    MarbleSend_Integration_Base::dispatch('forminator', $formId, $email, $name);
}, 10, 3);

Menangkap email hanyalah langkah pertama. Tag menentukan apa yang terjadi pada kontak berikutnya.

{
  "email": "lead@agency.com",
  "name": "Jane Smith",
  "tags": ["source:wpforms", "ebook-download", "vip-inbound"],
  "consent_source": "api"
}