Skip to content

AstraPBX Cloud Platform

Overview

AstraPBX is Astradial's multi-tenant cloud PBX platform built on Asterisk, providing a REST API for managing organizations, trunks, DIDs, and PBX configuration.

Property Value
Host IP 89.116.31.109
Hostname devsip.astradial.com
OS Debian 13
Asterisk 20.18.2
Application Node.js (AstraPBX API)
App Path /opt/astrapbx
App Port 8000
Reverse Proxy Nginx
Database MariaDB 11.8.6 (pbx_api_db)
Swagger Docs devpbx.astradial.com/docs

API Endpoints

Method Endpoint Description
GET /api/v1/organizations List all organizations
POST /api/v1/organizations Create a new organization
POST /api/v1/organizations/:id/regenerate Regenerate org config files
GET /api/v1/trunks List all trunks
POST /api/v1/trunks Create a new trunk
GET /api/v1/dids List all DIDs
POST /api/v1/dids Create a new DID
POST /api/v1/config/deploy Deploy generated configuration
POST /api/v1/config/reload Reload Asterisk configuration

Swagger Documentation

Full interactive API documentation is available at devpbx.astradial.com/docs.

Multi-Tenant Architecture

AstraPBX generates per-organization configuration files automatically. When an organization is created or updated, the following files are generated:

  • pjsip_org.conf -- PJSIP endpoints, AORs, and auth for the organization
  • ext_org.conf -- Dialplan (extensions) for the organization
  • queues_org.conf -- Queue definitions for the organization

These files are included by Asterisk's main configuration and can be reloaded without restarting the PBX.

SIP Transports

Transport Protocol Port Notes
transport-udp UDP 5060 Primary SIP transport
transport-tcp TCP 5060 TCP SIP transport
transport-wss WSS 8089 WebSocket Secure (WebRTC)
transport-udp-alt UDP 5080 Alternate port for ISPs blocking 5060

Alternate Port 5080

Some ISPs block UDP port 5060. The alternate transport on port 5080 allows SIP clients behind such ISPs to connect.

Features

  • Call Recording -- MixMonitor-based recording for all calls
  • AI Agent -- Stasis application integration for AI-driven call handling
  • Queues -- ACD queues with configurable strategies
  • IVR -- Interactive Voice Response menus
  • DND -- Do Not Disturb per extension
  • Call Forward -- Unconditional and conditional forwarding
  • Conference -- Multi-party conference rooms
  • Voicemail -- Mailbox with email notification

Organizations

Name Context Prefix Type
Acme Corp acme_ Test
TechStart tech_ Test
AstraPrivate org_mna9x47k_ Production

Production Organization

AstraPrivate (org_mna9x47k_) is the only production organization. Exercise caution when modifying its configuration.