Why VoiceOI for BPOs

VoiceOI is a professional orchestration system for high-volume outbound calling. We eliminate the cost of human agents while maintaining absolute audio quality and compliance across your entire dialer ecosystem. Instead of slow, single-threaded bots, we use a **Local Dialer Link** that connects directly to your VICIdial carriers for instant response times.

Operational Impact

Reduce Cost per Minute by 50%+
Unlimited Concurrent Bot Seats
Direct VICIdial / Asterisk handshakes
PCI/HIPAA Compliant Data Paths

Need 50+ Seats?

Our Enterprise team handles the entire setup for high-scale operations.

Global Seat Management

Our architecture is designed for massive scale: **Centralized Strategy, Local Call Execution.**

1. The Master Dashboard (Operations)

Use the Master Dashboard to manage your entire fleet. This is where you build campaign logic, compliance rules, and sales scripts. Updates here propagate to all agents globally in 15ms.

2. Local Bot Nodes (Carrier Link)

Bot Nodes are lightweight workers installed near (or on) your dialer servers. They talk directly to your carriers to ensure minimum latency and the highest audio quality possible for your campaigns.

Security Model

Traffic between Master and Bots is authenticated via an X-Organization-Secret header. We recommend isolating nodes in a private VPC and using the Master Server as a reverse-proxy Gateway if exposing them publicly.

Master Server Config

Ensure your environment variables are correctly configured for production scale.

Environment Variables (.env)

# Database
DB_HOST=your-postgres-host
DB_PORT=5432
DB_USER=voi_admin
DB_PASS=secure_password
DB_NAME=voiceoi

# Redis (Event Bus)
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=if_any

# Security
JWT_SECRET=super_secret_for_dashboard
SYNC_SECRET_SALT=random_string_for_org_keys

**Note:** The `SYNC_SECRET_SALT` is used to derive individual organization keys. Protect this with extreme caution.

Bot Node Deployment

Bot nodes are deployed using a "thin client" approach. You don't need a database on the node; it pulls everything it needs from the Master.

Deployment Steps

Build Artifact: Run `npm run build:bot` on the Master server to generate the optimized production package.

Transfer: Copy the `dist/` and `package.json` to your target node server.

Configure: Set `SERVICE_MODE=bot` and `SYNC_MASTER_URL=https://master.yourdomain.com`.

PM2 Command

pm2 start dist/index.js --name "voiceoi-bot" -- \
  SERVICE_MODE=bot \
  SYNC_MASTER_URL=http://master-ip:4000 \
  SYNC_SECRET_KEY=PASTE_KEY_FROM_DASHBOARD

VICIdial Integration

VoiceOI is designed specifically to slide into your existing VICIdial or Asterisk workflow. We replace static, slow scripts with a high-speed "Handshake" that connects your dialer trunk to our voice engine.

The "Voice Handshake"

When a call is answered, VICIdial sends a small signal (AGI) to our local node. Our node does a quick check-in with the Master brain, grabs your current script, and starts talking - all in under 100 milliseconds.

Sample Dialer Config

# Add this to your VICIdial Custom Dialplan
exten => _X.,1,AGI(agi://localhost:4573/voiceoi_handshake)
exten => _X.,n,Hangup()

Enterprise Pro Tip

For maximum reliability, run our "Bot Node" on the same physical server as your Asterisk/VICIdial instance. This removes all network lag, giving your voice agents the absolute clearest audio quality possible.

Compliance & Security

BPOs operate in heavily regulated industries. VoiceOI provides the safeguards needed for PCI and HIPAA environments.

Data Isolation

Every organization has its own unique encryption keys. Your customer data and recordings are never mixed with other clients.

Encryption in Transit

All communication between your dialers, our nodes, and the master brain is encrypted using 256-bit TLS security.

Enterprise Scaling

Managing 10 agents is easy. Managing 10,000 agents requires VoiceOI. Our system is built to scale horizontally using a cluster approach.

Scaling Roadmap

Deploy 1 Master Dashboard to manage all logic.

Add 1 Bot Node per region or per dialer server.

Sync thousands of bots instantly across the world.

API Reference

GET/api/sync/campaigns

Master -> Bot

Returns the full configuration bundle for an organization. Used by bots on cold-start.

Header Required

X-Sync-Token

Query Params

org_id

POST/api/sync/logs

Bot -> Master

High-throughput ingestion for call logs and agent activity.

{ "call_id": "...", "duration": 45, "status": "no_answer" }

System V2.1.4