Automator for n8n & AI

=== Automator for n8n & AI === Contributors: omelianenko993 Tags: n8n, automation, webhook, ai, openai Requires at least: 6.2 Tested up to: 7.0 Requires PHP: 8.0 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn plain-English descriptions into WordPress-to-n8n automations, or wire up a webhook to any WordPress event by hand — no code required.

== Description ==

Automator for n8n & AI connects WordPress events to an n8n webhook, so you can build automations ("when X happens in WordPress, send this to n8n") without writing any PHP.

There are two ways to create an automation:

• AI Playground — describe what you want in plain language (e.g. "Send data to n8n when a new post is published") and the built-in AI assistant (OpenAI or Gemini, using your own API key) turns it into a working automation.
• Manual Automation Builder — pick a WordPress event from a categorized list of 100+ hooks (posts, users, comments, WooCommerce orders, and more) and a webhook URL — no AI key needed.

Once created, the plugin automatically subscribes to the relevant WordPress hook and forwards the event as a JSON payload to your n8n webhook, enriching it with real data (user details, post details, order details) where available.

= Features =

• AI Playground — describe an automation in natural language and let the AI generate it.
• Manual Automation Builder — no AI key required; choose from a categorized list of WordPress hooks, filtered to only the plugins/integrations actually active on your site.
• Dynamic dispatcher — automatically hooks into any WordPress action stored in an automation and POSTs the event data to your n8n webhook.
• Payload enrichment — common events (user registration/profile updates, post publishing, WooCommerce orders) are hydrated with human-readable data, not just raw hook arguments.
• My Automations — a management screen listing every saved automation, with an active/inactive toggle, a per-automation webhook URL override, and edit/delete controls.
• Internal activity log — an optional Logs tab records every hook fire and webhook dispatch (success or failure) for troubleshooting; logging can be turned off entirely from Settings if you'd rather not keep a log.
• Test Connection / Test API Key — verify your n8n webhook and your LLM API key both work, directly from the Settings tab, before relying on them.

= Requirements =

• PHP 8.0 or higher
• A Gemini or OpenAI API key (only needed for the AI Playground — the Manual Automation Builder works without one)
• An n8n instance with a webhook URL

== Installation ==

1. Upload the automator-for-n8n-ai folder to /wp-content/plugins/, or install the plugin through the WordPress admin's "Add Plugin" screen.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to n8n Automator in the admin menu and open the Settings tab.
4. Paste your n8n webhook URL and (optionally) your Gemini/OpenAI API key, then save.
5. Create your first automation from the Playground (AI-generated) or My Automations (manual) screen.

== Frequently Asked Questions ==

= Do I need an OpenAI or Gemini API key? =

Only if you want to use the AI Playground to describe automations in plain language. The Manual Automation Builder lets you create automations by picking a WordPress event from a list, with no API key required.

= Where do I get an n8n webhook URL? =

In your n8n workflow, add a Webhook node and copy its Production URL. Paste that into the "n8n Base Webhook URL" field on the plugin's Settings tab.

= Can I turn off the internal activity log? =

Yes. There's a "Keep an internal log of automation activity" checkbox on the Settings tab — uncheck it and save to stop new entries from being recorded. Existing log entries are left untouched until you clear them from the Logs tab.

= What happens if I deactivate or delete the plugin? =

Deactivating leaves all your data intact. Deleting the plugin from the Plugins screen removes all of its settings, saved automations, and its internal log table.

= Does this plugin send data to external services? =

Yes, and only to services you've configured:

• If you use the AI Playground, the text you type and the resulting automation draft are sent to whichever LLM provider you selected (OpenAI or Google Gemini), using the API key you entered. This is subject to that provider's own terms and privacy policy — see OpenAI's privacy policy or Google's privacy policy.
• Every time an automation you created fires, the event's data (as described on the plugin's Instructions tab) is sent to the n8n webhook URL you configured, under your control.
• The "Test API Key" and "Test Connection" buttons on the Settings tab make a one-off request to your LLM provider or your n8n webhook, purely to confirm they're reachable.

No data is sent anywhere else, and nothing is sent automatically without an action you configured yourself.

== Screenshots ==

1. Settings tab — connect your n8n webhook and (optionally) your LLM API key.
2. AI Playground — describe an automation in plain language.
3. My Automations — manage, toggle, and edit your saved automations.

== Changelog ==

= 1.0.0 =

• Initial release.

== Upgrade Notice ==

= 1.0.0 = Initial release.