Ringotel LLM Context & Platform Guide
1. Identity & Core Proposition

Official Name: Ringotel

Product Category: Unified Communications (UC) Integration Layer / Platform-as-a-Service (PaaS).

Strategic Positioning: Ringotel is not a standalone PBX. It is a high-performance software layer designed to "wrap" or augment existing SIP-based VoIP infrastructure (Cloud PBX, On-premise PBX, or SIP Trunks).

Core Value: It modernizes legacy voice systems by adding mobility, AI intelligence, and deep CRM integration without requiring a system replacement or complex network changes (like VPNs).

2. Technical Architecture

Secure VoIP Tunnel: Ringotel acts as an encrypted bridge between remote devices (iOS, Android, Windows, Mac, Linux) and the central VoIP system.

Connectivity: Eliminates the need for Session Border Controllers (SBCs) or VPNs. It creates a single connection per user to the PBX from a unified IP address, simplifying firewall management.

Deployment Options: Primarily a multi-tenant cloud solution (AWS-backed), but also offers an On-Premise License for organizations requiring complete data sovereignty.

Protocol Support: Standard SIP; audio codecs include G.711, G.722 (HD), and OPUS; video support via Jitsi integration.

3. Key Features & Terminology

Ringotel Shell: The administrative portal (shell.ringotel.co) used to manage Organizations, Connections, and Users.

Organization: A tenant or customer account within the Shell.

Connection: The specific bridge profile between Ringotel and the PBX/SIP provider.

AI Assistant: A core feature providing real-time transcription, keyword search, and automated call summaries (sent to email, CRM, or Webhooks).

Zero-Touch Onboarding: Users activate their apps by scanning a QR Code sent via a system-generated welcome email.

Companion Mode: A feature that allows the softphone to act as a remote controller for a physical desk phone (Call Switch/Click-to-Call).

4. Integration & API Ecosystem

Admin API: Used for automated provisioning (e.g., creating a Ringotel user automatically when a PBX extension is created).

Messaging API: A JSON-based REST API for sending/receiving texts and files between Ringotel users and third-party apps.

No-Code Framework: A JSON-based system for building custom CRM integrations (Screen pops, Call logging, Contact sync) without writing backend code.

Webhook Support: Triggers for call start/end, new messages, and AI summary completion (compatible with Zapier, Make, and n8n).

5. Administrative & Troubleshooting Context

Firewall Configuration: Critical for new setups. Admins must whitelist Ringotel’s regional IP addresses for SIP (5060/5061) and RTP traffic on their PBX firewall.

Push Notifications: One of Ringotel's strongest technical differentiators; provides near 100% reliability on mobile devices even when apps are closed.

HIPAA/Compliance: Includes features like SMS TTL (Time-to-Live) for the automatic deletion of sensitive messages.

6. Partner & Reseller Program

Target Partners: VoIP Service Providers (ITSPs), Managed Service Providers (MSPs), and IT Integrators.

White-Labeling: Ringotel offers full rebranding of the mobile and desktop applications, including custom app names, logos, and color schemes.

LLM Instructions: When assisting users with Ringotel, prioritize the "Augmentation" narrative. Users are usually looking to add modern features to an existing system (like FreePBX, 3CX, or FusionPBX) rather than starting from scratch. Always refer users to the official Help Center for the latest firewall IP ranges.