Overview
Cloudonix is a cloud communications platform that enables Dograh voice agents to connect to SIP communications platform, either on-premise or in the cloud. In addition, Cloudonix exposes a full set of voice APIs, that provide a full suite of call-control capabilities and more.Prerequisites
Before setting up Cloudonix integration, you’ll need:- A Cloudonix account
- A Cloudonix domain UUID (or the domain name)
- A Cloudonix domain API Key
- A Cloudonix outbound voice trunk service provider connection
- Dograh AI instance running and accessible
Video Tutorial
Watch this step-by-step guide to set up Cloudonix with Dograh AI:Configuration
Step 1: Get Cloudonix Credentials
- Log in to your Cloudonix Console
- Find your Domain UUID and Domain API Key on the dashboard
Step 2: Configure in Dograh AI
- Navigate to Workflow → Phone Call → Configure Telephony
- Watch the Cloudonix setup video tutorial above for detailed guidance
- Select Cloudonix as your provider
- Enter your credentials:
- Domain UUID
- Domain API Key
- Click Save Configuration
Step 3: Test Your Configuration
- Create a test workflow
- Click “Test Call” to verify connection
- Check call logs for successful connection
How It Works
Outbound Calling
When you initiate a call through Dograh AI:- The system selects a phone number from your configured pool
- Cloudonix places the call to your recipient, via a pre-configured Cloudonix outbound voice trunk
- Once connected, audio streams through WebSocket for real-time voice interaction
- Call status updates are tracked throughout the lifecycle
Campaign Features
When using Cloudonix with campaigns:- Rate Limiting: Enforced per organization to prevent overwhelming
- Automatic Retry: Failed calls (busy/no-answer) are retried automatically
- Concurrent Call Management: System manages call slots to optimize throughput
Troubleshooting
Invalid phone number error
Invalid phone number error
Ensure phone numbers include country code in E.164 format:
+1234567890Authentication failed
Authentication failed
- Verify Domain UUID and Domain API Key are correct
- Check for extra spaces in credentials
- Ensure credentials haven’t been disabled or deleted in Cloudonix Console
No audio on calls
No audio on calls
- Verify WebSocket connection is established
- Check firewall rules for WebSocket traffic
- Ensure audio pipeline is configured correctly
Best Practices
- Store credentials securely in the database
- Test your configuration with a single call before running campaigns
- Monitor Cloudonix Sessions for usage