qyvo

n8n community nodes for Qyvo — WhatsApp marketing platform for e-commerce. Send templates, manage contacts, trigger sequences and flows.

Package Information

Released: 4 mo ago
Downloads: 25 weekly / 93 monthly
Latest Version: 0.2.0
Author: Qyvo

Documentation

n8n-nodes-qyvo

Community n8n nodes for Qyvo — the WhatsApp marketing platform for e-commerce.

Send WhatsApp templates, sync contacts, trigger sequences and flows, and react to incoming messages directly from your n8n workflows.

Install

In n8n (cloud or self-hosted), open Settings → Community Nodes → Install and enter:

n8n-nodes-qyvo

Or from the command line on a self-hosted instance:

npm install n8n-nodes-qyvo

Then restart n8n.

Authenticate

  1. In Qyvo, go to Settings → API Tokens and click Create token. Copy the value once — it's only shown to you that one time.
  2. In n8n, add a new Qyvo API credential and paste the token.
  3. Leave Base URL as https://www.qyvo.io unless you self-host Qyvo.

n8n will hit GET /api/v1/me with the token to verify it.

Nodes

Qyvo

Action node grouped by resource:

Resource Operations
Contact Create · Update · Get · Search · Add Tag · Remove Tag
Message Send Text · Send Template
Template List · Get
Tag List
Sequence Trigger
Flow Trigger

Templates, sequences and flows are exposed as searchable dropdowns powered by your live Qyvo data.

Qyvo Trigger

Polling trigger. Fires on:

  • New Message Received — inbound WhatsApp message from a contact (with optional message-type filter)
  • New Campaign Sent — broadcast campaign finished sending
  • New Flow Triggered — flow session started for a contact
  • New Sequence Triggered — sequence session started for a contact

n8n controls the poll interval; the node deduplicates by ID so you never see the same item twice.

Notes on WhatsApp limits

  • Templates are the only way to send a message outside the 24 h conversation window. They must be approved by Meta in Qyvo before you can use them.
  • Send Text only works inside the 24 h window after the contact's last inbound message. Outside of it the API returns an error — fall back to a template.
  • Phone numbers are normalized server-side, but pass them in E.164 format (+14155550123) for predictable behaviour.

Develop

npm install
npm run build       # compile TS + copy SVGs to dist/
npm run dev         # tsc --watch
npm run lint        # eslint with n8n community ruleset

To test a local build inside n8n:

npm run build
npm pack            # produces n8n-nodes-qyvo-x.y.z.tgz
# in your n8n install:
npm install /absolute/path/to/n8n-nodes-qyvo-x.y.z.tgz

License

MIT

Discussion