Package Information
Available Nodes
Documentation generating…
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.
In the VOIS panel open Settings › Open REST API & Webhook › API & Webhook Management and create a key.
Tick the permissions your workflows need:
You want to… Permissions Use call triggers webhooks:manage+voice:readUse CRM triggers webhooks:manage+readStart or hang up calls voice:call(+voice:readfor the extension list)Read call history, active calls, extensions voice:readDownload recordings voice:recordingsSend SMS sms:send(+sms:readfor the sender list)Read customers, leads, invoices readCreate leads writeIn 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-Signatureheader (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
statusisno_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:
node test/e2e/vois-stub.js(listens on port 18080, accepts the keyvois_9999_stubkey).- Run n8n in Docker with
-e WEBHOOK_URL=http://localhost:5679/ -p 5679:5678, install the packed tarball (npm pack) into~/.n8n/nodeswithnpm install --legacy-peer-deps <tgz>and restart n8n. - Create a VOIS API credential with API Base URL
http://host.docker.internal:18080. - Activate a workflow with the VOIS Trigger, then
curl -X POST 'localhost:18080/_fire?event=call.ended'(add&bad=1for a forged signature,&old=1for an old event).GET /_logshows what n8n sent.
Resources
- VOIS for n8n (setup guide, Turkish)
- VOIS Voice API and SMS API documentation, OpenAPI files at docs.vois.com.tr
- n8n community nodes documentation
Support: destek@vois.com.tr