Every person who needs to make or receive calls needs a user account with a SIP extension. An extension is a short number (like 1001, 1002) that identifies each person in your phone system.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.
Create a new user
Click Add User
Click the Add User button (the plus icon) in the top-right corner. A dialog box will open.
Fill in the basic details
| Field | What to enter | Example |
|---|---|---|
| Full Name | The person’s name | John Doe |
| Extension | A unique 3-4 digit number | 1001 |
| Username | A login username | johndoe |
| Their email address | [email protected] | |
| Password | At least 6 characters | (a secure password) |
| Role | Their permission level | Agent |
Choose call routing
Under Call Routing, select how calls to this extension should be handled:
- SIP / IP Phone — The person uses a SIP app (like Zoiper) on their phone or computer. This is the most common option.
- AI Bot (WSS URL) — Calls go to an AI voice bot instead of a human. You need to enter the bot’s WebSocket URL.
- Phone Call (Mobile) — Calls ring the person’s mobile phone number directly.
Set up a SIP phone
After creating a user, they need to register a SIP phone app to start making calls.Open the QR code
In the Users table, click the three-dot menu (actions) next to the user, then click SIP QR Code.
Download a SIP app
Install one of these free SIP apps on your phone:
- Zoiper (iOS / Android) — Recommended
- Opal (iOS)
- Opal SIP (Android)
- Any standard SIP softphone
Scan the QR code
Open your SIP app and scan the QR code shown in the dialog. The app will automatically configure itself with the correct server, username, and password.
Or enter credentials manually
If your app doesn’t support QR scanning, enter these details manually. You can copy each value by hovering over it and clicking the copy button:
| Field | Value |
|---|---|
| Server | Your Astradial server hostname or IP |
| Port | 5060 (default) |
| Username | The user’s Asterisk endpoint name |
| Password | The SIP password (auto-generated) |
| Transport | UDP |
Edit a user
- Click the three-dot menu next to any user in the table
- Click Edit
- Change any field — name, extension, email, role, routing, or password
- Click Save
- The configuration is automatically redeployed to Asterisk
To change the password, enter a new one in the Password field. Leave it blank to keep the current password.
Delete a user
- Click the three-dot menu next to the user
- Click Delete
- Confirm the deletion
Understanding roles
When you create a user, you assign them a role. Each role has different permissions:| Role | What they can do |
|---|---|
| Admin | Full access to everything except API key management |
| Supervisor | Monitor calls, manage teams, view reports |
| Agent | Handle calls, view own call history, use click-to-call |
| User | Basic access, view own profile |
Call routing options explained
| Routing type | When to use it | What happens |
|---|---|---|
| SIP / IP Phone | Person uses Zoiper or a desk phone | Calls ring their SIP app |
| AI Bot (WSS URL) | Extension should be handled by an AI bot | Calls connect to the bot via WebSocket |
| Phone Call (Mobile) | Person doesn’t have a SIP app | Astradial calls their mobile number |