velaro

n8n community node for the Velaro public REST API (api/v1): contacts, tags, conversations, appointments, agents, teams and signed webhook triggers.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Velaro

Documentation

n8n-nodes-velaro

Community node for n8n that talks to the Velaro public API (/api/v1).

Install

Settings, Community Nodes, Install, n8n-nodes-velaro.

Credentials

Base URL (https only, default is the Velaro API host) and a vlk_ API key. The credential test calls GET /api/v1/me. Grant the key only the scopes the workflow needs.

Velaro node

Contact: get, get many, create or update by email, add tag, add note. Conversation: get, get many. Appointment, agent, team: get many. List calls return a single page (max 100) and never auto-paginate, so plan rate limits apply.

Velaro Trigger

Registers a Velaro API webhook on activate, deletes it on deactivate, and verifies X-Velaro-Signature (t=<unix>,v1=<hex HMAC-SHA256 of "<t>.<body>">, 300 second tolerance) on every delivery. Unsigned or stale requests get 401.

Develop

npm install, npm test (compiles with tsc, then runs node:test). npm run build produces dist/.

Not included

No logic engine, no polling loops, no knowledge-base search (not exposed at api/v1 yet). Use n8n for orchestration and Velaro workflows for in-chat logic.

Discussion