FlexPBX Feature Implementation Summary

Date: October 14, 2025
Status: Production Ready

---

🎯 Completed Features

1. Conditional Queue Audio System ✅

Feature Codes:

• \*45 - Queue Login (support queue)


• \*46 - Queue Logout (support queue)


• \*47 - Queue Status (support queue)

Conditional Logic:


• Different audio plays depending on current queue membership status


• Uses QUEUE_MEMBER() function to check status before taking action


• Prevents duplicate login/logout attempts

Audio Files:


• callcueue-loged-out-to-in-prompt.wav - Plays when successfully joining queue via \*45


• callcueue-login.wav - Plays when dialing \*45 but already logged in


• callcueue-loged-in-to-out-prompt.wav - Plays when successfully leaving queue via \*46


• callcueue-logout.wav - Plays when dialing \*46 but already logged out

Technical Implementation:


• Location: /etc/asterisk/extensions.conf lines 936-963


• Audio files: /var/lib/asterisk/sounds/callcueue-*


• Formats: WAV (16-bit, 8kHz, mono) and ulaw


• Permissions: asterisk:asterisk, 644

Testing:


Dial *45 first time  → Hear login success message → Added to queue
Dial *45 again       → Hear "already logged in" message → No action
Dial *46 first time  → Hear logout success message → Removed from queue
Dial *46 again       → Hear "already out" message → No action

---

2. Music on Hold Streaming System ✅

Configuration File: /etc/asterisk/musiconhold.conf

Supported Sources:


• Local audio files - MP3/WAV files in /var/lib/asterisk/moh/


• Icecast streams - Internet radio streams (MP3/OGG)


• Shoutcast streams - Traditional streaming servers


• Custom applications - mpg123 with sox for processing

MOH Classes Available:


• default - Local files, random playback


• stream-volume-quiet - 50% volume streaming


• stream-volume-normal - 70% volume streaming


• stream-volume-loud - 80% volume streaming


• stream-volume-full - 100% volume streaming


• icecast-soma-fm - Example Soma FM stream at 70% volume


• support-queue - Dedicated for support queue


• sales-queue - Dedicated for sales queue

Volume Control:
Uses sox to adjust volume during streaming:


mpg123 -q -r 8000 --mono -s -@ | sox -t raw -r 8000 -c 1 -e signed -b 16 - -t raw -r 8000 -c 1 -e signed -b 16 - vol 0.7

Web Interface: /home/flexpbxuser/public_html/admin/moh-manager.html


• Add/edit stream URLs


• Adjust volume (0-100%)


• Test playback


• Assign to queues


• Upload local files


• Reload configuration

---

3. Audio Upload Auto-Conversion ✅

Admin Interface: /home/flexpbxuser/public_html/admin/audio-upload.php
User Interface: /home/flexpbxuser/public_html/user-portal/my-recordings.php

Automatic Processing:


• Upload any audio format (MP3, WAV, OGG, etc.)


• Converts to Asterisk-optimized format:


• 8kHz sample rate


• Mono channel


• 16-bit depth


• -3dB normalization


• Creates ulaw format automatically


• Sets proper ownership (asterisk:asterisk)


• Sets proper permissions (644)


• Deploys to correct directory

Categories Supported:


• IVR Prompts - /var/lib/asterisk/sounds/custom/


• Queue Announcements - /var/lib/asterisk/sounds/


• Voicemail Greetings - /var/spool/asterisk/voicemail/{context}/{mailbox}/


• Music on Hold - /var/lib/asterisk/moh/

Technical Details:


sox input.wav -r 8000 -c 1 -b 16 output.wav norm -3
sox output.wav -r 8000 -c 1 -t ul output.ulaw

---

4. Asterisk API Integration Documentation ✅

Location: /home/flexpbxuser/publichtml/api/ASTERISKAPI_INTEGRATION.md

Documented Interfaces:


• AMI (Asterisk Manager Interface) - TCP socket on port 5038


• AGI (Asterisk Gateway Interface) - Call control from dialplan


• ARI (Asterisk REST Interface) - WebSocket + HTTP on port 8088/8089


• CLI Interface - Shell command execution

Features Documented:


• Call control (originate, hangup, transfer, park)


• Music on Hold configuration and API control


• Queue management (add/remove/pause members, status)


• Voicemail integration


• Extension/Endpoint management


• Trunk management and monitoring


• Call Detail Records (CDR) access


• Call monitoring and recording


• Audio playback applications


• Conference bridges (ConfBridge)


• Real-time event subscriptions


• Call features and pickup codes


• Security and authentication


• Database integration (AstDB and Realtime)


• WebRTC support


• System control and diagnostics


• Prometheus metrics endpoint

Code Examples Included:


• PHP AMI Manager class


• JavaScript ARI client


• AGI script template


• Dialplan integration examples

---

5. Admin Dashboard Consolidation ✅

Location: /home/flexpbxuser/public_html/admin/dashboard.html

Sections:


• Media & Audio Management


• Audio Upload Manager


• Media Manager


• Music on Hold Manager (NEW)


• PBX Configuration


• Extensions Management


• Trunks Management


• Trunks & DIDs Manager


• Inbound Routing


• Google Voice Integration


• System Tools


• System Self-Check


• Admin Client


• Documentation


