apunkt/dograh
1
0
Fork 0
mirror of https://github.com/dograh-hq/dograh.git synced 2026-07-10 11:12:13 +02:00
Code Issues Projects Releases Packages Wiki Activity

chore: update documentation for telephony

Browse source
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
Download patch file Download diff file Expand all files Collapse all files

19
docs/integrations/telephony/plivo.mdx
View file

@ -13,7 +13,7 @@ Before setting up Plivo integration, you'll need:
- A [Plivo account](https://www.plivo.com/)
- Auth ID and Auth Token from your Plivo Console
- A Plivo **Application** with Voice capability (used for inbound webhook routing)
- A Plivo **Application** with Voice capability (optional — leave the field blank in Dograh and we'll auto-create one for you on save, with the `answer_url` pre-set)
- At least one Plivo phone number
- Dograh AI instance running and accessible
@ -23,9 +23,8 @@ Before setting up Plivo integration, you'll need:
1. Log in to your [Plivo Console](https://console.plivo.com/)
2. Find your **Auth ID** and **Auth Token** on the dashboard
3. Navigate to **Voice** → **Applications** and create (or open) the application you'll use with Dograh
4. Copy the **Application ID** (a UUID) — you'll attach numbers to this app and Dograh will manage its `answer_url`
5. Navigate to **Phone Numbers** → **Your Numbers** and copy the numbers you plan to use
3. (Optional) Navigate to **Voice** → **Applications** and create (or open) the application you'll use with Dograh, then copy its **Application ID** (a UUID). Skip this if you want Dograh to auto-create the application for you on save.
4. Navigate to **Phone Numbers** → **Your Numbers** and copy the numbers you plan to use
### Step 2: Configure in Dograh AI
@ -34,10 +33,18 @@ Before setting up Plivo integration, you'll need:
3. Enter your credentials:
- Auth ID
- Auth Token
- Application ID
- Application ID — *optional*. Leave blank and Dograh will auto-create a Plivo Application on save (with the `answer_url` already configured) and store its Application ID on this configuration.
4. Click **Save Configuration**
5. 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 Plivo Application for you, you still need to
link your Plivo numbers to that application in the Plivo Console under
**Phone Numbers** → **Your Numbers**. The auto-created application is
named `dograh-<random>` — its Application ID is shown on the saved
configuration.
</Note>
### Step 3: Test Your Configuration
1. Create a test workflow
@ -46,7 +53,7 @@ Before setting up Plivo integration, you'll need:
## Inbound Calling Setup
Plivo numbers don't carry an `answer_url` directly — the URL lives on a Plivo **Application**, and each number is linked to one application. **When you save an inbound workflow on a phone number, Dograh automatically pushes the webhook URL to your Plivo Application's `answer_url`** (provided the credentials are correct). You don't need to set the webhook by hand.
Plivo numbers don't carry an `answer_url` directly — the URL lives on a Plivo **Application**, and each number is linked to one application. **When you save an inbound workflow on a phone number, Dograh automatically pushes the webhook URL to your Plivo Application's `answer_url`** (provided the credentials are correct). You don't need to set the webhook by hand. If Dograh auto-created the application during configuration save, the `answer_url` is already set and this push is a no-op.
### Step 1: Link the Phone Number to Your Plivo Application