chore: update documentation for telephony

This commit is contained in:
Abhishek Kumar 2026-05-02 16:59:17 +05:30
parent 7fd3b96470
commit 6ecd5c2fa6
9 changed files with 108 additions and 26 deletions

View file

@ -16,7 +16,7 @@ Before setting up Cloudonix integration, you'll need:
- A [Cloudonix account](https://cockpit.cloudonix.io/onboarding?affiliate=DOGRAH)
- A Cloudonix domain UUID (or the domain name)
- A Cloudonix domain API Key (Bearer Token)
- A Cloudonix **Voice Application** on that domain — Dograh will manage its `url`
- A Cloudonix **Voice Application** on that domain (optional — leave the field blank in Dograh and we'll auto-create one for you on save, with the application `url` pre-set)
- A Cloudonix outbound voice trunk service provider connection
- Dograh AI instance running and accessible
@ -38,8 +38,7 @@ Watch this step-by-step guide to set up Cloudonix with Dograh AI:
1. Log in to your [Cloudonix Console](https://cockpit.cloudonix.io/onboarding?affiliate=DOGRAH)
2. Find your **Domain ID** (UUID or domain name) and **Bearer Token** (Domain API Key) on the dashboard
3. Navigate to your domain's **Applications** and create (or open) the application you'll use with Dograh
4. Copy the **Application Name** — Dograh will manage this application's `url`
3. (Optional) Navigate to your domain's **Applications** and create (or open) the application you'll use with Dograh, then copy its **Application Name**. Skip this if you want Dograh to auto-create the Voice Application for you on save.
### Step 2: Configure in Dograh AI
@ -49,10 +48,18 @@ Watch this step-by-step guide to set up Cloudonix with Dograh AI:
4. Enter your credentials:
- Bearer Token
- Domain ID
- Application Name
- Application Name — *optional*. Leave blank and Dograh will auto-create a Voice Application on save (with the application `url` and CXML runtime already configured) and store its name on this configuration.
5. Click **Save Configuration**
6. Open the configuration you just created and add at least one **phone number** (with country code in E.164 format, e.g. `+1234567890`). The default caller ID is used for outbound calls.
<Note>
If Dograh auto-created the Voice Application for you, you still need to
bind your DNIDs to that application in the Cloudonix cockpit (see
[Step 2 of Inbound Calling Setup](#step-2-create-the-voice-application-and-link-dnids)).
The auto-created application is named `dograh-<random>` — its name is
shown on the saved configuration.
</Note>
### Step 3: Test Your Configuration
1. Create a test workflow
@ -61,7 +68,7 @@ Watch this step-by-step guide to set up Cloudonix with Dograh AI:
## Inbound Calling Setup
Cloudonix routes inbound calls per **Voice Application** — the webhook URL is set once on the application, and applies to every DNID bound to it. **When you save an inbound workflow on a phone number, Dograh automatically pushes the webhook URL to your Voice Application's `url`** (provided the credentials are correct), so you don't need to set the webhook by hand.
Cloudonix routes inbound calls per **Voice Application** — the webhook URL is set once on the application, and applies to every DNID bound to it. **When you save an inbound workflow on a phone number, Dograh automatically pushes the webhook URL to your Voice Application's `url`** (provided the credentials are correct), so you don't need to set the webhook by hand. If Dograh auto-created the application during configuration save, the `url` is already set and this push is a no-op — you only need to bind your DNIDs to the auto-created application.
### Step 1: Set Up the Inbound Trunk