Description

n8n-nodes-livecommerce


Community n8n nodes for the Bambuser video-commerce platform. A single Bambuser action node covers live shopping, shoppable videos, video consultation, product catalog, and shopper data; a companion Bambuser Webhook Trigger delivers events into n8n’s 400+ integrations without writing custom HTTP code.

About

Bambuser powers live, on-demand, and one-to-one video commerce for retailers and brands. This package wraps the public Bambuser APIs as native n8n nodes so non-engineers can wire video-commerce events into CRMs, data warehouses, messaging platforms, and analytics tools by dragging nodes onto a canvas. The package is maintained by Bambuser and developed in the open.

Available nodes

Two nodes ship in the package, sharing a single Bambuser API credential.

Bambuser (action node)

A single action node covering every read/write surface of the Bambuser public APIs. The top-level Resource dropdown groups operations by service area:

• Live Show, Live Product, Live Channel, Live Tag, Live User, Live Statistic, Live Webhook, Live Broadcast — Live Shopping API. List, create, update, publish, and schedule shows; pin chat messages; manage product highlights; pull viewer/sales metrics.
• Video, Media Asset, Video Playlist — Shoppable Videos (VOD). Clip broadcasts into VODs, manage media assets and captions, query the video library. Requires VODREAD for read operations, VODMANAGE for writes.
• Call, Connect Link, Call Statistic — Video Consultation. Create connect links, fetch call transcripts, pull call statistics.
• Catalog Product — Product Catalog. Search, count, create, update, and delete products. Suitable for AI enrichment and stock-sync workflows. Requires PRODUCTCATALOGREAD or PRODUCTCATALOGMANAGE.
• Shopper Data — GDPR-relevant shopper records. List, get, and erase records. Requires READSHOPPERDATA.

Bambuser Webhook Trigger

Start a workflow when Bambuser fires an event. The node registers and tears down the subscription against the Bambuser API on workflow activation/deactivation, and re-registers automatically if the webhook URL changes.

• show., broadcast., product., product-highlight., user.* topics
• Requires the WRITE_WEBHOOKS API-key scope

Credential

The Bambuser API credential takes an API key, a region (EU or US), and an optional base-URL override. The key is sent as Authorization: Token . Scopes are granted per-key in the Bambuser dashboard; per service area the relevant ones are:

• Live Shopping — READSHOWS, WRITESHOWS, DELETESHOWS, READPRODUCTS, WRITEPRODUCTS, DELETEPRODUCTS, READUSERS, WRITEUSERS, DELETEUSERS, READTAGS, WRITETAGS, READCHANNELS, READSTATS, READBROADCASTS, READWEBHOOKS, WRITEWEBHOOKS
• Shoppable Videos — VODREAD, VODMANAGE
• Video Consultation — READCALLS, READCALLSSTATS, READCONNECTLINKS, WRITECONNECTLINKS, DELETECONNECT_LINKS
• Product Catalog — PRODUCTCATALOGREAD, PRODUCTCATALOGMANAGE
• Shopper Data — READSHOPPERDATA

Grant only the scopes the workflow needs.

Prerequisites

• n8n 1.57.0 or later
• Node.js 24 or later (only required for local development of the nodes themselves)

Installation

n8n Cloud and self-hosted (Community Nodes UI)

1. Open n8n and go to Settings → Community Nodes.
2. Click Install and enter @bambuser/n8n-nodes-livecommerce.
3. Confirm the install. The Bambuser nodes appear in the node panel after a short refresh.

See the n8n community nodes installation guide for the full UI walkthrough and the security caveats around third-party nodes.

Self-hosted via npm

For self-hosted n8n instances that install community nodes from the file system:

cd ~/.n8n/custom
npm init -y       # only if package.json does not already exist
npm install @bambuser/n8n-nodes-livecommerce

Restart n8n. The nodes load from ~/.n8n/custom/node_modules.

Credentials

A Bambuser account is required. You can create one for free at bambuser.com.

