Description
@bubblav/n8n-nodes-bubblav
n8n community nodes for BubblaV, the AI chatbot and live chat for customer support. Trigger n8n workflows from chat events (new conversations, leads, handoffs, ratings) and run actions against your AI chatbot: send messages, tag conversations, update customers, and create support tickets.
Also listed on the n8n integrations directory: https://n8n.io/integrations/bubblav/
Nodes
BubblaV (action node) — 9 operations:
| Resource | Operation | Description |
|—|—|—|
| Message | Send Message | Send a message to a conversation, or start a new conversation by targeting a visitor |
| Message | Send Greeting | Send a transient greeting to an online visitor |
| Conversation | Find | Find conversations by ID, visitor ID, or visitor email |
| Conversation | Tag | Add or replace tags on a conversation |
| Customer | Update | Update customer/visitor information |
| Customer | Find | Find customers by visitor ID or email |
| Ticket | Create | Create a support ticket (Zendesk or internal) |
| Chatbot | Ask Question | Ask your AI chatbot a question |
| Website | Get Analytics | Get conversation and message analytics |
BubblaV Trigger — webhook trigger for 15 events:
conversation.created, message.created, handoff.requested, conversation.closed, conversation.rated, lead.captured, link.clicked, visitor.firstvisit, visitor.returnvisit, calendly.booked, calendly.cancelled, calendly.rescheduled, calcom.booked, calcom.cancelled, calcom.rescheduled
Events are delivered as bare JSON objects; branch on payload fields to distinguish event types.
Credentials
1. BubblaV Dashboard → your website → Settings → API keys → Create key
2. Copy the key (bubblavmcp…)
3. In n8n, create a BubblaV API credential and paste the key
Each key is bound to one website. Base URL defaults to https://www.bubblav.com — override only for staging.
Installation
n8n → Settings → Community Nodes → Install → @bubblav/n8n-nodes-bubblav
Or from the command line in your n8n instance directory:
npm install @bubblav/n8n-nodes-bubblav
Development
npm install
npm run dev # builds + starts a local n8n with the node loaded
npm run build # compile to dist/
npm run lint # n8n community-node lint (required for verification)
npm run release # version bump + tag; tag push publishes via GitHub Actions
npm run dev watches and reloads. For webhook delivery in dev, set WEBHOOK_URL to a public tunnel URL, e.g.:
WEBHOOK_URL=https://.trycloudflare.com/ npm run dev
