# TelVox · Connect

> Programmable voice for developers, in developer preview — place and receive calls, drive them in real time, record under AES-256-GCM, and react to lifecycle events from your own code, on the same compliance-engineered infrastructure that runs TelVox Dial. The REST API, SDKs, CLI, self-serve number search/purchase, and instant console are preview/roadmap; the underlying voice capabilities are real and shipped in Dial today.

TelVox Connect exposes TelVox Dial's voice engine as an API. The capabilities are real today — place/receive calls, AMD, caller-ID/DID rotation, AES-256-GCM recording with signed-URL playback, a 12-node IVR + ACD queues, conference/transfer, SIP + WebRTC, 9 lifecycle webhooks over SSRF-safe egress, DID assignment, and WhatsApp + email messaging. The public REST surface, helper SDKs, the `telvox` CLI, self-serve number search/purchase, self-serve key issuance, and an instant console are in developer preview or on the roadmap; every API artifact is illustrative and may change before GA. Security is built in: AES-256-GCM at rest, append-only audit trail, org-scoped isolation, short-lived JWTs, and signed SSRF-safe egress — built for HIPAA workloads with a BAA available, and engineered to SOC 2 Type II / ISO 27001 controls with certification in progress (NOT certified). Not offered: no SMS/MMS, no Video, no Fax, no AI voice agents — messaging is WhatsApp + email only.

## Product

- [TelVox Connect](https://telvox.dev/connect): Programmable voice API overview — make a call with one request, capability map, and the shared-infrastructure trust story (developer preview).
- [Voice API](https://telvox.dev/connect/voice): Place and receive calls — one request starts an outbound call; inbound calls hit your answer URL. AMD, alternate-number failover, caller-ID/DID rotation.
- [Call Control & IVR](https://telvox.dev/connect/call-control): Drive a live call — play, gather, route, bridge, transfer, conference, queue, voicemail — grounded in the real 12-node IVR engine; the programmable markup API is preview.
- [Recording API](https://telvox.dev/connect/recording): Record under policy with AES-256-GCM at rest and short-lived signed-URL retrieval — modes (always/on_demand/never), pause/resume, S3/local/SFTP, retention.
- [SIP & WebRTC](https://telvox.dev/connect/sip-webrtc): Inbound/outbound over SIP trunks and browser/mobile WebRTC clients from one API, with live MOS/codec metrics; BYOC self-serve trunk config is roadmap.
- [Numbers & provisioning](https://telvox.dev/connect/numbers): Assign DIDs to your application and point inbound traffic at your handlers; caller-ID rotation is real, self-serve number search/purchase is roadmap.
- [Webhooks & events](https://telvox.dev/connect/webhooks): React to 9 real call-lifecycle events over signed, SSRF-safe, allow-listed egress — custom headers, JSON templates, retry/timeout, encrypted secrets.
- [Messaging (preview)](https://telvox.dev/connect/messaging): WhatsApp (templated, Twilio/Meta) and email send are real in Dial; the API surface is preview. Explicitly NOT offered: no SMS/MMS, no Video, no Fax, no AI voice agents.

## Docs

- [Developer docs](https://telvox.dev/connect/docs): Developer portal hub — Quickstart, Concepts, Guides, and links into the API Reference and SDKs (developer preview; fields may change before GA).
- [Quickstart](https://telvox.dev/connect/docs/quickstart): Signup → auth → first call, with a language-tab walkthrough (Node/Python/PHP/Java/Ruby/Go/cURL); SDK names flagged preview.
- [Concept — Authentication & API keys](https://telvox.dev/connect/docs/concepts/authentication): API keys (SID + secret), Bearer-token auth for REST (Authorization: Bearer $TELVOX_API_KEY), and short-lived Access Token JWTs for WebRTC.
- [Concept — Call-control markup (preview)](https://telvox.dev/connect/docs/concepts/call-control-markup): The answer-URL request/response loop and instruction reference (play/gather/dial/transfer/enqueue/record/hangup), mapped to the real 12 IVR node types — preview.
- [Concept — Webhooks & status callbacks](https://telvox.dev/connect/docs/concepts/webhooks-and-callbacks): Inbound webhook parameters, status callbacks (initiated/ringing/answered/completed), recording-status callbacks, signature verification, and SSRF-safe egress.
- [Guides](https://telvox.dev/connect/docs/guides): Task-oriented how-tos — build an IVR menu, record and retrieve, route to a queue, programmatic notifications, embed WebRTC, live mid-call data-dip.
- [SDKs, helper libraries & CLI](https://telvox.dev/connect/docs/sdks): Planned server SDKs (Node/Python/PHP/Java/Ruby/Go), client WebRTC SDKs, and the `telvox` CLI — all planned/preview, not yet published.

## API Reference

- [API Reference — overview & auth](https://telvox.dev/connect/docs/api): Base URL https://api.telvox.dev/v1, Bearer-token auth with an API key, errors, pagination, rate limits, and the resource index (developer preview; endpoints illustrative).
- [Call resource](https://telvox.dev/connect/docs/api/calls): Create/fetch/list/update calls (flat /v1/calls), status enum, and StatusCallback events (initiated/ringing/answered/completed).
- [Recording resource](https://telvox.dev/connect/docs/api/recordings): Fetch/list/delete recordings (/v1/recordings), RecordingStatus enum (in-progress/completed/absent/failed), signed-URL retrieval and retention.
- [Conference & Participants](https://telvox.dev/connect/docs/api/conferences): Conferences (/v1/conferences) plus the participants subresource — add/remove, hold/mute. No advertised participant ceiling.
- [Queue & Members](https://telvox.dev/connect/docs/api/queues): ACD queues (/v1/queues) plus members — maxWait/maxSize/MOH/overflow, grounded in the real Redis-backed FIFO/longest-idle queue.
- [PhoneNumbers](https://telvox.dev/connect/docs/api/phone-numbers): List/fetch/update assigned numbers (/v1/phone-numbers) and set answer URL / caller-ID rotation. Self-serve search + purchase is roadmap.
- [Webhooks / Event subscriptions](https://telvox.dev/connect/docs/api/webhooks): Manage subscriptions (/v1/webhooks) over the 9 lifecycle events — event-type enum, delivery payload schema, and signatures.
- [Access Tokens (WebRTC)](https://telvox.dev/connect/docs/api/access-tokens): Server-side mint of short-lived JWTs with a voice grant (/v1/access-tokens) for browser/mobile clients; the secret never reaches the client.
- [Messages (preview)](https://telvox.dev/connect/docs/api/messages): Send WhatsApp or email (/v1/messages, channel: whatsapp|email) — preview. Explicit exclusions: no SMS/MMS, no Video, no Fax.

## Pricing

- [Connect pricing](https://telvox.dev/connect/pricing): Usage-based model and dimensions stated honestly with no published per-minute/per-number rates — Pay-as-you-go → Volume → Committed/Enterprise; talk to sales for rates against your volume (developer preview).
- [Changelog](https://telvox.dev/connect/changelog): Developer release notes for the v0.x preview API — additive/changed/deprecated entries; breaking changes possible before GA.
- [Get API keys / Console (preview)](https://telvox.dev/connect/signup): Join the developer preview — we provision sandbox credentials (sandbox Account SID + API key, a test number, docs access); instant self-serve console is roadmap.