=== Volara CRM & WhatsApp ===
Contributors: volara
Tags: whatsapp, crm, woocommerce, chat, leads
Requires at least: 6.0
Tested up to: 6.5
Requires PHP: 8.0
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Hubungkan toko WordPress / WooCommerce ke Volara: tangkap lead jadi kontak CRM, kirim notifikasi pesanan via WhatsApp, dan pasang widget chat omnichannel.

== Description ==

Volara CRM & WhatsApp menghubungkan situs WordPress dan toko WooCommerce Anda ke akun Volara dalam hitungan menit, tanpa perlu developer. Cukup tempel API key, aktifkan fitur yang Anda butuhkan, lalu simpan.

Connect your WordPress or WooCommerce store to Volara in minutes — no developer required. Paste your API key, switch on the features you want, and save.

**What it does**

* **Lead capture** — pelanggan yang checkout di WooCommerce atau mengisi form Contact Form 7 otomatis tersimpan sebagai kontak di Volara CRM (nama, email, nomor telepon).
* **WhatsApp order notifications** — kirim pesan WhatsApp ke pelanggan saat status pesanan WooCommerce berubah (diproses, selesai, dibatalkan, refund).
* **Chat widget** — tampilkan launcher chat omnichannel Volara di seluruh halaman depan situs dengan satu baris skrip, memakai widget key publik.
* **Developer-friendly** — filter `volara_capture_lead` untuk mengirim lead dari sumber lain, plus filter untuk menyesuaikan pesan dan payload notifikasi.

The Volara PHP SDK is bundled inside the plugin, so it runs on any host without Composer. Your secret API key is stored server-side and is never exposed in the browser; the chat widget uses a separate public widget key.

== Installation ==

1. Unggah folder `volara-crm` ke direktori `/wp-content/plugins/`, atau pasang plugin lewat menu Plugins di WordPress.
2. Aktifkan plugin melalui menu **Plugins**.
3. Buka **Settings → Volara**.
4. Tempel **API Key** Volara Anda (ambil dari dashboard Volara: Settings → API keys). Biarkan **Base URL** apa adanya kecuali Anda self-host.
5. Klik **Test connection** untuk memastikan key valid.
6. Aktifkan fitur yang Anda mau: lead capture, notifikasi WhatsApp, dan/atau chat widget. Untuk widget, isi **Widget key (public)**.
7. Simpan.

== Frequently Asked Questions ==

= Apakah saya butuh akun Volara? =

Ya. Plugin ini menghubungkan situs Anda ke akun Volara. Buat akun di https://volara.chat dan ambil API key dari dashboard.

= Apakah saya perlu Composer di server? =

Tidak. SDK PHP Volara sudah disertakan (vendored) di dalam plugin dan dimuat lewat autoloader internal.

= Apakah harus pakai WooCommerce? =

Tidak. Lead capture dari Contact Form 7 dan chat widget berjalan tanpa WooCommerce. Notifikasi pesanan dan lead dari checkout hanya aktif jika WooCommerce terpasang.

= Apakah API key saya aman? =

API key disimpan di database WordPress (server-side) dan tidak pernah ditampilkan kembali secara penuh atau dikirim ke browser. Chat widget memakai widget key publik yang terpisah, bukan API key rahasia.

= Bagaimana nomor telepon diformat? =

Plugin mencoba menormalkan nomor ke format E.164. Nomor lokal Indonesia (diawali 0) dikonversi ke awalan +62.

= Bisakah developer mengirim lead dari sumber lain? =

Bisa. Panggil `apply_filters( 'volara_capture_lead', array( 'name' => '...', 'email' => '...', 'phone' => '...', 'source' => '...' ) );` dari kode Anda.

== Changelog ==

= 0.1.0 =
* Initial release (MVP).
* Settings page with API key, base URL, default channel, and feature toggles.
* Test-connection button (AJAX) using the Volara metrics endpoint.
* Lead capture from WooCommerce checkout and Contact Form 7, plus a `volara_capture_lead` filter.
* WhatsApp order-status notifications via WooCommerce.
* Embeddable chat widget injection using a public widget key.
* Bundled Volara PHP SDK (no Composer needed at runtime).

== Upgrade Notice ==

= 0.1.0 =
First public MVP release.