=== Conversation Notifier for ElevenLabs Agents ===
Contributors: fahdaslam, wpventra
Tags: elevenlabs, ai, webhook, email, notifier
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 0.7.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Receive email alerts when an ElevenLabs Agent conversation ends. Secure via URL token or HMAC, with logs, rate limiting, and tidy summaries.

== Description ==
Conversation Notifier for ElevenLabs Agents listens for webhook events and sends a formatted email containing:

* Conversation status
* Agent ID
* End time & duration
* Call summary & title
* Termination reason & error
* Transcript messages
* Optional raw JSON payload

Also logs webhook events (last 50) for review in the WordPress admin.

Note: If you’re using a caching plugin or CDN (e.g., WP Rocket, Cloudflare), clear your cache after saving Conversation Notifier settings to ensure the updated webhook URL/token and email settings take effect.

⚠️ **Disclaimer:**  
This plugin is not affiliated with or endorsed by ElevenLabs. “ElevenLabs” is a trademark of Eleven Labs, Inc.


== Installation ==
1. Upload the `conversation-notifier-for-elevenlabs-agents` folder to `/wp-content/plugins/`.
2. Activate the plugin.
3. Go to **Settings → Conversation Notifier** to configure.
4. Copy the provided webhook URL (with `?el_token=...`) into your ElevenLabs Agent webhook settings.
5. Optionally set a Shared Secret for providers that support HMAC.

== Changelog ==

= 0.7.6 =
* Fix: Scoped email "From" filters to only apply to plugin-sent emails.

= 0.7.4 =
* Added Tools section with Send Test Email and Webhook Self-Test buttons.
* Added self-test handler and nonce-guarded admin notice.
* Auto-purge caches on settings update (WP Rocket, LiteSpeed, W3 Total Cache).
* Better default email From address and name for deliverability.
* Site Health test to nudge when Recipient Email isn’t set.

= 0.7.2 =
* Renamed plugin to comply with WordPress.org guidelines (trademark safe).
* Added proper permission_callback validation for REST API endpoint.
* Prefixed functions, constants, and options for uniqueness.
* General sanitization and escaping improvements.

= 0.7.0 =
* Added URL token security + IP rate limiting.
* Kept optional HMAC verification for other providers.

== Frequently Asked Questions ==
= Does this require a shared secret? =
No. ElevenLabs does not allow custom webhook secrets. Use the URL token provided by the plugin.

= Can I see the webhook payloads? =
Yes. Enable "Include Raw Payload" to include them in emails, and view them in Webhook Logs.