Kirim.id for WHMCS
==================

Isi paket
---------
1. modules/mail/KirimID/   — Mail provider "Kirim.id": semua email WHMCS (invoice, tiket, reset password,
                             notifikasi admin) dikirim lewat Kirim.id.
2. modules/addons/kirimid/ — Addon "Kirim.id – Sinkron Client": client yang setuju menerima email marketing
                             otomatis masuk ke Audience Kirim.id (semua client dan/atau per produk).

Kedua modul berdiri sendiri — pasang salah satu atau keduanya.
Syarat: WHMCS 8.x / 9.x, PHP 7.4 atau lebih baru, ekstensi cURL.

Cara pasang
-----------
1. Ekstrak zip ini di folder root WHMCS (folder yang berisi configuration.php).
   Folder modules/ di zip akan menyatu dengan folder modules/ WHMCS.

2. Mail provider
   - Buat API key di app.kirim.id → Email → Settings → API Key, dengan izin "Kirim Email".
   - Pastikan domain alamat pengirim WHMCS (System Settings → General Settings → Mail → Email address)
     sudah AKTIF di app.kirim.id → Email → Settings → Domains. Domain email departemen support juga.
   - WHMCS: System Settings → Mail Providers (WHMCS 8: General Settings → Mail → Configure Mail Provider)
     → pilih "Kirim.id" → isi API key → Test Configuration → Save.
   - Simpan pengaturan mail provider lama supaya bisa kembali kalau perlu.

3. Addon sinkron client
   - Buat API key dengan izin "Kelola Kontak/Audiens" (boleh API key yang sama kalau izinnya dua-duanya).
   - WHMCS: System Settings → Addon Modules → "Kirim.id – Sinkron Client" → Activate → Configure:
     isi API key, centang "Sinkron otomatis", beri akses ke role admin yang perlu → Save.
   - Buka Addons → Kirim.id – Sinkron Client: pilih audience tujuan, klik "Hitung dulu (simulasi)",
     lalu "Sinkron semua client" untuk memasukkan client lama.
   - Pastikan cron WHMCS berjalan (biasanya tiap 5 menit) — antrian diproses saat cron berjalan.

Catatan
-------
- Hanya client yang mencentang persetujuan email marketing dan tidak berstatus Closed yang dimasukkan.
  Persetujuan dicabut / akun ditutup / dihapus → otomatis dikeluarkan dari audience.
- Client yang berhenti berlangganan di email Kirim.id → persetujuan marketing-nya di WHMCS ikut dicabut
  (dicek tiap hari; bisa dimatikan di pengaturan addon).
- Email ke CC/BCC dikirim sebagai email terpisah; masing-masing memakai 1 koin.
- Seperti email API lain, Kirim.id menambahkan footer berhenti berlangganan dan pelacakan buka/klik.
- Log status tiap email ada di app.kirim.id; Email Log WHMCS hanya mencatat berhasil/gagal diterima Kirim.id.

Panduan lengkap: https://panduan.kirim.id
Bantuan: support@kirim.id
