TVH Voice docs

#Voice Infrastructure Platform — documentation

Add calling to your CRM through one REST API. We run the telephony (FreeSWITCH, call control, recordings, webhooks); you bring your own carrier account (Telnyx, Twilio or any SIP trunk) and keep paying the carrier directly. Switching carriers is a configuration change: nothing in your integration refers to a carrier.

#What you can build

#Concepts

Concept What it is
Workspace Your account: limits (agents, concurrency, destinations, spend guard) and settings (recording).
Carrier A connected carrier account. Has capabilities (what its API supports) and health.
Number A DID owned by one carrier. Outbound calls use the carrier of the caller ID number.
Agent A SIP account agent_{agent_ref} for one CRM user; browsers get expiring credentials.
Inbound rule Where calls to a number go. Ring groups ring several agents.
Call One conversation with a timeline of events; ends with a CDR (call.ended).
Event Normalized notification (call.answered, recording.ready, …) delivered by webhook/stream.

#Start here

  1. Quickstart (sandbox) — everything runs locally with a simulated carrier.
  2. Integration guide for AI agents — the ordered checklist.
  3. API conventions, recipes, events, errors.
  4. Reference: /openapi.yaml (OpenAPI 3.1 with examples), /llms.txt, /llms-full.txt.

Operator documentation (not needed to integrate): operations, production deployment, security checklist, load test, adding a carrier, FreeSWITCH internals.