Creating an IVR takes about 5 minutes. You’ll use the visual node editor to design the menu, then publish it to the live dialplan.Documentation Index
Fetch the complete documentation index at: https://docs.astradial.com/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
- Your organization is active in the Astradial dashboard.
- You have at least one extension, queue, or external number you want the IVR to route to.
Step 1 — Open the IVR section
Step 2 — Set the basics
In the Settings panel on the right:| Field | What to enter |
|---|---|
| Name | Human-readable label, e.g. “Main Menu” |
| Extension | 4-digit internal number, e.g. 7001. Must be unique within your org. |
| Description | Optional short note |
| Timeout (s) | How many seconds to wait for a digit after the greeting plays (default 10). Set to 0 for wait-forever. |
| Max retries | Dropdown: 1 / 2 / 3 attempts. Greeting repeats on no-response, hangs up after N. |
| Direct extension dial | If enabled, callers can dial any 4-digit extension directly from inside the IVR without going through a menu option. |
Step 3 — Generate the greeting
Select the Greeting node in the visual builder.- Pick a Language (English India, English US, Hindi, etc.).
- Pick a Voice (Wavenet D is a good default).
- Type the greeting text, e.g.:
Welcome to Acme. Press 1 for sales, 2 for support, 3 for billing. To repeat this menu, press star.
- Click Preview to hear the TTS output in your browser.
- When you’re happy, click Generate greeting. The audio is saved as a
.wavfile on the server and stored on the IVR record.
You can regenerate the greeting any time — the new audio replaces the old one. Previewing the voice does not overwrite the saved greeting.
Step 4 — Add menu options
For each digit (1-9, 0,*, #):
Pick the destination
Dropdown shows only valid targets for the selected action type. E.g. picking “Queue” shows your org’s queues by number and name.
Step 5 — Publish
Click Publish (top-right). This regenerates your organization’s dialplan and tells the PBX about the new IVR. Until you publish, the IVR is only a draft — calls to any phone number routed to it will hear “number not in service”.Step 6 — Point a phone number at the IVR
Go to Phone Numbers in the sidebar, open your DID’s routing settings, set:- Routing type: IVR
- Destination: pick your new IVR from the dropdown (shows as
<extension> — <name>)
Troubleshooting
The call connects but no greeting plays
Most common cause: the greeting wasn’t actually generated. Open the IVR, confirm a.wav file URL is set on the greeting node. If not, click Generate greeting.
Second most common cause: the IVR was saved but not published. Click Publish and retry the call.
Digit presses don’t route
Make sure you clicked Save on each menu option AND Publish after adding them. The visual builder shows unsaved changes with an unsaved indicator.”Number not in service” when calling the DID
The DID’s routing is set but the IVR isn’t published. Publish the IVR, then try again.The IVR hangs up immediately
Check your Timeout setting — if it’s set to 0 the call waits forever (correct), but if it’s set to something tiny (1-2s) callers don’t have time to press.What’s next
- Add greetings with TTS — customize voice and language.
- Design menu routing — best practices for digit assignment.
- IVR API reference — build IVRs via API.