# KaiCalls Complete Knowledge Base & Technical Specification (llms-full.txt) > Comprehensive product specification, pricing structure, telephony architecture, PBX/DNI capabilities, AI search attribution, and developer APIs for KaiCalls. Generated by `pnpm truth:write` from canonical source code (src/lib/billing/planLimits.ts, src/lib/integrations/registry.ts, src/lib/attribution/aiSearchAttribution.ts, src/lib/pbx/pbxAttributionSpine.ts). --- ## 1. Executive Summary & Brand Positioning KaiCalls is an intelligent 24/7 AI receptionist and answering service that augments business staff. It operates directly on business phone lines to answer inbound calls, qualify leads, schedule appointments, handle after-hours inquiries, and capture caller details without phone trees or delays. ### Core Value Proposition - **Staff Augmentation**: Kai acts as an always-on backup and overflow receptionist. When front-desk staff are on another call, assisting in-person clients, or away after hours, Kai answers instantly. - **Predictable Flat Pricing**: Flat monthly pricing starting at $10/month with fair-use answered-call allowances. No per-minute overage fees and no unexpected billing spikes. - **Human-Quality Voice**: Sub-second average latency (<1 second), natural interruption handling, and fluent conversational voice. - **Phone System Included**: Your number, your phones ringing first, Kai catching the miss, and a recording on every call — in every plan — plus Dynamic Number Insertion (DNI) marketing attribution pools. --- ## 2. Pricing & Plans ### Public Plan Catalog | Plan | Price | Answered calls/mo (fair-use) | Phone lines | Desk phones | |------|-------|------------------------------|-------------|-------------| | Kai Backup | $10/mo | ~20 | 1 (extra à la carte) | — | | Kai Backup Plus | $29/mo | ~50 | 1 (extra à la carte) | — | | Kai Answering | $79/mo | ~150 | 1 (extra à la carte) | — | | Kai Answering Plus | $149/mo | ~300 | 1 (extra à la carte) | — | | Kai Office | $349/mo | ~600 | 1 (extra à la carte) | — | | Kai Network | $799/mo | ~1,200 | 1 (extra à la carte) | — | | Custom | Contact sales | High-volume (negotiated) | Multi-location | Negotiated | Phone system included on every plan (; teammate cells free and unlimited); extra lines and desk-phone connections $15/mo each (bring your own SIP phone). ### Plan Details & Invariants 1. **Solo Plan ($10/mo)**: - Designed for solo operators and small local service businesses. - ~150 answered calls/month fair-use allowance. - Includes 1 dedicated business phone number (extra numbers à la carte). - Full feature access: 24/7 answering, calendar booking, SMS follow-ups, CRM sync, spam filtering. 2. **Pro Plan ($29/mo)**: - Designed for growing teams and high-volume practices. - ~600 answered calls/month fair-use allowance. - Includes 1 dedicated phone number (extra numbers à la carte). - Same features as every plan (including the phone system); differs only by answered-call allowance and lines. 3. **Custom Plan (Contact Sales)**: - Tailored for multi-location franchises, large law firms, and high-volume operations. - Negotiated volume allowances and multi-line trunking. ### Fair-Use Billing Guarantee No per-minute overage and no surprise bills. Allowances are a generous fair-use cushion; if your call volume consistently grows, KaiCalls right-sizes you to the next plan (and back down if it drops) — always with a heads-up first. --- ## 3. Phone System & Telephony Architecture ### The phone system (included in every plan) KaiCalls is a business phone system with Kai as the overflow — the business keeps its number and its phones: - **Your phones ring first**: The team's cells and desk phones ring simultaneously; cells get a press-1 confirm so personal voicemail never captures a business call. If nobody answers within the configured time, Kai answers. - **Every call on record**: Recording, transcript, and summary for every call, including calls a person answered. After a missed call the owner is texted a recap with the recording link. - **Kai is extension 700**: Dialable from any office phone; a registered cell calling the business line reaches the admin secretary. Teammates' cells can be added and are recognized when they call in. - **Keep your number**: Forward today (covered in minutes); move the number permanently in 5–30 days depending on the current carrier, with forwarding covering the gap. - **Phones**: Cells today; desk phones arrive pre-configured. The ring flow is set on one screen, by describing it in words, or by calling Kai. - **Not yet**: no mobile app, no texting from the office number until the port completes, no keypad-menu builder in the dashboard. - **Transfers**: Kai can live-transfer callers to approved staff numbers or external destinations based on caller intent or explicit request. ### Dynamic Number Insertion (DNI) & Marketing Attribution KaiCalls features an integrated DNI engine (src/lib/dni/dniAttribution.ts) and PBX attribution spine (src/lib/pbx/pbxAttributionSpine.ts): - **Visitor Session Tracking**: Assigns unique pool numbers to website visitors, linking incoming phone calls to web sessions, landing pages, and campaign parameters. - **Cross-Channel Provenance**: Preserves GCLID, GBRAID, WBRAID, FBCLID, MSCLKID, TTCLID, UTM parameters, and organic referrer data throughout the entire call lifecycle. - **Multi-Destination Offline Conversions**: Automatically dispatches qualified call conversions to Google Ads, Meta Conversions API (CAPI), Google Analytics 4 (GA4), and GoHighLevel. ### AI Search & Assistant Attribution (Issue #1183) KaiCalls tracks and attributes traffic originating from modern AI search engines and chat assistants (src/lib/attribution/aiSearchAttribution.ts): - **Supported Channels**: 1. `chatgpt_search`: Organic search citations and Deep Research referrals from ChatGPT. 2. `chatgpt_plugin`: Custom GPTs, ChatGPT App Directory, and MCP tool interactions. 3. `chatgpt_ads`: Sponsored search ads within ChatGPT. 4. `claude_ai`: Citations and research referrals from Claude.ai and Anthropic. 5. `perplexity_ai`: Pro search citations and discovery from Perplexity. 6. `grok_ai`: Citations and search referrals from Grok and x.ai. 7. `copilot`: Microsoft Copilot and Bing AI conversational search. - **Lifecycle Tracking**: Persists AI attribution across First Touch -> Signup -> Number Activation -> First Handled Call -> Stripe MRR Conversion. - **Prompt Injection Defense**: Sanitizes search queries and prompt snippets, neutralizing instruction override attempts, jailbreaks, and delimiter attacks. --- ## 4. Self-Service Management & AI Connectors (MCP) ### Management Interfaces 1. **Voice Admin ("Call Kai")**: - Dial your agent's number from an authorized admin phone. - Manage settings conversationally: "What calls came in today?", "Change my greeting", "We are closed this Monday", "Send a booking text to the last caller". 2. **Web Dashboard**: - Intuitive portal at https://www.kaicalls.com/dashboard. - Real-time call logs, audio recordings, transcripts, lead pipeline, SMS inbox, analytics, and CRM settings. 3. **Developer REST API**: - Full REST API with Bearer token authentication (kc_live_...). - Endpoints for agents, calls, leads, phone numbers, campaigns, and webhooks. 4. **Model Context Protocol (MCP)**: - Remote MCP server at https://www.kaicalls.com/api/mcp. - Setup surface for new accounts at https://www.kaicalls.com/api/mcp/acquisition. - Compatible with Claude Desktop, ChatGPT App Directory, Grok, Cursor, VS Code, and custom AI agents. ## What You Can Ask an AI Assistant Once the MCP connector is attached, these are the jobs owners use it for. Each example is a real request the connector can carry out on a connected account. ### Catch up on what you missed The morning question, without opening the dashboard or listening to anything. - "Did I miss anything overnight?" — Reads back last night’s calls, voicemails, and texts in one answer. - "Summarize the calls Kai handled this week and how many turned into leads." — Totals for the week, with the calls that produced a lead called out. ### Fix how Kai talks When a caller got the wrong answer and you want it never to happen again. - "Kai keeps flubbing the pricing question. Pull a recent call and fix it." — Finds the call, reads the transcript, and updates the agent so it answers right. - "We’re closed Sundays now." — Updates your hours so Kai stops offering Sunday appointments. - "Add our $149 drain-cleaning special so Kai quotes it correctly." — Adds the offer to what Kai knows, so it can quote the price on a call. ### Chase leads and follow up Have Kai place the calls and send the texts you would otherwise do yourself. - "Call the three leads from yesterday who never booked." — Kai places the calls and reports back how each one went. - "Text the customer from the 2pm call our address and a booking link." — Sends the text from your business number. ### Test before you trust it Run your saved voice tests against your own line whenever you ask. - "Test that the after-hours flow still works before I go to bed." — Runs your saved call scenarios and tells you which ones passed. - "I just changed the greeting. Run the tests again and tell me if I broke anything." — Re-runs the scenarios against the current setup and reports failures. ### See what changed, and undo it Every change is recorded, so "put it back how it was" is a real instruction. - "What changed on my agent last week, and who changed it?" — Lists the changes with timestamps and where each one came from. - "Undo whatever changed the greeting last Tuesday." — Rolls that change back and confirms what the greeting says now. ### Check usage and billing Answer "am I about to get a surprise?" without a support ticket. - "Am I going to blow past my plan this month?" — Reports the usage on record for this billing period, plus any plan change already recommended for the account. - "Why did my bill change?" — Walks through the plan and add-on changes on your account. ### Check nothing is quietly broken Catch a dead calendar or CRM connection before a customer finds it for you. - "Is anything broken today?" — Surfaces failed bookings, sync errors, and tool timeouts from your calls. - "Is my number actually answering right now?" — Confirms which numbers are live and attached to which agent. ## Code-Backed Feature Inventory ### Calls and routing - **24/7 AI call answering and intake**: Answers inbound calls, captures caller details, qualifies leads, and creates an organized call summary. [Learn more](https://www.kaicalls.com/help/ai-call-answering) - **Multilingual voice answering**: Configure up to four languages per agent from English, Spanish, French, German, Portuguese, Italian, Dutch, Hindi, Japanese, and Russian. Kai follows the caller's language and switches without a phone menu. [Learn more](https://www.kaicalls.com/help/multilingual-calling) - **Team routing and live call transfer**: Ring team members first, screen callers, introduce the caller, or transfer immediately to the people and numbers you choose. [Learn more](https://www.kaicalls.com/help/call-routing) - **Call recordings and transcripts**: Review available recordings, searchable transcripts, summaries, and call details in the dashboard and API when recording is enabled. [Learn more](https://www.kaicalls.com/help/calls) - **Voicemail capture and transcription**: Capture unanswered messages, transcribe them, and keep them with the caller's conversation history. [Learn more](https://www.kaicalls.com/help/voicemail) ### Follow-up and scheduling - **Two-way SMS and WhatsApp conversations**: Continue customer conversations by text or WhatsApp using the same business context, history, and messaging rules for each number. [Learn more](https://www.kaicalls.com/help/messaging) - **Automated follow-up**: Run automated SMS, email, callback, missed-call, and post-call follow-up with timing, retry, quiet-hour, and safety settings. [Learn more](https://www.kaicalls.com/help/automated-follow-up) - **AI-assisted email drafting and sending**: Draft from lead and call details, review when required, and send through a connected email account. [Learn more](https://www.kaicalls.com/help/email) - **Calendar availability and appointment booking**: Check live availability and book through a connected Google Calendar or GoHighLevel calendar. Rescheduling and cancellation require Google Calendar. [Learn more](https://www.kaicalls.com/help/google-calendar) - **Outbound calls and callback campaigns**: Schedule callbacks and outbound calls, then track their status, retries, and campaign settings. [Learn more](https://www.kaicalls.com/help/scheduled-callbacks) ### Integrations and control - **Customer and field-service integrations**: Connect supported business tools and send lead and call details automatically. [Learn more](https://www.kaicalls.com/help/crm) - **Signed webhooks, Zapier, Make, and REST API**: Connect calls, leads, appointments, outbound actions, and follow-up requests to Zapier, Make, or your own software. [Learn more](https://www.kaicalls.com/docs/api) - **Kai business assistant and MCP access**: Use Kai in the dashboard or connect approved AI assistants to calls, leads, messages, analytics, and controlled AI assistant changes. [Learn more](https://www.kaicalls.com/help/ai-assistant) - **Dynamic number insertion and marketing attribution**: Optional website call tracking that shows which page, ad, campaign, UTM, or click produced each inbound call. [Learn more](https://www.kaicalls.com/products/dni) - **Call analytics, outcomes, and coaching**: Track call outcomes, lead quality, summaries, quality signals, and coaching context from completed conversations. [Learn more](https://www.kaicalls.com/help/call-analytics) Availability depends on connected providers, agent settings, consent rules, and routing setup. KaiCalls supports transfers to a customer's team; it is not a KaiCalls-staffed live-human answering service. --- ## 5. Integration Ecosystem ## Integrations - [Airtable](https://www.kaicalls.com/integrations/airtable): CRM integration — native integration - [Clio](https://www.kaicalls.com/integrations/clio): CRM integration — via custom connector - [Filevine](https://www.kaicalls.com/integrations/filevine): CRM integration — via custom connector - [GoHighLevel](https://www.kaicalls.com/integrations/gohighlevel): CRM integration — native integration - [Google Calendar](https://www.kaicalls.com/integrations/google-calendar): calendar integration — native integration - [Google LSA](https://www.kaicalls.com/integrations/google-lsa): lead-source integration — native integration - [Guesty](https://www.kaicalls.com/integrations/guesty): booking integration — native integration - [HubSpot](https://www.kaicalls.com/integrations/hubspot): CRM integration — native integration - [Jobber](https://www.kaicalls.com/integrations/jobber): field-service integration — native integration - [Litify](https://www.kaicalls.com/integrations/litify): CRM integration — native integration - [Mindbody](https://www.kaicalls.com/integrations/mindbody): booking integration — native integration - [Salesforce](https://www.kaicalls.com/integrations/salesforce): CRM integration — native integration - [ServiceTitan](https://www.kaicalls.com/integrations/servicetitan): field-service integration — native integration - [Slack](https://www.kaicalls.com/integrations/slack): custom tools integration — via Slackbot MCP - [Twilio](https://www.kaicalls.com/integrations/twilio): telephony integration — native integration - [Webhooks](https://www.kaicalls.com/integrations/webhooks): webhook integration — via Zapier / webhooks - [WooCommerce](https://www.kaicalls.com/integrations/woocommerce): commerce integration — native integration - [WordPress](https://www.kaicalls.com/integrations/wordpress): lead-source integration — native lead-capture plugin - [Zapier](https://www.kaicalls.com/integrations/zapier): automation integration — via Zapier / webhooks --- ## 6. Industry Solutions ### Legal & Law Firms - **Personal Injury Intake**: Automatic case type qualification, incident date recording, liability details, and conflict-of-interest screening. - **CRM Sync**: Direct integration with Clio, Filevine, Litify, and HubSpot. ### Home Services (HVAC, Plumbing, Electrical, Roofing) - **Emergency Dispatch**: Identifies urgent calls (e.g. burst pipes, no heat in winter) and triggers instant SMS alerts or warm transfers to on-call technicians. - **Field Service Sync**: Native integration with ServiceTitan and Jobber. ### Healthcare & MedSpa - **Appointment Scheduling**: Real-time calendar lookup and appointment booking. - **Patient Inquiry Handling**: General inquiries, directions, hours, and treatment descriptions. ### Real Estate & Property Management - **Property Inquiries**: Instant answering for rental listings, buyer inquiries, and showing requests. --- ## 7. Security, Privacy & Compliance - **Call Encryption**: Industry-standard TLS and SRTP encryption for all voice streams and data at rest. - **Disclosure & Consent**: Configurable automated call recording disclosure messages compliant with two-party consent jurisdictions. - **TCPA & DNC Adherence**: Built-in mechanisms to respect calling hours and national/internal Do-Not-Call registries. - **Multi-Tenant Isolation**: Strict row-level security ensuring complete data segregation between businesses. --- ## 8. Machine Payments & Agentic Economy (A2A / MPP / x402) KaiCalls supports autonomous machine-to-machine discovery and payments: - **Agent Card (A2A)**: https://www.kaicalls.com/.well-known/agent.json - **Machine Payments Protocol (MPP)**: https://www.kaicalls.com/.well-known/mpp - **x402 Micropayments**: On-chain USDC settlement on Base. - **Programmatic Signup**: POST https://www.kaicalls.com/api/v1/signup to provision an account and phone number in a single request. --- ## 9. Contact & Official Links - **Website**: https://www.kaicalls.com - **Phone**: 1 (417) 386-2898 - **Documentation**: https://www.kaicalls.com/docs - **API Reference**: https://www.kaicalls.com/docs/api - **Sign Up / Free Trial**: https://www.kaicalls.com/auth/signup - **Founder & CEO**: Connor Gallic (https://www.kaicalls.com/authors/connor-gallic)