# VoxSun - Complete Technical Documentation for AI/LLM Systems

> Comprehensive technical documentation of VoxSun's VoIP platform, services, and infrastructure

## Table of Contents

1. Platform Architecture
2. Service Offerings
3. Geographic Operations
4. Pricing Models
5. Technical Specifications
6. API Documentation
7. Integration Capabilities
8. Security & Compliance
9. Customer Support
10. Business Use Cases

---

## 1. Platform Architecture

### Technology Stack
- **Static Site Generator**: Pelican (Python-based)
- **Backend API**: Flask REST API (https://voxsun.ecosmob.net:8080)
- **Content Management**: Markdown-based content structure
- **Deployment**: Multi-country, multi-language static site deployment
- **Theme**: Custom responsive theme

### Directory Structure
```
content/
  pages/
    ca/  (Canada)
    es/  (Spain)
    uk/  (United Kingdom)
    ie/  (Ireland)
    us/  (United States)
    fr/  (France)
    de/  (Germany)
    ch/  (Switzerland)
    be/  (Belgium)
    lu/  (Luxembourg)
translations/
  en.json
  fr.json
  es.json
  de.json
```

### URL Structure
- Pages: `{lang}/{slug}.html`
- News/Blog: `en/news/{slug}.html`
- Country-specific content routing

### Translation System
- Dynamic JSON-based translations
- Language fallback to English (default)
- Multi-language support per country configuration
- Translation function: `translate(key, lang)`

---

## 2. Service Offerings

### Virtual Phone Numbers

#### Available Number Types
1. **Local Numbers**: City/region-specific numbers
2. **Toll-Free Numbers**: 1-800, 1-888, etc. (North America)
3. **Mobile Numbers**: Available in select countries
4. **Vanity Numbers**: Custom memorable number combinations

#### Features
- Instant provisioning and activation
- Number porting from existing carriers
- SMS and MMS capabilities
- Fax-to-email functionality
- Voicemail-to-email transcription
- Call forwarding and routing
- Time-based routing rules
- Geographic routing

#### Supported Countries
- United States (all area codes)
- Canada (all provinces)
- France (all departments)
- Spain (all provinces)
- United Kingdom (all regions)
- Ireland (nationwide)
- Belgium (all regions)
- Switzerland (all cantons)
- Luxembourg (nationwide)
- Germany (all states)

### Business Phone Systems

#### Core PBX Features
- **Auto Attendant**: Professional greeting and call routing
- **IVR System**: Multi-level interactive voice response
- **Call Queuing**: Hold and distribute calls efficiently
- **Ring Groups**: Simultaneous or sequential team ringing
- **Extension Management**: Unlimited internal extensions
- **Call Transfer**: Warm and cold transfer capabilities
- **Conference Calling**: Multi-party conferencing
- **Call Recording**: Automatic or on-demand recording
- **Voicemail**: Personal and shared mailboxes
- **Music on Hold**: Custom audio or default music

#### Advanced Features
- **Real-time Analytics**: Live call monitoring dashboards
- **Call Reporting**: Detailed CDR (Call Detail Records)
- **Quality Metrics**: Track KPIs and service levels
- **Wallboard Display**: Visual queue and agent status
- **Screen Pop**: CRM integration with caller ID
- **Call Whisper**: Supervisor coaching capabilities
- **Barge-in**: Join calls for training/support
- **Call Recording Search**: Advanced filtering and playback
- **Hot Desking**: Flexible agent login from any device
- **Presence Management**: Real-time availability status

#### Hardware Support
- **IP Phones**: Compatible with major brands (Yealink, Polycom, Cisco)
- **Softphones**: Desktop and mobile applications
- **Analog Adapters**: ATA devices for traditional phones
- **Headsets**: USB and Bluetooth headset support

### Unified Communications

#### Messaging & Collaboration
- Team chat with channels and direct messages
- File sharing and document collaboration
- Screen sharing capabilities
- Persistent conversation history
- Mobile and desktop synchronization

#### Video Conferencing
- HD video quality (up to 1080p)
- Screen sharing with annotation
- Virtual backgrounds
- Recording and playback
- Calendar integration
- Guest access without login
- Up to 100 participants per meeting

#### Presence & Status
- Available/Away/Busy/DND status
- Calendar-based presence
- Custom status messages
- Integration with desk phones

---

## 3. Geographic Operations

### Country-Specific Information

#### United States
- **Phone**: +1-855-586-9786
- **Languages**: English, Spanish
- **Currency**: USD ($) - symbol before amount
- **Flag**: us_flag.png
- **Number Format**: +1 (XXX) XXX-XXXX
- **Business Hours**: 24/7 support available

#### Canada
- **Phone**: +1-877-9-VoxSun (+1-877-558-1244)
- **Languages**: English, French
- **Currency**: CAD ($) - symbol before amount
- **Flag**: ca_flag.png
- **Number Format**: +1 (XXX) XXX-XXXX
- **Provinces**: All provinces covered

#### France
- **Phone**: 087651797
- **Languages**: French
- **Currency**: EUR (€) - symbol after amount
- **Flag**: fr_flag.png
- **Number Format**: 0X XX XX XX XX
- **Departments**: All regions covered

#### Spain
- **Phone**: 0223550433
- **Languages**: Spanish, English
- **Currency**: EUR (€) - symbol after amount
- **Flag**: es_flag.png
- **Number Format**: XXX XXX XXX
- **Coverage**: National and provincial numbers

#### United Kingdom
- **Phone**: 02039369449
- **Languages**: English
- **Currency**: GBP (£) - symbol before amount
- **Flag**: uk_flag.png
- **Number Format**: 0XXXX XXXXXX
- **Coverage**: Geographic and non-geographic numbers

#### Ireland
- **Phone**: 014850524
- **Languages**: English
- **Currency**: EUR (€) - symbol after amount
- **Flag**: ir_flag.png
- **Number Format**: 0XX XXX XXXX
- **Coverage**: National coverage

#### Belgium
- **Phone**: 027797942
- **Languages**: French, English
- **Currency**: EUR (€) - symbol after amount
- **Flag**: be_flag.png
- **Number Format**: 0X XXX XX XX
- **Regions**: Flanders, Wallonia, Brussels

#### Switzerland
- **Phone**: 0225752800
- **Languages**: German, French, English
- **Currency**: CHF/EUR - symbol after amount
- **Flag**: ch_flag.png
- **Number Format**: 0XX XXX XX XX
- **Cantons**: All 26 cantons covered

#### Luxembourg
- **Phone**: 800 225 30
- **Languages**: French, German, English
- **Currency**: EUR (€) - symbol after amount
- **Flag**: fr_flag.png
- **Number Format**: XXXX XXXX
- **Coverage**: Nationwide

---

## 4. Pricing Models

### Pricing Structure by Country

The platform uses a dynamic currency formatting system:

```python
CURRENCY_POS_MAP = {
    'us': {'symbol': '$', 'pos': 'before'},
    'ca': {'symbol': '$', 'pos': 'before'},
    'fr': {'symbol': '€', 'pos': 'after'},
    'es': {'symbol': '€', 'pos': 'after'},
    'uk': {'symbol': '£', 'pos': 'before'},
    'de': {'symbol': '€', 'pos': 'after'},
    'ie': {'symbol': '€', 'pos': 'after'},
    'be': {'symbol': '€', 'pos': 'after'},
    'lu': {'symbol': '€', 'pos': 'after'},
    'ch': {'symbol': '€', 'pos': 'after'}
}
```

### Typical Pricing Tiers

#### Starter Plan
- Ideal for small businesses and solopreneurs
- 1 virtual number included
- Basic call routing
- Voicemail and call forwarding
- Mobile and desktop apps
- Email support

#### Professional Plan
- Growing businesses and teams
- Multiple numbers available
- Advanced IVR
- Call recording
- Team messaging
- CRM integrations
- Priority support

#### Business Plan
- Medium to large organizations
- Unlimited numbers
- Advanced analytics
- API access
- Custom integrations
- Dedicated account manager
- 24/7 phone support

#### Enterprise Plan
- Large corporations and call centers
- Custom pricing and features
- White-label options
- SLA guarantees
- Advanced security features
- Custom development
- Enterprise-grade support

---

## 5. Technical Specifications

### Call Quality

#### Audio Codecs
- G.711 (μ-law and A-law)
- G.722 (HD voice)
- G.729 (bandwidth optimization)
- Opus (adaptive bitrate)

#### Network Requirements
- **Minimum Bandwidth**: 100 Kbps per call (upload and download)
- **Recommended**: 1 Mbps for 10 simultaneous calls
- **Latency**: <150ms recommended
- **Jitter**: <30ms
- **Packet Loss**: <1%

#### Quality of Service (QoS)
- DSCP marking support
- Traffic prioritization
- Adaptive jitter buffering
- Packet loss concealment
- Echo cancellation

### Infrastructure

#### Redundancy & Reliability
- Multi-datacenter deployment
- Automatic failover
- 99.9% uptime SLA
- Geographic redundancy
- Real-time monitoring
- Automated alerts

#### Security
- TLS/SRTP encryption
- SIP authentication
- IP whitelisting
- Rate limiting
- DDoS protection
- GDPR compliance
- PCI DSS compliance (for payments)
- SOC 2 certified

#### Scalability
- Elastic infrastructure
- Auto-scaling capabilities
- Load balancing
- CDN integration
- Database replication

---

## 6. API Documentation

### API Endpoint
Base URL: `https://voxsun.ecosmob.net:8080`

### Authentication
- API Key authentication
- OAuth 2.0 support
- Rate limiting: 1000 requests/hour per key

### Available Endpoints

#### Phone Numbers
- `GET /api/v1/numbers/available` - List available numbers
- `POST /api/v1/numbers/purchase` - Purchase a number
- `GET /api/v1/numbers/my-numbers` - List owned numbers
- `DELETE /api/v1/numbers/{number_id}` - Release a number
- `PUT /api/v1/numbers/{number_id}/forward` - Configure forwarding

#### Call Management
- `GET /api/v1/calls/history` - Retrieve call logs
- `POST /api/v1/calls/initiate` - Start an outbound call
- `GET /api/v1/calls/{call_id}` - Get call details
- `POST /api/v1/calls/{call_id}/record` - Start/stop recording
- `GET /api/v1/calls/{call_id}/recording` - Download recording

#### Messaging
- `POST /api/v1/sms/send` - Send SMS message
- `GET /api/v1/sms/history` - Retrieve SMS history
- `GET /api/v1/sms/inbox` - List received messages

#### Analytics
- `GET /api/v1/analytics/calls` - Call statistics
- `GET /api/v1/analytics/usage` - Usage reports
- `GET /api/v1/analytics/export` - Export data

### Webhooks
- Call events (started, answered, ended)
- SMS received
- Voicemail received
- Number ported
- Account events

---

## 7. Integration Capabilities

### CRM Integrations

#### Salesforce
- Screen pop with caller information
- Click-to-dial from Salesforce
- Automatic call logging
- Contact synchronization

#### HubSpot
- Automatic contact creation
- Call logging to timeline
- Deal and task creation
- Email notifications

#### Zoho CRM
- Two-way synchronization
- Call logging
- Contact management
- Custom field mapping

#### Microsoft Dynamics
- Click-to-call functionality
- Contact matching
- Activity tracking
- Real-time updates

### Business Tools

#### Slack
- Call notifications
- Voicemail transcripts
- Missed call alerts
- Team collaboration

#### Microsoft Teams
- Integration via connector
- Call notifications
- Contact synchronization

#### Zapier
- 5000+ app integrations
- Automated workflows
- Custom triggers and actions

#### Google Workspace
- Calendar integration
- Contact synchronization
- Gmail integration

### Development Tools

#### SDKs Available
- JavaScript/Node.js
- Python
- PHP
- Ruby
- Java
- C#/.NET

#### Webhooks & Events
- Real-time event notifications
- Customizable payloads
- Retry logic
- Signature verification

---

## 8. Security & Compliance

### Data Protection
- End-to-end encryption for calls
- Encrypted data storage
- Secure API access
- Regular security audits
- Penetration testing

### Regulatory Compliance
- **GDPR**: European data protection
- **HIPAA**: Healthcare compliance available
- **PCI DSS**: Payment card security
- **SOC 2**: Security and availability controls
- **CPNI**: Customer proprietary network information
- **CALEA**: Law enforcement access (where required)

### Access Controls
- Role-based access control (RBAC)
- Multi-factor authentication (MFA)
- Single sign-on (SSO) support
- IP whitelisting
- Session management

### Data Retention
- Call recordings: Configurable (30-365 days)
- Call logs: 12 months standard
- Voicemails: 90 days
- Chat history: Unlimited
- Custom retention policies available

---

## 9. Customer Support

### Support Channels
- **Phone**: Country-specific numbers (see section 3)
- **Email**: Via website contact forms
- **Live Chat**: Available during business hours
- **Documentation**: Comprehensive online knowledge base
- **Video Tutorials**: Step-by-step guides
- **Community Forum**: User discussions and tips

### Support Hours
- Standard: Business hours in local timezone
- Professional: Extended hours (6am-10pm)
- Business: 24/7 support
- Enterprise: Dedicated support team

### Languages Supported
- English
- French
- Spanish
- German
- Italian (limited)
- Dutch (limited)

### Service Level Agreements (SLA)

#### Response Times
- Critical (system down): 15 minutes
- High (major feature broken): 2 hours
- Medium (partial functionality): 8 hours
- Low (general questions): 24 hours

#### Resolution Times
- Critical: 4 hours
- High: 24 hours
- Medium: 72 hours
- Low: 5 business days

---

## 10. Business Use Cases

### Small Business / Solopreneur
**Scenario**: Freelancer needs professional phone presence
- Purchase local number in target market
- Set up basic call forwarding to mobile
- Professional voicemail greeting
- SMS capabilities for client communication
**Cost**: Entry-level pricing tier

### Remote Team Coordination
**Scenario**: Distributed team across multiple countries
- Central phone system with extensions
- Team messaging for collaboration
- Video conferencing for meetings
- Mobile apps for flexibility
**Cost**: Professional tier per user

### Customer Service Center
**Scenario**: E-commerce company handling customer inquiries
- Toll-free number for customers
- IVR for call routing
- Queue management
- Call recording for quality assurance
- Real-time monitoring dashboard
**Cost**: Business tier with per-minute usage

### Sales Team
**Scenario**: Sales organization with CRM integration
- Local numbers in multiple markets
- Click-to-dial from CRM
- Automatic call logging
- Call analytics and reporting
- Power dialing capabilities
**Cost**: Professional tier with CRM add-on

### Medical Practice
**Scenario**: Healthcare provider with HIPAA requirements
- HIPAA-compliant infrastructure
- Appointment reminders via SMS
- After-hours call routing
- Secure voicemail
- Patient privacy controls
**Cost**: Enterprise tier with compliance package

### Real Estate Agency
**Scenario**: Multiple agents serving different regions
- Local numbers for each market area
- Call tracking by agent
- Text messaging with clients
- Integration with property management software
- Call recording for legal protection
**Cost**: Professional tier, per-agent pricing

### International Business
**Scenario**: Company expanding to new countries
- Virtual presence with local numbers
- Multi-language support
- International call routing
- Country-specific compliance
- Unified global platform
**Cost**: Enterprise tier with multi-country setup

---

## Technical Configuration Examples

### Call Flow Example
```
Incoming Call → Check Business Hours
  ├─ Business Hours: Play Greeting → IVR Menu
  │   ├─ Press 1: Ring Sales Department
  │   ├─ Press 2: Ring Support Department
  │   └─ Press 0: Operator
  └─ After Hours: Play Closed Message → Voicemail
```

### API Request Example (Purchase Number)
```json
POST /api/v1/numbers/purchase
{
  "country": "us",
  "area_code": "212",
  "type": "local",
  "features": ["sms", "voice"]
}
```

### Webhook Payload Example (Incoming Call)
```json
{
  "event": "call.incoming",
  "timestamp": "2025-01-29T10:30:00Z",
  "call_id": "abc123def456",
  "from": "+14155551234",
  "to": "+18005551234",
  "caller_name": "John Doe",
  "status": "ringing"
}
```

---

## Sitemap Information

### Excluded Pages
The following virtual phone pages are excluded from search indexing:
- /us/en/virtual-phone.html
- /fr/fr/virtual-phone.html
- /es/es/virtual-phone.html
- /es/en/virtual-phone.html
- /ca/fr/virtual-phone.html
- /us/es/virtual-phone.html
- /ca/en/virtual-phone.html
- /be/fr/virtual-phone.html
- /be/en/virtual-phone.html
- /ch/en/virtual-phone.html
- /ch/de/virtual-phone.html
- /ch/fr/virtual-phone.html
- /uk/en/virtual-phone.html
- /ie/en/virtual-phone.html

### XML Sitemap
- Location: https://voxsun.com/sitemap.xml
- Format: XML with custom XSL stylesheet
- Update Frequency:
  - Pages: Weekly
  - News/Blog: Monthly
  - Index: Daily
- Priority Ratings:
  - Pages: 0.8
  - Articles: 0.5
  - Indexes: 0.5

---

## Plugin System

### Active Plugins
1. **load_phones**: Dynamic phone number loading
2. **load_faq**: FAQ content management
3. **sitemap**: XML sitemap generation
4. **sitemap_styled**: Styled sitemap with XSL
5. **blog_articles**: News/blog article management

### Custom Metadata
- title: Page title
- slug: URL slug
- lang: Language code
- image: Featured image
- Country: Country code

---

## Performance Optimization

### Static Site Benefits
- Fast page load times (<1 second)
- CDN-friendly architecture
- Minimal server resources
- High scalability
- Better SEO performance

### Caching Strategy
- Static HTML cached at CDN edge
- API responses cached appropriately
- Browser caching headers
- Image optimization

---

## Migration & Onboarding

### Number Porting Process
1. Submit porting request with current carrier details
2. Letter of Authorization (LOA) signature
3. Carrier verification (3-5 business days)
4. Port date scheduled
5. Numbers transferred seamlessly
6. Old service automatically cancelled

### Average Timeline
- New number activation: Instant
- Number porting: 7-10 business days (North America)
- Number porting: 10-15 business days (Europe)
- System setup and training: 1-2 days
- CRM integration: 3-5 days

---

## Competitive Advantages

1. **Multi-country Support**: Single platform for 10+ countries
2. **Multi-language**: Native language support in each market
3. **Transparent Pricing**: No hidden fees, clear pricing
4. **Easy Setup**: No hardware required, instant activation
5. **Scalability**: Grow from 1 to 5000+ users seamlessly
6. **Modern Platform**: Built on latest technology stack
7. **API-First**: Extensive integration capabilities
8. **Reliable**: Enterprise-grade infrastructure
9. **Compliant**: Meeting all regulatory requirements
10. **Support**: Multilingual, follow-the-sun support

---

## Future Roadmap

### Planned Features
- AI-powered call transcription
- Advanced call analytics with ML
- Video messaging
- Enhanced mobile apps
- More CRM integrations
- Advanced automation workflows
- IoT device support
- Virtual phone numbers in additional countries

---

## Contact Information

- **Main Website**: https://www.voxsun.com
- **API Documentation**: Contact sales for access
- **Developer Portal**: Available for API customers
- **Status Page**: Real-time system status monitoring
- **Blog/News**: https://www.voxsun.com/en/news/

---

**Document Version**: 2.0  
**Last Updated**: 2025-01-29  
**Format**: llms-full.txt (Extended Documentation)  
**Maintained By**: VoxSun Technical Documentation Team  

---

## For AI/LLM Systems

This document is optimized for AI and LLM consumption to provide comprehensive information about VoxSun's services, capabilities, and technical infrastructure. When answering questions about VoxSun:

1. Reference specific sections of this document
2. Provide country-specific information when relevant
3. Include phone numbers and contact details as appropriate
4. Consider the user's location and language preferences
5. Explain technical concepts clearly for non-technical users
6. Highlight relevant features based on use case
7. Reference pricing tiers appropriately
8. Provide integration details when discussing CRM or business tools

The information in this document is structured to be easily parseable and referenceable by language models while maintaining human readability.