voiceai-freepbx-module

The voiceai-freepbx-module is an open-source bridge designed to connect the traditional world of PBX telephony with the cutting-edge ecosystem of Voice AI agents. By automating the complex SIP configurations required to link phone systems to AI platforms, it allows developers to bring conversational intelligence to any standard business phone line.

For the Non-Technical Reader

Think of this tool as a "universal adapter" for your office phone system. Usually, connecting a business phone to a sophisticated AI assistant requires a team of specialized engineers. This module changes that by allowing you to simply "plug in" an AI agent from providers like VAPI or ElevenLabs directly into your existing FreePBX setup. The result? A human-like AI can answer calls, book appointments, or provide support 24/7, without the need for a massive technical overhaul or manual call routing.

For the Technical Reader

This module streamlines the integration between FreePBX 17 (Asterisk) and Voice AI providers via SIP bridging. It automates the generation of pjsip_custom.conf and extensions_custom.conf entries, deploying specific AGI scripts to handle call flow logic. Key technical features include:

• Provider Diversity: Native support for VAPI (Static SIP/Digest Auth), Retell AI (Per-call AGI/Bearer tokens), ElevenLabs (SIP trunking/IP allowlisting), and Ultravox (SIP registration).
• Transport & Codecs: Supports both UDP and TCP transports with codec negotiation for ulaw, alaw, and G.722.
• Architecture: Built for PHP 7.4+ environments, utilizing the PJSIP stack for modern endpoint management.
• Automation: Handles the creation of database tables and configuration files automatically upon installation via the FreePBX CLI or GUI.

Why It Matters

This project represents a significant step in the democratization of AI telephony. By moving the integration logic into an open-source module, it reduces the "vendor lock-in" typically associated with proprietary AI communication platforms. It allows businesses to maintain control over their telephony infrastructure while swapping AI "brains" as the market evolves, significantly lowering the cost and complexity of deploying high-performance voice agents.

The Voice AI Space Lab Idea

The "Smart Small Business Hub": Use this module to build a centralized AI receptionist for a local business park. You could configure a single FreePBX instance where each business has its own extension. Using this module, you could assign a unique AI personality to each shop—a high-energy VAPI agent for the local gym and a sophisticated, calm ElevenLabs voice for the boutique law firm—all managed from one dashboard. Check out the repository here: https://github.com/Samcotech/voiceai-freepbx-module