n8n-nodes-vicidial

n8n community node for connecting with the VICIdial Non-Agent API.

VICIdial is an open-source call center suite. This node provides access to the Non-Agent API functions for managing leads, users, campaigns, and more.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in n8n
2. Select Install
3. Enter n8n-nodes-vicidial in Enter npm package name
4. Agree to the risks and click Install

Manual Installation

npm install n8n-nodes-vicidial

Credentials

This node requires VICIdial API credentials with the following information:

• Host: Your VICIdial server hostname (e.g., server.example.com)
• User: API-enabled VICIdial user ID
• Password: Password for the user

Operations

This node supports all VICIdial Non-Agent API functions including:

• Lead Management: Add, update, search leads
• User Management: Add, update, copy users
• Campaign Management: Update campaigns, manage hopper
• Phone Management: Add, update phones and aliases
• List Management: Add, update lists
• Reports: Agent stats, call status, DID logs, recordings
• System: Version info, server refresh, logged-in agents

Features

• ✅ Auto-generated from official VICIdial OpenAPI specification
• ✅ Support for all Non-Agent API functions
• ✅ Type-safe parameters
• ✅ Built-in documentation for each function

Development

Setup

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Link locally for testing
npm link

Test with n8n

# In your n8n custom directory
cd ~/.n8n/custom
npm link @mcnug/n8n-nodes-vicidial

# Start n8n
n8n start

Resources

• VICIdial Documentation
• n8n Community Nodes
• n8n OpenAPI Node Generator

License

MIT

Version History

1.0.0

• Initial release with full Non-Agent API support