ringotel

n8n community node for the Ringotel Admin and Messaging APIs

Package Information

Downloads: 0 weekly / 23 monthly
Latest Version: 0.0.2
Author: David Szpunar

Available Nodes

Ringotel Admin icon
Ringotel Admin
Interact with the Ringotel Admin API

Documentation

n8n-nodes-ringotel

This is an n8n community node for the Ringotel Admin API, providing programmatic access to manage organizations, connections, users, contacts, SMS trunks, AI agents, and more.

n8n is a fair-code licensed workflow automation platform.

Installation |
Operations |
Credentials |
API Coverage |
Resources |
Changelog |
TODO

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

Organization

  • Create, Delete, Get, Get Many, Update, Set Status
  • Get Event Log, Get Calls, Get Activity Subjects, Set Activity Subjects

Connection (Branch)

  • Create, Delete, Get, Get Many, Update, Set Status
  • Get Options, Get Templates

User

  • Create, Create Many, Delete, Delete Many, Get, Get Many, Update
  • Attach, Deactivate, Delete Device, Delete Recordings, Delete Transcriptions, Detach
  • Get Logs, Get Phone Book URL, Get Registrations History, Get SIP Credentials
  • Recover Deleted, Reset Password, Resync SIP Device
  • Set Password, Set Settings, Set State, Set Status

Contact

  • Delete, Get Blocked, Get Many, Import, Set Blocked, Update

SMS Trunk

  • Create, Delete, Get Chats, Get Many
  • Get Opt-Out List, Add to Opt-Out, Remove from Opt-Out, Update

Account

  • Get, Get AI Usage Info, Get History, Get Many Users, Get Statistics
  • Create Admin, Update Admin, Delete Admin

AI Agent

  • Create, Delete, Get Many, Update

Call

  • Initiate, Update Activity

Region / Integration / Package

  • Get Many (each)

Credentials

To use this node, you need an API key from your Ringotel Shell admin portal (API Settings).

Field Description
Base URL Your Ringotel Shell instance URL (default: https://shell.ringotel.co)
API Key Bearer token generated from the admin portal
Dropdown Cache (Minutes) How long to cache Organization/Connection dropdown options (default: 10, set to 0 to disable)

Credentials are validated on save by calling the getOrganizations API method.

API Coverage

The Ringotel Admin API uses an RPC-style interface where all requests are POST to a single /api endpoint with a JSON body containing method and params. This node implements 74 operations across 11 resources, covering the full Admin API.

Implemented Resources

Resource Operations API Methods
Organization 10 createOrganization, deleteOrganization, getOrganization, getOrganizations, updateOrganization, setOrganizationStatus, getEventLog, getCalls, getActivitySubjects, setActivitySubjects
Connection 8 createBranch, deleteBranch, getBranch, getBranches, updateBranch, setBranchStatus, getBranchOptions, getTemplates
User 24 createUser, createUsers, deleteUser, deleteUsers, getUser, getUsers, updateUser, attachUser, deactivateUser, deleteDevice, deleteRecordings, deleteTranscriptions, detachUser, getUserLogs, getPhoneBookURL, getUserRegistrationsHistory, getSIPCredentials, recoverDeletedUser, resetUserPassword, resyncSIPDevice, setUserPassword, setUserSettings, setUserState, setUserStatus
Contact 6 deleteContacts, getBlockedContacts, getContacts, importContacts, setBlockedContacts, updateContacts
SMS Trunk 8 createSMSTrunk, deleteSMSTrunk, getSMSChats, getSMSTrunks, getSMSOptOutList, addToSMSOptOut, removeFromSMSOptOut, updateSMSTrunk
Account 8 getAccount, getAIUsageInfo, getAccountHistory, getAccountUsers, getAccountStatistics, createAdmin, updateAdmin, deleteAdmin
AI Agent 4 createAIAgent, deleteAIAgent, getAIAgents, updateAIAgent
Region 1 getRegions
Integration 1 getIntegrations
Package 1 getPackages
Call 2 initCall, updateActivity

Not Yet Implemented

Feature Description
getLogFile The only non-RPC endpoint (GET /userlogs/{path}) for downloading user log files
SMS Trunk dropdown Dynamic dropdown for SMS Trunk ID selection (similar to Organization/Connection dropdowns)
Ringotel Messaging API Separate node planned for the Messaging API (pending API documentation)

See TODO.md for the full list of planned improvements.

Features

  • Dynamic dropdowns for Organization and Connection (Branch) selection with configurable caching
  • Organization ID injection into User query results (orgid field) for downstream chaining
  • AI agent tool compatibility (usableAsTool: true) for use with n8n AI agents
  • Error handling with continueOnFail() on every item and proper item linking via constructExecutionMetaData
  • Cache invalidation on mutation operations (create, update, delete) for Organizations and Connections

Resources

License

MIT

Discussion