Organization Settings

Access the Settings page from the sidebar navigation. This page is available only to the organization owner.

Cloudonix Integration

The Cloudonix Integration section connects your OPBX organization to the Cloudonix CPaaS platform. This integration enables voice calling capabilities.

Configuration Fields

Field	Description	Source
Domain UUID	Unique identifier for your Cloudonix domain	Cloudonix Cockpit
Domain Name	Human-readable domain name	Auto-populated from Cloudonix
Domain API Key	Authentication token for Cloudonix API	Cloudonix Cockpit
Webhook API Key	Secret for verifying Cloudonix callbacks	Auto-generated by OPBX
Voice Application	Cloudonix voice application for call handling	Auto-created on validation
No-answer Timeout	Seconds to wait before no-answer routing	Configurable
Recording Format	Audio format for call recordings	Configurable

Domain UUID

Enter the Domain UUID from your Cloudonix Cockpit. This identifies which Cloudonix domain to use for voice services.

Domain API Key

The Domain API Key authenticates OPBX to the Cloudonix API. This key is:

• Encrypted at rest using AES-256 encryption
• Masked with asterisks in the UI after saving
• Required for all voice operations

Webhook API Key

OPBX auto-generates a Webhook API Key when you save Cloudonix credentials. This key:

• Secures incoming webhooks from Cloudonix
• Validates that callbacks originate from Cloudonix
• Is encrypted at rest like the Domain API Key

Voice Application

When you validate your Cloudonix credentials, OPBX automatically creates a Voice Application in Cloudonix. This application:

• Receives call events from Cloudonix
• Routes calls through OPBX logic
• Uses the webhook URL for callbacks

Validating Credentials

Click Validate Credentials to test your Cloudonix API key. OPBX will:

1. Connect to the Cloudonix API
2. Verify the domain exists and is accessible
3. Create or update the Voice Application
4. Display a success or error message

tip

Always validate credentials after making changes to ensure connectivity.

Webhook URL

The webhook URL tells Cloudonix where to send call events. OPBX auto-resolves this URL from:

1. OPBX_APPLICATION_WEBHOOK_BASEURL environment variable (if set)
2. APP_URL environment variable (fallback)

You can override the auto-resolved URL in the settings if needed. The webhook URL must:

• Be publicly accessible from the internet
• Use HTTPS in production
• Route to your OPBX instance

Outbound Trunks

The Outbound Trunks section displays voice trunks available from your Cloudonix domain. These trunks:

• Determine which carriers handle outbound calls
• May have different pricing and coverage
• Can be selected per outbound route

warning

Only the organization Owner can access the Settings page. Cloudonix API keys are encrypted at rest and masked with asterisks in the UI.