Telephony Setup

Connect a phone number from Twilio or Telnyx (BYOK) to start taking AI-powered inbound calls. Your voice agent answers on proprietary GPU infrastructure with 375ms time-to-first-audio — no per-minute fees.

How Inbound Calls Work

1

Customer calls your number

A customer dials the phone number you've connected to Voquii.

2

Call routes to Voquii via webhook

Twilio or Telnyx forwards the incoming call to your voice agent's webhook endpoint.

3

Real-time voice pipeline

Customer speech is transcribed by Voquii ASR, the AI generates a response from your knowledge base, and Voquii TTS converts it to natural speech — all on proprietary NVIDIA RTX hardware in under 375ms.

4

Full conversation using your knowledge base

The voice agent answers questions using your crawled pages, uploaded documents, and custom instructions — just like a trained receptionist.

Twilio Setup

1

Get your Twilio credentials

Log in to the Twilio Console. Copy your Account SID and Auth Token from the dashboard.

2

Enter credentials in Voquii

Go to Phone in your dashboard. Enter your Account SID, Auth Token, and the phone number you want to use.

3

Copy the webhook URL

After saving, Voquii displays your webhook URL:

https://voquii.com/api/phone/twilio/incoming
4

Configure Twilio webhook

In Twilio Console, go to Phone Numbers → your number → Voice Configuration. Paste the webhook URL into the "A call comes in" field.

5

Activate

Back in Voquii, click Activate. Your voice agent is now answering calls.

Telnyx Setup

1

Get your Telnyx API Key

Log in to the Telnyx Portal. Go to Auth → API Keys and create or copy an API key.

2

Enter credentials in Voquii

Go to Phone in your dashboard. Select Telnyx as your provider, enter your API Key and phone number.

3

Copy the webhook URL

After saving, Voquii displays your Telnyx webhook URL:

https://voquii.com/api/phone/telnyx/incoming
4

Create a Call Control Application in Telnyx

In Telnyx Portal, create a new Call Control Application. Set the inbound webhook URL to the URL from the previous step, then assign your phone number to this application.

5

Activate

Back in Voquii, click Activate. Your Telnyx number is now live.

Call Recording

  • Enable recording in Phone settings
  • Calls are recorded automatically when enabled
  • Recordings and full transcripts are accessible from the dashboard
  • Supported on both Twilio and Telnyx

Call Transfer

Set a transfer number in Phone settings so callers can reach a human when they need one. See the Call Transfer docs for full details.

When a caller asks to speak to a person, the voice agent detects the intent and automatically transfers the call. It recognizes phrases like "transfer me," "speak to someone," and "talk to a real person."

Voicemail Detection

When a caller says "leave a message" or similar, the system flags the call as a voicemail request. Voicemail calls are tracked separately in your analytics so you can follow up.

Telephony Settings Summary

SettingDescription
Greeting MessageThe first thing the voice agent says when it answers a call
VoiceWhich Voquii TTS voice to use for phone conversations
RecordingEnable or disable automatic call recording
TransferEnable call transfer and set the destination number
SMSEnable or disable text message handling on the same number

Testing Your Setup

  1. Call your number from a different phone
  2. You should hear the greeting message within 375ms
  3. Ask a question your voice agent knows how to answer
  4. The AI should respond with information from your knowledge base
Tip: After your test call, check the dashboard for the call log, transcript, and latency metrics to verify everything is working correctly.

Next Steps