@atrix.dev/ai-voice-sdk

AI Voice Caller SDK

Create AI-powered voice calls with natural language processing and voice synthesis.

Features

Category	Features
Voice Calls	• Outbound calls • SMS messaging • Real-time call monitoring • Call status tracking • Concurrent call handling
AI Integration	• Natural voice synthesis • Multi-voice support • Emotion detection • Conversation management • Context awareness
Analytics	• Call metrics tracking • Cost monitoring • Success rate analysis • Duration tracking • Sentiment analysis
Developer Tools	• WebSocket monitoring • Caching system • Rate limiting • Health checks • Detailed logging

Installation

npm install @atrix.dev/ai-voice-sdk

Quick Start

import { AIVoiceCaller } from '@atrix.dev/ai-voice-sdk';

// Initialize the SDK
const voiceCaller = new AIVoiceCaller({
  apiKey: 'your_api_key',
  twilioAccountSid: 'your_twilio_sid',
  twilioAuthToken: 'your_twilio_token',
  twilioPhoneNumber: 'your_twilio_number',
  elevenLabsApiKey: 'your_elevenlabs_key',
  elevenLabsVoiceId: 'your_voice_id'
});

// Make a call
const result = await voiceCaller.makeCall({
  to: '[phone]',
  message: 'Hello from AI Voice!'
});

// Send an SMS
const sms = await voiceCaller.sendSMS(
  '[phone]', 
  'Hello from AI Voice!'
);

Configuration Options

Option	Type	Required	Default	Description
apiKey	string	✓	-	Your Atrix API key
twilioAccountSid	string	✓	-	Twilio Account SID
twilioAuthToken	string	✓	-	Twilio Auth Token
twilioPhoneNumber	string	✓	-	Your Twilio phone number
elevenLabsApiKey	string	✓	-	ElevenLabs API key
elevenLabsVoiceId	string	✓	-	ElevenLabs voice ID
baseUrl	string	-	https://api.atrix.dev	API base URL
logLevel	string	-	'info'	Logging level (debug/info/warn/error)
maxConcurrentCalls	number	-	5	Maximum concurrent calls
cacheTTL	number	-	300000	Cache TTL in milliseconds
cacheMaxSize	number	-	1000	Maximum cache entries
retryAttempts	number	-	3	Number of retry attempts
timeout	number	-	30000	Request timeout in milliseconds

API Reference

Voice Calls

// Make a voice call
const call = await voiceCaller.makeCall({
  to: '[phone]',
  message: 'Hello!',
  voiceSettings: {
    stability: 0.7,
    similarityBoost: 0.5,
    style: 0.5,
    useSpeakerBoost: true
  }
});

// End a call
await voiceCaller.endCall('call_id');

// Get call history
const history = await voiceCaller.getCallHistory(10);

// Get call metrics
const metrics = await voiceCaller.getCallMetrics('call_id');

SMS Messaging

// Send SMS
const sms = await voiceCaller.sendSMS(
  '[phone]',
  'Hello from AI Voice!'
);

Real-time Monitoring

// Listen for call status updates
voiceCaller.onCallStatus((status) => {
  console.log('Call status:', status);
});

// Listen for errors
voiceCaller.onError((error) => {
  console.error('Error:', error);
});

Analytics & Metrics

// Get aggregate metrics
const metrics = await voiceCaller.getMetrics();

// Get conversation transcript
const transcript = await voiceCaller.getConversationTranscript('call_id', {
  format: 'json',
  includeTiming: true,
  speakerLabels: true
});

Error Handling

Error Code	Description	Common Causes
INVALID_CONFIG	Configuration error	Missing required fields, invalid format
TWILIO_ERROR	Twilio API error	Invalid credentials, rate limits
ELEVENLABS_ERROR	ElevenLabs API error	Invalid API key, voice ID
NETWORK_ERROR	Network request failed	Timeout, connection issues
CALL_FAILED	Call operation failed	Invalid phone number, service unavailable
SMS_FAILED	SMS operation failed	Invalid phone number, service unavailable
VALIDATION_ERROR	Input validation failed	Invalid phone format, missing data

Best Practices

1. Rate Limiting

   • Monitor your API usage
   • Implement proper error handling
   • Use the built-in rate limiter

2. Resource Management

   • Clean up resources with disconnect()
   • Monitor memory usage with metrics
   • Use caching for frequent requests

3. Error Handling

   • Always implement error handlers
   • Use try-catch blocks
   • Monitor error rates

4. Performance

   • Enable caching for repeated calls
   • Use concurrent call limits
   • Monitor call metrics

Examples

Advanced Call Setup

const call = await voiceCaller.makeCall({
  to: '[phone]',
  message: 'Hello!',
  voiceSettings: {
    stability: 0.7,
    similarityBoost: 0.5,
    style: 0.5,
    useSpeakerBoost: true
  },
  webhookEvents: ['initiated', 'ringing', 'answered', 'completed'],
  callbackUrl: 'https://your-webhook.com/callback'
});

Health Monitoring

// Check service health
const isHealthy = await voiceCaller.checkHealth();

// Clear cache if needed
await voiceCaller.clearCache();

// Disconnect services
voiceCaller.disconnect();

Support

• Documentation: https://docs.atrix.dev/developers/ai-voice-sdk
• Issues: GitHub Issues
• Email: [e-mail]

License

MIT