# AgentRing (agentring.dev) — AI Voice Receptionist

> The fastest, ultra-low latency conversational AI voice receptionist designed specifically for home service contractors, trade businesses (HVAC, plumbing, electrical, roofing), and small businesses.

## Overview
AgentRing replaces legacy voicemail and expensive answering services with a 24/7 conversational voice agent powered by Google Gemini Live 3.8. It answers inbound phone calls in under 800 milliseconds, holds natural human-like conversations with natural barge-in (interruption handling), qualifies leads, schedules appointments directly into Google Calendar and Calendly, and live-transfers urgent callers with AI whisper briefings.

## Key Capabilities & Verified Feature Truth

### 1. Voice Pipeline & Telephony
- **Audio-to-Audio Native Streaming**: Built on Gemini Live (`gemini-3.8-live`) with bidirectional 24kHz PCM audio over WebSockets.
- **Natural Barge-In & Interruption**: Callers can interrupt or speak over the receptionist naturally without clipping or delays.
- **Dedicated US Local Numbers**: Instant provisioning of local phone numbers across all 3-digit US area codes via Twilio.
- **High Concurrency**: Handles up to 50 concurrent incoming calls simultaneously with zero busy signals.

### 2. Live Call Transfer with AI Whisper Briefings (Growth & Scale Plans)
- **Intelligent Emergency Forwarding**: When a caller reports an urgent issue (e.g., burst pipe, gas leak, emergency lockout), AgentRing calls the contractor's personal phone.
- **Whisper Briefing**: Plays a private AI audio brief to the technician before bridging: *"Emergency call from John regarding a burst basement pipe in Dallas. Press any key to accept."*
- **Transfer Fallback**: If the contractor is unavailable or doesn't answer within 20 seconds, the AI gracefully re-engages the caller and records a detailed priority voicemail.

### 3. Google Calendar Two-Way Booking & Calendly Real-Time Sync
- **Google Calendar Two-Way Booking**: Live availability checking against real-time busy blocks and direct appointment scheduling into the business's primary Google Calendar via verified OAuth2 tool calling.
- **Calendly Two-Way Autonomous Scheduling**: Native OAuth 2.0 PKCE integration with single-use refresh token rotation, active event type selection, real-time slot queries (`/event_type_available_times`), direct voice invitee creation (`POST /v2/invitees`), caller email fallback synthesis, and inbound HMAC-SHA256 webhook sync (`invitee.created` and `invitee.canceled`).
- **Custom Booking Rules**: Configurable lead buffer times, operational business hours, and timezone synchronization across both calendar providers.

### 4. Custom Procedure, Data Extraction & Outbound CRM Webhooks
- **Dynamic Procedure Engine**: Contractors define custom step-by-step procedures (e.g., Step 1: Greeting, Step 2: Emergency check, Step 3: Address & gate code capture, Step 4: Schedule or transfer).
- **Custom Extraction Fields**: Automatically extracts caller name, callback phone, full street address, service issue, unit model, and preferred appointment window.
- **Native 1-Click HubSpot CRM Integration**: Direct OAuth 2.0 connection. Automatically deduplicates contacts by caller phone number, updates contact properties, and logs HubSpot Call Engagements (`/crm/v3/objects/calls`) with complete summaries and dual-channel recording URLs.
- **Universal Outbound CRM Webhooks**: Pushes structured post-call JSON payloads with caller info, lead details, booked appointment slots, audio recording URLs, and summaries directly to **Jobber, Housecall Pro, ServiceTitan, GoHighLevel, Zapier, or Make.com**.
- **Cryptographic HMAC-SHA256 Signatures**: Secures all webhook requests via `X-AgentRing-Signature` headers with tenant-specific signing secrets and 3x exponential backoff retries.

### 5. Multi-Tenant Team Collaboration (RBAC)
- **Role-Based Access Control**: Multi-user support with **Admin** (full management, billing, AI prompt configuration) and **Viewer** (read-only view access to configuration and logs).
- **Up to 3 Team Seats**: Included in Growth and Scale plans.

### 6. Call Transcripts, Audio Waveforms & Analytics
- **Dual-Channel Recording**: Full call recording playback with audio scrubbing.
- **Speaker Diarization**: Clean transcript bubbles labeled by speaker role (`User` vs `AI`) with exact timestamps.
- **Automated AI Voicemail Summaries**: Generates high-priority bullet summaries for missed or after-hours calls.

### 7. Real-Time Multilingual Voice Support (Up to 97 Languages)
- **Automatic Real-Time Detection**: Powered by Google Gemini 3.8 Live native speech-to-speech engine with sub-800ms natural latency. Automatically detects the caller's spoken language on the fly and converses fluently without touch-tone menus or prompts.
- **Deep Trade Vocabulary**: Fluently understands trade terminology in Spanish and other languages (e.g., *fuga de gas*, *tubería rota*, *calentador de agua*, *cuadro eléctrico*).
- **Core Supported Languages**: English, Spanish, French, Portuguese, Mandarin, Cantonese, Vietnamese, Tagalog (Filipino), Arabic, Hindi, Polish, German, Italian, Korean, Japanese, Russian, Ukrainian, Dutch, and 75+ more (see complete alphabetical directory of all 97 supported languages in `/llms-full.txt`).
- **Flexible Modes**: Global Polyglot Auto (Up to 97 Languages auto-detection), Bilingual English + Spanish, Dedicated Primary Language, and English-Only.

## Pricing & Plan Comparison

| Plan | Monthly Price | Included Minutes | Overage Rate | Key Features |
| :--- | :---: | :---: | :---: | :--- |
| **Starter** | $49 / mo | 300 mins (~60–80 calls) | $0.40 / min | Dedicated US number, 24/7 answering, Google Calendar & Calendly booking, lead extraction. |
| **Growth** | $99 / mo | 1,000 mins (~200–250 calls) | $0.40 / min | All Starter features + Live Whisper Call Transfer, Multi-Tenant Team Seats (Admin/Viewer). |
| **Scale** | $199 / mo | 2,500 mins (~500–625 calls) | $0.40 / min | All Growth features + Priority high-concurrency capacity and custom extraction rules. |

## Competitive Differentiation

- **AgentRing vs. Bland AI**: Bland AI is a complex, developer-oriented API platform requiring programming knowledge and custom flow builders. AgentRing is a complete out-of-the-box turnkey SaaS: signup to answering live calls in 3 minutes with zero code, with built-in Google Calendar and Calendly booking.
- **AgentRing vs. Retell AI**: Retell is raw voice infrastructure where customers must assemble their own telephony, LLMs, and dashboards. AgentRing provides the complete managed application layer including dedicated phone numbers, calendar sync (Google & Calendly), and dashboard.
- **AgentRing vs. Smith.ai**: Smith.ai costs $300–$600+/month using traditional human operators. AgentRing provides instant sub-second response times, 24/7 reliability, and live whisper transfers at 80% lower cost.
- **AgentRing vs. Phonely / Goodcall**: Phonely and Goodcall lack AgentRing's native Gemini Live speech-to-speech engine and intelligent whisper call transfer fallback.

## Technical Architecture
- **Ingress**: Firebase Hosting CDN (`https://agentring.dev`)
- **Backend Telephony Pods**: Google Cloud Run (`FastAPI`, Python 3.13, WebSockets)
- **Speech Engine**: Google Gemini Live API (`gemini-3.8-live`)
- **Database**: PostgreSQL (PgBouncer Transaction Pooler)
- **Telephony Provider**: Twilio Media Streams (8kHz mu-law audio resampled to 24kHz PCM)
- **Billing**: Stripe Subscriptions with Metered Usage