Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Concepts

Understand how Ruut Voice works under the hood so you can design reliable call flows and troubleshoot when things go wrong.
Call routing
How an inbound or outbound call travels from the PSTN through the switch to your application — and back.
Authentication
How API authentication and webhook signing work.
Security
Fraud protection, rate limits, trunk allowlists, and PII handling.

The stack

Ruut Voice is a full telephony stack you don't have to run:
  • Edge / SIP gateway — authenticates SIP traffic and enforces trunk allowlists.
  • Media / switch — a B2BUA that answers calls, executes TwiML, bridges, records, and transcribes.
  • REST API — Twilio-compatible endpoints for calls, messages, numbers, and extensions.
  • Webhooks — HTTP callbacks for call, recording, and transcription events; signing varies by callback type.
  • Browser softphone — WebRTC devices that register agent extensions.

A call in one picture

Caller (PSTN)
   │  INVITE
   ▼
SIP gateway ──auth + trunk allowlist──▶ Switch (FreeSWITCH)
   │                                          │
   │  fetch TwiML (VoiceUrl)                  │  execute verbs
   ▼                                          ▼
Your app  ◀── webhooks ────▶  API / dashboard

Next