描述
ZH Webhooks for n8n sends WordPress events to your n8n webhook. It is not another Zapier clone, cookie banner, or cache plugin.
WordPress.org already has million-install plugins for GTM, consent, backups, and caching. It does not have a serious n8n webhook plugin. This one fills that gap:
- WordPress n8n — form submits (WPForms, Contact Form 7, Gravity Forms, Elementor, Fluent Forms, Ninja Forms), new users, published posts/pages, WooCommerce orders.
- Chat widget n8n — visitor messages wait for a
{"reply":"..."}response from a Respond to Webhook node (the commercial “WordPress AI chatbot” use case). Brand colors, radius, offsets, theme, launcher, and avatar are configurable in wp-admin. - n8n WordPress ping — signed inbound REST route for a connection check.
- HMAC + Header Auth —
X-ZH-N8N-Keyfor n8n Header Auth, plusX-ZH-N8N-Signature(sha256=HMAC(timestamp + "." + raw body)). - Delivery logs — last 200 sends, payload kept only until success so retries work.
- No n8n Cloud lock-in — any self-hosted or Cloud webhook URL.
This plugin is not affiliated with n8n GmbH.
Need the workflow installed on a client site? See n8n WordPress automation.
屏幕截图

X-ZH-N8N-Key), and a test ping.



安装
- Upload the
zh-webhooks-for-n8nfolder to/wp-content/plugins/. - Activate ZH Webhooks for n8n.
- Open ZH Webhooks in wp-admin.
- Paste your n8n Production webhook URL and copy the shared secret into n8n Header Auth (
X-ZH-N8N-Key). - Send a test ping, then enable the events you need.
- Optional: open the Chat tab to style the widget and enable it site-wide or via
[zh_n8n_chat].
常见问题
-
Does this replace Uncanny Automator or Bit Integrations?
-
No. Those are generic “connect 400 apps” products. This plugin only talks to n8n with a stable JSON envelope and HMAC.
-
Can I put AdSense in this plugin?
-
No. WordPress.org plugins cannot be an ad network. Monetize by booking implementation work or a later Pro license.
-
What JSON does n8n receive?
-
{ “id”, “event”, “timestamp”, “site”: { “name”, “url”, “timezone” }, “data”: { … } } plus headers
X-ZH-N8N-Event,X-ZH-N8N-Timestamp,X-ZH-N8N-Signature,X-ZH-N8N-Key. -
How does chat work?
-
The widget POSTs to WordPress REST. WordPress forwards
chat.messageto n8n and waits. Your workflow must use Respond to Webhook with{"reply":"text"}. Other events are queued asynchronously so checkout stays fast. -
Why does live chat say it cannot reach n8n?
-
The webhook URL is empty, not HTTPS, or not reachable from the server.
http://127.0.0.1on your laptop is not reachable from Hostinger. Use n8n Cloud or another public HTTPS webhook. -
Is WooCommerce required?
-
No. Order events fire only when WooCommerce is active.
评价
此插件暂无评价。
贡献者及开发者
更新日志
1.0.0
- Initial release: outbound form, user, post, and WooCommerce events to n8n.
- HMAC-signed webhooks, delivery logs, and inbound ping.
- n8n chat widget with brand colors, radius, offsets, theme, launcher, and live admin preview.
- Chat mounts even when JS delay plugins (e.g. LiteSpeed) are active.
