vois

n8n community node for VOIS (cloud PBX + SMS): call and CRM triggers, click-to-call, SMS, call history and recordings

Package Information

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

Documentation

n8n-nodes-vois

This is an n8n community node. It lets you use VOIS in your n8n workflows.

VOIS is a Turkish cloud phone system (PBX) with CRM and SMS. With this package your workflows can start calls, react to ringing/answered/ended calls, read call history and recordings, send SMS and work with VOIS CRM customers, leads and invoices.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation. In n8n: Settings › Community Nodes › Install, enter n8n-nodes-vois.

Credentials

The node uses a VOIS API key.

  1. In the VOIS panel open Settings › Open REST API & Webhook › API & Webhook Management and create a key.

  2. Tick the permissions your workflows need:

    You want to… Permissions
    Use call triggers webhooks:manage + voice:read
    Use CRM triggers webhooks:manage + read
    Start or hang up calls voice:call (+ voice:read for the extension list)
    Read call history, active calls, extensions voice:read
    Download recordings voice:recordings
    Send SMS sms:send (+ sms:read for the sender list)
    Read customers, leads, invoices read
    Create leads write
  3. In n8n create a VOIS API credential and paste the key. Leave API Base URL as https://api.vois.com.tr.

The credential test calls GET /v1/me. The key is sent as Authorization: Bearer <key> and never appears in error messages.

Operations

Resource Operations
Call Start (click-to-call: your extension rings first, then the number is dialled), Hang Up, Get (one call from the history), Get Many (call history with date, direction, status, extension and number filters), Get Active, Download Recording (binary file, WAV or MP3)
SMS Send (approved sender title, İYS commercial flag, duplicate protection with your own reference)
Customer Get, Get Many (search by company name, phone or tax number)
Lead Create, Get, Get Many
Invoice Get, Get Many
Extension Get Many

Turkish mobile numbers are accepted in any common form (0532…, 532…, +90 532…). Call history ranges default to the last 30 days (VOIS allows at most 31 days per request).

The node can be used as a tool by n8n AI agents.

Trigger

VOIS Trigger starts a workflow when one of the selected events happens:

  • Calls: call.ringing, call.answered, call.ended
  • CRM: customer created/updated/deleted, lead created/converted/deleted, invoice created/payment/deleted, estimate, proposal, contract and subscription created

When you activate the workflow (or click Listen for test event), the node registers one VOIS webhook per event with POST /v1/webhooks. When you deactivate it, the webhooks are deleted.

Security:

  • Every delivery is checked against the X-VOIS-Signature header (HMAC-SHA256 of the raw body with the webhook secret that VOIS returns only when the webhook is created). Requests without a valid signature get HTTP 401 and do not start the workflow.
  • Signed events older than 10 minutes (configurable) are acknowledged but ignored, as protection against replays.

CRM events only carry the record ID, so by default the trigger loads the full customer, lead or invoice (option Fetch Full Record).

Your n8n must be reachable from the internet over HTTPS (port 443 or 80). VOIS refuses local, private and plain-http addresses. For a self-hosted n8n set WEBHOOK_URL to your public address (reverse proxy or tunnel).

Example workflows

  • Missed call to Slack: VOIS Trigger (Call Ended) → IF status is no_answer → Slack message.
  • Call log in a sheet: VOIS Trigger (Call Ended) → Google Sheets: append row (time, from, extension, duration, status).
  • Archive recordings: VOIS Trigger (Call Ended) → IF recording_available → VOIS: Call › Download Recording (call_id) → Google Drive upload.
  • Form to CRM: Webhook / Typeform → VOIS: Lead › Create.
  • Call new leads at once: VOIS Trigger (Lead Created) → VOIS: Call › Start (sales extension, phonenumber).
  • Appointment reminder: Schedule → Google Calendar → VOIS: SMS › Send.

Compatibility

Built and tested with n8n 2.x (n8n-workflow 2.47) and @n8n/node-cli 0.56. Requires Node.js 20.15 or newer. No runtime dependencies.

Development

npm install
npm run lint      # n8n-node lint (community node rules)
npm run build
npm test          # unit tests against dist/, no network

test/e2e/vois-stub.js is a small fake of the VOIS API (no real calls or SMS) for end-to-end runs in a local n8n:

  1. node test/e2e/vois-stub.js (listens on port 18080, accepts the key vois_9999_stubkey).
  2. Run n8n in Docker with -e WEBHOOK_URL=http://localhost:5679/ -p 5679:5678, install the packed tarball (npm pack) into ~/.n8n/nodes with npm install --legacy-peer-deps <tgz> and restart n8n.
  3. Create a VOIS API credential with API Base URL http://host.docker.internal:18080.
  4. Activate a workflow with the VOIS Trigger, then curl -X POST 'localhost:18080/_fire?event=call.ended' (add &bad=1 for a forged signature, &old=1 for an old event). GET /_log shows what n8n sent.

Resources

Support: destek@vois.com.tr

License

MIT

Discussion