n8n-nodes-okitoki

This is an n8n community node for Oki-Toki API integration.

n8n is a workflow automation platform.

Oki-Toki is a cloud-based call center solution.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-okitoki
4. Click Install

Manual Installation

npm install n8n-nodes-okitoki

Docker

Add to your docker-compose.yml or environment:

environment:
  - N8N_COMMUNITY_PACKAGES=n8n-nodes-okitoki

Credentials

To use this node, you need to configure Oki-Toki API credentials:

1. In n8n, go to Credentials → New
2. Search for Oki-Toki API
3. Enter:
   • API Token: Your API token from Oki-Toki profile → Security section
   • Base URL: Your Oki-Toki server URL (default: https://home.oki-toki.net)

Operations

Call Resource (4 operations)

• Get Calls Log - Retrieve call history with flexible filters (date ranges, call types, search)
• Get Call Data - Get detailed information about a specific call by session ID
• Get Transcript - Retrieve conversation transcript for a call
• Get Recording URL - Construct the URL to access call recording

Contact Resource (1 operation)

• Get Contacts - Retrieve filtered contact records with pagination

Dialer Resource (6 operations)

• List Dialers - Get list of all dialers with their status (with dynamic dropdown selection)
• Get Statistics - Fetch detailed statistics for dialers
• Create Task - Create new dialer task with phone numbers
  • Supports multiple phones (comma-separated)
  • 11 additional fields: Contact ID, BP ID, Date, Import ID, Region, TTL, User ID, Details, Force Create, Task ID, Reset Task ID
• Cancel Task - Cancel existing dialer task
  • Can cancel by Task ID, Phone, Contact ID, BP ID, Details
  • 6 additional fields: Phone, Contact ID, BP ID, Details, Cancel Phone, Cancel Reason
• Enable Dialer - Enable/start a dialer by dialer ID
• Disable Dialer - Disable/stop a dialer by dialer ID

List Resource (2 operations)

• Get Values - Fetch items from a list by list ID
• Check Value - Verify if a value exists in a specific list

Report Resource (12 operations)

• Login Log - Get login activity log for users
• Queue Status Summary - Queue performance metrics (with queue_id, project_id, user_id filters)
• User Status Summary - Operator status overview (with project_id, user_id filters)
• Calls Summary - Aggregated call statistics
• Calls Tracking - Real-time call monitoring data
• Status Log - Operator timeline and status changes
• Dialer Tasks Result - Task completion reports
• CRM Process - CRM workflow analytics
• CRM Questionnaires Log - Survey response tracking
• Routing Calls Log - SIP communication history
• Routing Suppliers Summary - Provider cost analysis
• Routing Queues Summary - Queue expense metrics

Integration Resource (1 operation)

• Get List - Get list of external integrations with type filtering
  • Supports filtering by type: drive, mail, mail_smtp, slack, sms, webcall, getcall, call_chat, webhook, kommo

SMS Resource (1 operation)

• Send SMS - Send SMS message to a phone number
  • Required: Phone Number, Message
  • Optional: Gate (dynamic dropdown with available SMS gateways)

User Resource (2 operations)

• List Users - Get list of all users with optional filters
• Get Assigned Projects - Retrieve projects assigned to a specific user

Developer Feedback (1 operation)

• Send Message - Send feedback directly to node developers
  • ⚠️ For reporting bugs, suggesting features, or asking questions about the node
  • NOT for Oki-Toki API support or general n8n questions
  • Requires valid email address and message

Features

• ✅ 30 operations across 9 resources
• ✅ GET operations for data retrieval
• ✅ Dialer task management (create, cancel tasks, enable/disable dialers) with extended fields
• ✅ SMS integration with dynamic gateway selection
• ✅ Integration management - list external integrations with filtering
• ✅ Developer feedback - direct communication channel with node developers
• ✅ Flexible date ranges for reports (today, yesterday, this week, prev week, this month, prev month)
• ✅ Pagination support (limit, offset)
• ✅ Advanced filtering for calls log (call types, function name, search)
• ✅ Dynamic dropdowns for SMS gateways and dialers
• ✅ Email validation for feedback forms
• ✅ English interface - all descriptions and labels in English
• ✅ Type-safe - built with TypeScript

Usage Examples

Get Call History for Last Week

1. Add Oki-Toki node
2. Select Call resource
3. Select Get Calls Log operation
4. Choose Previous Week as date range
5. Optionally add filters (call types, limit, etc.)

Get Report on Operator Status

1. Add Oki-Toki node
2. Select Report resource
3. Select User Status Summary operation
4. Set date range (from/to)

Check Contact List

1. Add Oki-Toki node
2. Select Contact resource
3. Select Get Contacts operation
4. Set limit and offset for pagination

Compatibility

• n8n version: 1.0.0+
• Tested with: n8n 1.119.0

Development

Building

npm install
npm run build

Local Development

npm run dev

Resources

• n8n community nodes documentation
• Oki-Toki API documentation
• npm Package

License

MIT

Version History

0.4.4

• 🐛 Fixed email validation in Developer Feedback
  • Email validation now works correctly at runtime
  • Improved error messages for invalid email format
• 📝 Updated documentation

0.4.2

• ✨ Added Developer Feedback resource
  • Send bug reports, feature requests, and questions directly to developers
  • Email validation for user contact
• 🔧 Improved user experience
  • Developer Feedback moved to bottom of resource list
  • Removed unnecessary instruction fields

0.4.1

• ✨ Added Integration resource
  • Get list of external integrations with type filtering
  • Support for 10 integration types: drive, mail, mail_smtp, slack, sms, webcall, getcall, call_chat, webhook, kommo
• ✨ Enhanced SMS resource
  • Dynamic dropdown for SMS gateway selection
  • Automatically loads available gates from integration-external/list API
• 🐛 Fixed node internal naming for consistency
• 📈 Now 28 operations across 8 resources

0.4.0

• ✨ Added SMS resource with Send SMS operation
  • Send text messages via Oki-Toki API
  • Support for gateway selection
• 📈 Now 27 operations across 7 resources

0.3.0

• ✨ Enhanced Dialer operations
  • Enable Dialer - start/enable dialer by ID
  • Disable Dialer - stop/disable dialer by ID
• ✨ Extended Dialer Create Task with 11 additional fields
  • Contact ID, BP ID, Date, Import ID, Region, TTL, User ID, Details, Force Create, Task ID, Reset Task ID
• ✨ Extended Dialer Cancel Task with 6 additional fields
  • Phone, Contact ID, BP ID, Details, Cancel Phone, Cancel Reason
• 📈 Now 26 operations across 6 resources

0.2.0

• ✨ Added Dialer task management operations
  • Create Task - create dialer tasks with phone numbers (comma-separated support)
  • Cancel Task - cancel existing tasks by task ID
• 📈 Now 23 operations total

0.1.0 (Initial Release)

• ✨ 21 operations across 6 resources
• ✨ Support for Calls, Contacts, Dialers, Lists, Reports, Users
• ✨ Flexible date ranges and filtering
• ✨ Complete English interface