Skip to main content

​
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

  1. Log in to your Cloudonix Console
  2. Find your Domain UUID and Domain API Key on the dashboard

​
Step 2: Configure in Dograh AI

  1. Navigate to Workflow → Phone Call → Configure Telephony
  2. Watch the Cloudonix setup video tutorial above for detailed guidance
  3. Select Cloudonix as your provider
  4. Enter your credentials:
    • Domain UUID
    • Domain API Key
  5. Click Save Configuration

​
Step 3: Test Your Configuration

  1. Create a test workflow
  2. Click “Test Call” to verify connection
  3. Check call logs for successful connection

​
Inbound Calling Setup

The Dograh AI configuration for inbound calling is identical to outbound calling - use the same credentials configured above. However, you need additional setup in your Cloudonix Console to route incoming calls to Dograh AI.

​
Configure Inbound Trunk and Application

  1. Set Up Inbound Trunk:
    • Log in to your Cloudonix Console
    • Navigate to Trunks → Create Inbound Trunk
    • Configure your inbound trunk with your voice service provider
    • Ensure the trunk can receive calls to your desired phone numbers
  2. Create Application for Your Domain:
    • Select your domain in the Cloudonix Console
    Cloudonix console showing domain selection
    • Create a new application for your domain
    • Set the webhook URL in the application: 
      https://api.dograh.com/api/v1/telephony/inbound/{workflow_id}
    Replace {workflow_id} with your actual workflow ID. If using self-hosted Dograh, replace api.dograh.com with your domain.
    Cloudonix application creation with webhook URL configuration
  3. Verify Configuration:
    • Ensure your Dograh AI instance is publicly accessible
    • Test that webhook URL responds correctly
    • Verify any firewalls allow Cloudonix’s IP ranges
    • Confirm your inbound trunk is active and receiving calls

​
Test Inbound Calling

  1. Call your configured phone number from another phone
  2. Verify your Dograh AI voice agent answers and responds
  3. Check call logs in both Dograh AI dashboard and Cloudonix Console
  4. Confirm clear two-way audio communication

​
Troubleshooting

Ensure phone numbers include country code in E.164 format: +1234567890
  • 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
  • Verify WebSocket connection is established
  • Check firewall rules for WebSocket traffic
  • Ensure audio pipeline is configured correctly
  • Verify inbound trunk is properly configured and active
  • Check routing rules point to correct Dograh AI webhook endpoint
  • Ensure webhook URLs are publicly accessible
  • Confirm phone numbers are correctly routed to your trunk
  • Verify organization_id in webhook URLs matches your setup
  • Check that voice agent workflow is properly configured
  • Ensure SIP connection instructions are correctly returned
  • Review webhook logs for error responses

​
Best Practices

  • Store credentials securely in the database
  • Test your configuration with a single call before running campaigns
  • Monitor Cloudonix Sessions for usage