@vitrion/n8n-nodes-zentria

Community node for Zentria. It starts workflows from signed team webhooks and writes back through the public team API.

n8n Cloud only runs verified community nodes. Until this package is verified, install it on self-hosted n8n.

Release (npm)

Publish from this repo (vitrionbv/n8n-nodes-zentria), not from ZentriaApp.

1. Bump package.json version, commit to main.
2. Tag X.Y.Z (example: 0.1.7) and push that tag.
3. GitHub Action Publish (.github/workflows/publish.yml) runs npm run release with OIDC provenance.

Do not add a publish workflow to ZentriaApp. Do not tag n8n-nodes-v* on the parent app. Do not npm publish from a laptop.

Install (self-hosted)

npm install @vitrion/n8n-nodes-zentria

Or in n8n: Settings → Community nodes → Install @vitrion/n8n-nodes-zentria.

Requires a Zentria team API key (Teams → API keys) with the scopes you need (webhooks:write for the Trigger, plus sales:* / crm:* / … for actions).

Credentials

The credential test calls GET /api/public/me. That response includes the bound team and modules (sales_cms, crm_leads, speed_to_lead, todos, business_profiles). Sales locators stay empty when Sales is off.

Zentria Trigger

On activate, the node registers an HTTPS webhook on the PAT team (POST /api/public/webhooks, source: n8n). On deactivate it deletes that endpoint. Duplicate activate with the same URL + events reuses the existing endpoint.

The picker includes sales, CRM (including crm.campaign.month_closed), customer, sales notes and activities, todo, 9 Business Profile events (business_profile.review.*, business_profile.review_reply.*, business_profile.location_change.*, business_profile.post.*, business_profile.account.needs_reauth), customer events (customer.created, customer.updated, customer.archived, customer.restored), campaign events (campaign.archived, campaign.restored), and 13 invoice events (invoice.created through invoice.cancelled, plus invoice.reminder.*).

Incoming deliveries are checked with Standard Webhooks (webhook-id, webhook-timestamp, webhook-signature) using the secret returned at create time. No npm signing library — HMAC is inline.

n8n Cloud and local test URLs differ. Activate the workflow in the environment that should receive events.

Zentria Action

Resource + operation against /api/public. Foreign keys use searchable locators (q) so you pick “Discovery call”, not a numeric id.

Minimum operations: deals (get/list/create/update/move stage), people/orgs, forms/submissions, pipeline, activities (create/complete), CRM leads (approve/reject), customers (including archive, restore and a status filter), members, todos, Speed to Lead flows, webhooks, and Business Profile (list locations, reviews, review replies, changes and posts; approve or reject a reply; dismiss a review without replying (for reviews Google refuses replies to) or restore it, and filter reviews on dismissed; accept (Google is right), dismiss or reject a change; filter locations on category, each location includes its standard profile; create or delete a post; read-only results of a location: performance and search keywords). Business Profile needs the business-profiles:read scope, and business-profiles:write for the approve, reject, accept, dismiss, restore, create and delete operations.

Loop risk

Zentria always emits webhooks for PAT/API writes. A workflow that updates a deal on sales.deal.updated can loop. Filter on payload fields or avoid writing the same record you just received.

HTTP fallback

If you cannot install this node (n8n Cloud before verification, or a trial without community nodes):

1. In Zentria, Teams → Webhooks → add the URL of an n8n Webhook node.
2. In n8n, call Zentria with HTTP Request + the same PAT (Authorization: Bearer …).
3. Verify signatures yourself with Standard Webhooks (id.timestamp.body, v1,<base64>).

Local QA

1. Mint a PAT on a team with Sales + Webhooks.
2. npm run build in this folder, point a local n8n at dist/.
3. Add the credential, activate a Trigger on sales.form.submitted.
4. Submit a Zentria form. The Trigger should fire with data.deal and data.submission.
5. Add a Zentria Action → Deal → Move Stage. Confirm the board updates and a new sales.deal.stage_changed event arrives.
6. Deactivate the workflow. The Zentria webhook endpoint should disappear.

License

MIT