• IVR Setup Guide


• ElevenLabs Guide


• User Portal Link

Design:


• Responsive grid layout


• Card-based interface


• Gradient purple theme


• Hover animations


• Badge indicators for new features

---

🔧 System Configuration

Audio File Locations




/var/lib/asterisk/sounds/          - Custom prompts and queue audio
/var/lib/asterisk/sounds/en/       - English language prompts
/var/lib/asterisk/moh/             - Music on hold files
/usr/share/asterisk/sounds/        - System default sounds
/var/spool/asterisk/voicemail/     - Voicemail greetings

Configuration Files Modified




/etc/asterisk/extensions.conf      - Dialplan with queue features
/etc/asterisk/musiconhold.conf     - MOH classes and streaming
/etc/asterisk/queues.conf          - Queue configuration

Permissions




Owner: asterisk:asterisk
Audio files: 644
Directories: 755

---

📞 Queue System Details

Queue Name: support

Members: Dynamic (agents login/logout via \45/\46)

Strategy: ringall (can be changed in queues.conf)

Features:


• Real-time login/logout with audio confirmation


• Status checking with \*47


• Conditional audio prevents confusion


• Music on hold during wait


• Agent penalty support


• Call recording capability

AMI Events Generated:


• QueueMemberAdded


• QueueMemberRemoved


• QueueCallerJoin


• AgentConnect


• QueueMemberStatus

---

🎵 Music on Hold Technical Details

Audio Processing Chain:


Stream URL → mpg123 → sox (volume adjust) → Asterisk

Format Requirements:


• Sample Rate: 8000 Hz


• Channels: 1 (mono)


• Format: slin (signed linear)


• Bit Depth: 16-bit

Example Stream Configuration:


[icecast-soma-fm]
mode=custom
application=/usr/bin/bash -c 'echo "http://ice1.somafm.com/groovesalad-128-mp3" | /home/linuxbrew/.linuxbrew/bin/mpg123 -q -r 8000 --mono -s -@ | sox -t raw -r 8000 -c 1 -e signed -b 16 - -t raw -r 8000 -c 1 -e signed -b 16 - vol 0.7'
format=slin

Local Files Configuration:


[default]
mode=files
directory=/var/lib/asterisk/moh
sort=random

---

🔄 Reload Commands

Reload dialplan:


asterisk -rx "dialplan reload"

Reload music on hold:


asterisk -rx "module reload res_musiconhold.so"

Show MOH classes:


asterisk -rx "moh show classes"

Show queue members:


asterisk -rx "queue show support"

Check queue status:


asterisk -rx "queue show"

---

🧪 Testing Procedures

Test Queue Audio



• Dial \*45 from any extension (2000-2003)


• Should hear login success message


• Verify added to queue: asterisk -rx "queue show support"


• Dial \*45 again


• Should hear "already logged in" message


• Dial \*46


• Should hear logout success message


• Verify removed from queue


• Dial \*46 again


• Should hear "already logged out" message

Test Music on Hold



• Log into support queue with \*45


• Call support queue from another extension


• Should hear music on hold


• Adjust volume in MOH Manager


• Reload MOH: asterisk -rx "module reload res_musiconhold.so"


• Test again with new volume

Test Audio Upload



• Navigate to admin/audio-upload.php


• Upload MP3/WAV file


• Select category (IVR/Queue/Custom)


• Verify conversion creates ulaw file


• Check permissions: ls -l /var/lib/asterisk/sounds/


• Test playback in dialplan

---

📊 System Status

Asterisk Version: 18.12.1
Active Extensions: 2000, 2001, 2002, 2003
Active Trunks: CallCentric (registered)
Queues Configured: support, sales
MOH Classes: 11 classes (8 streaming, 3 local files)
Audio Files: 50+ prompts including conditional queue audio

---

🔐 Security Notes

File Permissions:


• All audio files owned by asterisk:asterisk


• Upload scripts validate file types


• sox conversion sanitizes audio format


• No shell injection vulnerabilities in upload paths

Network Security:


• AMI port 5038 should be firewalled (internal only)


• ARI port 8088/8089 behind authentication


• Streaming MOH uses HTTPS when available

---

📝 Future Enhancements

Potential Additions:


• Multiple queue support (sales, support, billing)


• Queue priority and penalty management UI


• Real-time queue dashboard with AMI events


• Call recording download interface


• IVR builder with drag-and-drop


• Conference bridge management


• WebRTC softphone integration


• Mobile app for queue login/logout


• Queue statistics and reporting


• Wallboard display for queue metrics

---

📖 Documentation References

Internal Docs:


• /home/flexpbxuser/publichtml/api/ASTERISKAPI_INTEGRATION.md


• /etc/asterisk/extensions.conf - Dialplan


• /etc/asterisk/musiconhold.conf - MOH configuration


• /etc/asterisk/queues.conf - Queue settings

External Resources:


• Asterisk Documentation: https://docs.asterisk.org/


• AMI Reference: https://docs.asterisk.org/Asterisk18Documentation/APIDocumentation/AMIActions/


• ARI Reference: https://docs.asterisk.org/Asterisk18Documentation/APIDocumentation/AsteriskREST_Interface/

---

Maintained by: FlexPBX Development Team
Last Updated: October 14, 2025
Version: 1.0