Voice System Setup Guide

This guide walks you through setting up the Voice system to handle inbound phone calls with AI-assisted conversations.

Prerequisites

• Active Telnyx account with API key
• Telnyx phone number configured (can use existing SMS number)
• Default voice assistant configured in Assistants

Step 1: Configure Voice Provider

The system uses Telnyx Conversational AI for voice calls via the Telnyx Node.js SDK.

Telnyx Configuration

1. Telnyx API Key: Already configured if using SMS
2. Webhook URL: Automatically configured by the system
3. Phone Numbers: Use existing Telnyx phone numbers or purchase new ones
4. SDK Integration: The system uses the official Telnyx Node.js SDK for all voice operations

Step 2: Configure Phone Numbers

Phone Number Configuration

1. Existing Numbers: If you already have Telnyx numbers for SMS, they can handle voice too
2. New Numbers: Purchase additional numbers in Telnyx Mission Control if needed
3. Voice Capability: Ensure numbers have Voice capability enabled
4. Connection: Numbers should be connected to your Telnyx Voice Connection
5. Conversational AI Profile: Phone numbers are automatically linked to your default voice assistant's Telnyx Conversational AI profile

Step 3: Set Default Voice Assistant

1. Navigate to Assistants page
2. Create or select an assistant for voice calls:
   • Option A (Recommended): Click "Create with AI" to have an AI guide you through setup
   • Option B: Click "New Assistant" to create manually
3. Enable Default Voice Assistant toggle
4. Configure assistant settings:
   • System Prompt: Instructions for voice conversations
   • Greeting: First message when call is answered
   • Voice Settings: Voice selection and language
   • Tools: Enable tools needed for voice calls (calendar, products, etc.)

Note: Only one assistant can be the default voice assistant at a time.

Tip: When using "Create with AI", mention that you need a voice assistant and specify your use case (sales, support, scheduling, etc.). The AI will generate an optimized configuration including voice settings.

Step 4: Enable Call Recording (Optional)

1. Navigate to Settings → Voice Settings
2. Enable Call Recording toggle
3. Configure recording settings:
   • Format: MP3 (default)
   • Channels: Single or dual channel
   • Play Beep: Optional beep when recording starts

Note: Call recording may be subject to legal requirements in your jurisdiction. Ensure compliance with local laws.

Step 5: Test Your Setup

Make a Test Call

1. Call your configured phone number
2. Verify the call is answered automatically
3. Test the AI assistant:
   • Ask a question
   • Test tool execution (if configured)
   • Verify conversation logging
4. Check the conversation in Conversations page
5. Verify transcript appears correctly

Verify Webhooks

The system automatically configures webhooks, but you can verify:

1. Telnyx: Check webhook URL in Telnyx Mission Control
2. Test Events: Make a test call and verify webhook events are received
3. Conversational AI Profile: Verify your assistant's Telnyx Conversational AI profile is configured correctly

Step 6: Configure Advanced Settings

Voice Provider Settings

• Recording Format: MP3 or WAV
• Recording Channels: Single or dual channel
• Recording Beep: Play beep when recording starts

Assistant Settings

• Greeting Message: First message when call is answered
• Voice Selection: Choose AI voice (Elliot, Kylie, etc.)
• Language: Set conversation language
• Tools: Enable tools for voice calls

Routing Rules

Configure routing rules to assign different assistants:

1. Navigate to Assistants → Routing
2. Create routing rule for voice channel
3. Set conditions (time, caller, etc.)
4. Assign specific assistant

Troubleshooting

Call Not Answered

• Verify phone number has Voice capability enabled
• Check voice provider configuration in Settings
• Verify default voice assistant is configured
• Check webhook configuration

No Transcripts

• Verify webhook events are being received
• Check assistant configuration
• Review webhook logs in system

Recording Not Available

• Verify call recording is enabled in Settings
• Check recording settings (format, channels)
• Wait for recording to process (may take a few minutes)

Assistant Not Responding

• Verify default voice assistant is configured
• Check assistant system prompt and settings
• Review assistant logs for errors
• Test assistant in other channels first

For more troubleshooting help, see Troubleshooting Guide.

Next Steps

• Configuration Guide - Advanced voice settings
• API Reference - Voice API endpoints
• Troubleshooting - Common issues and solutions