1. Sign in to your Bambuser dashboard (EU or US, matching your org’s data residency) and open Settings → API Keys.
2. Create a new key and grant the scopes your workflow needs (see the list under Available nodes).
3. In n8n, create a new credential of type Bambuser API:
– API Key — the key from the dashboard.
– Region — EU or US, matching the org’s data residency.
– Base URL Override — leave empty in production. Used for pointing at a non-default API host (staging, a tunnel, a local proxy).

The credential is reused across every node in this package.

Compatibility

Built and tested against n8n 1.57 and later. Earlier versions are not supported.

Quick start

A minimal workflow that reacts to a Bambuser show ending:

1. Add a Bambuser Webhook Trigger node. Select the show topic.
2. Activate the workflow. The node registers a webhook subscription against the Bambuser API automatically.
3. Add downstream nodes (Slack, HTTP Request, database, etc.) consuming the event payload.

End the show in the Bambuser dashboard. n8n receives the webhook and runs the workflow.

What you can build

A few workflows that merchants commonly assemble from these nodes plus n8n’s built-in integrations:

• Go-live notification blast — show.started → SMS via Twilio + email via Klaviyo + Instagram Story post.
• Automatic show recap — show.ended → pull stats → AI summary → post to Slack and save to Notion.
• Live → VOD → CMS pipeline — broadcast.ended → create VOD → AI writes description → push to Contentful or a Shopify product page.
• Data warehouse sync — show.ended → append views, carts, and revenue to BigQuery or Google Sheets.
• Low-stock alerts — daily catalog scan → Gemini drafts a restock recommendation → append to a shared Google Doc.
• GDPR shopper data erasure — erasure webhook fires → delete shopper record → log confirmation for the audit trail.

See examples/workflows/ for ready-to-import JSON workflows demonstrating each of these patterns.

Examples

Ready-to-import workflow JSON files live under examples/workflows/. Import a file from the n8n UI via Workflows → Import from File, then attach your Bambuser API credential.

Local development

git clone https://github.com/bambuser/n8n-nodes-livecommerce.git
cd n8n-nodes-livecommerce
nvm use        # picks up .nvmrc → Node 24
npm install
npm run build

To link the local build into a local n8n install:

cd ~/.n8n/custom
npm link /absolute/path/to/n8n-nodes-livecommerce

Restart n8n and the nodes load from the local build directory.

Docker development environment

The repo ships a Docker Compose setup that runs n8n with Postgres and bind-mounts the compiled nodes, so a rebuild + restart picks up changes without rebuilding the image.

cp .env.example .env
openssl rand -hex 32   # paste into N8NENCRYPTIONKEY in .env
docker compose up --build

n8n is available at http://localhost:5678.

After editing anything under credentials/, lib/, or nodes/:

npm run build
docker compose restart n8n

Webhook testing with a Cloudflare tunnel

Bambuser needs a public HTTPS URL to deliver webhook events. To run n8n behind a free *.trycloudflare.com tunnel:

docker compose -f docker-compose.yml -f docker-compose.tunnel.yml up --build

The tunnel URL changes on every restart. To push the new URL to Bambuser, deactivate and reactivate the workflow in the n8n UI — the Bambuser Webhook Trigger node re-registers the subscription with the new URL automatically.

Publishing

Releases are tag-driven and run from GitHub Actions with npm provenance.

1. A maintainer runs npm run release from the repo root. release-it prompts for a version bump, updates package.json, commits, tags, and pushes the tag.
2. The tag push triggers .github/workflows/publish.yml, which builds the package and publishes it to npm under the @bambuser scope with an npm provenance statement.

Both Trusted Publishers (OIDC) and a long-lived NPM_TOKEN secret are supported. See the comments in .github/workflows/publish.yml for setup.

Resources

• n8n community nodes documentation
• n8n node-development reference
• Bambuser developer documentation
• Sign up for a Bambuser account

License

MIT