=== FALA — AI Customer Service Agent ===
Contributors: elav8
Tags: chatbot, ai, customer service, live chat, voice
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add your Fala AI customer-service agent to WordPress. Paste your agent key — no theme edits.

== Description ==

Fala (Elevate Follow-Up by Elav8) is a voice-first AI customer-service agent for your website.

This plugin connects your WordPress site to the **Fala service** (hosted at [fala.elav8.ai](https://fala.elav8.ai)). After you activate it and paste your agent key:

1. Open **Settings → Fala Agent**
2. Paste the **agent key** from your [Fala dashboard](https://fala.elav8.ai) (Build → Widgets, or the install guide)
3. Save — your agent appears on every public page

No theme file edits. Survives theme updates. Works with most caching plugins (purge cache after install if the agent does not appear immediately).

= Requirements =

* A free or paid [Fala](https://fala.elav8.ai) workspace
* Your widget **agent key** (public embed key)

= External service =

This is a SaaS connector. When an agent key is saved, the plugin loads Fala’s official loader script from your configured script origin (default `https://fala.elav8.ai/widget.js`) and visitor chat/voice traffic is handled by Fala’s servers according to your plan and settings.

* [Fala Terms](https://fala.elav8.ai/terms)
* [Fala Privacy Policy](https://fala.elav8.ai/privacy)

Saving an agent key under **Settings → Fala Agent** is your explicit consent to load that service on the public site. No script is injected until a key is present. The plugin does not inject “powered by” credit links.

== Installation ==

1. In WordPress go to **Plugins → Add New**
2. Search for **Fala** (or upload this plugin’s zip)
3. Click **Install Now**, then **Activate**
4. Go to **Settings → Fala Agent** and paste your agent key from the Fala dashboard
5. Visit your **public** site (not wp-admin) and confirm the agent launcher appears

== Frequently Asked Questions ==

= Where do I get the agent key? =

Sign in at [fala.elav8.ai](https://fala.elav8.ai), open **Build → Widgets**, or ask Fala’s Architect to show the install guide. Copy the public key (not your login password).

= The agent does not appear =

* Confirm the key is saved under **Settings → Fala Agent**
* Confirm your theme calls `wp_footer()` (almost all themes do)
* Purge any page cache / CDN cache
* View the **public** front-end, not the WordPress admin
* If you set **allowed domains** in Fala, make sure your site hostname is listed

= Can I use a one-click zip from the Fala dashboard? =

Yes. The dashboard can download a pre-configured zip of this same plugin with your key filled in. After WordPress.org listing, prefer installing from the directory and pasting the key.

== Screenshots ==

1. Settings → Fala Agent — paste your agent key
2. Public site with the Fala launcher (front-end only)
3. Fala dashboard install guide for WordPress

== Changelog ==

= 1.0.0 =
* Initial release: settings page, agent key, site-wide footer inject via wp_enqueue_script.
