/
PBX GUI - Superfecta Extensions

PBX GUI - Superfecta Extensions

These examples were tested on PBXact 16 but should work on versions 15+.

Saddle up, we’re about to send out emails to custom addresses whenever a particular Extension starts ringing - using CID Superfecta

This is an advanced example and might break your system. Please deploy at off-peak hours and test your work thoroughly.

Introduction

CID Superfecta was originally designed for Caller ID (CID) interaction on incoming calls from the PSTN to your PBX.

By utilizing Local channels in ASTERISK - a core feature - we can extend CID Superfecta to support interaction on both external and internal calls to phones. Find Me Follow Me and other modules already use Local channels behind the scenes, so either of the methods outlined below should work on most systems.

There are many ways to send alerts when extensions are dialed, including the use of custom dialplan, Custom Destinations, etc; however, these CID Superfecta approaches use standard modules with only one minor customization and no direct configuration file editing.

Supplies Checklist

FreePBX or PBXact
CID Superfecta module (under Admin → CID Superfecta)
Working outbound emails from your PBX eg. Voicemail-to-Email is working
At least one Extension
At least one Inbound Route from the telco configured to point to the Extension

Method I: New CUSTOM Extension

Step 1: Add new CID Superfecta Scheme focused on email notification

Navigate to Admin → CID Superfecta. Click the “+ Add Scheme” button in the upper-right corner as shown in Figure 1.A.

Screenshot_2025-03-11_15-51-25.png
Figure 1.A: Add Scheme

Type in a New Scheme Name eg. PseudoEmailFecta and hit the Submit button at bottom of the page as shown in Figure 1.B. Default settings are fine.

Screenshot_2025-03-11_15-55-26.png
Figure 1.B: Adding a new Scheme to CID Superfecta called PseudoEmailFecta

Organize scheme

Open and configure the new scheme. Set the Abandon lookup and Send to email data sources as Enabled and in 1-2 priority order per Figure 1.C by scrolling around and clicking your mouse a few times on the appropriate buttons (Yes, , , etc.)

Screenshot_2025-03-15_12-29-28.png
Figure 1.C: Enabling two modules in the new PseudoEmailFecta CID Superfecta Scheme.

OPTIONAL: Click on the wrench icon next to the Abandon lookup data source and consider changing from the default word “unknown” – as shown in Figure 1.D – to something like “PseudoFecta”. Click Save when done.

Screenshot_2025-03-15_12-29-48.png
Figure 1.D: Changing the CNAM (Caller ID Name) in Abandon lookup data source.

Send to email data source

REQUIRED: Click on the wrench icon next to the Send to email data source and enter an email address as shown in Figure 1.E below. Click Save when done.

Screenshot_2025-03-15_12-31-18.png
Figure 1.E: Configure an email address to receive your notifications in the Send to email data source.

Interesting side note: Changing the email address here does not require an “Apply Config” reload of your system. When you click Save the changes are placed in to your database, but they are not utilized by your PBX until the next call comes in that executes a script concerning this particular scheme’s module(s).

 

Step 2: Add pseudo Inbound Route that triggers CID Superfecta then immediately Hangs Up

Navigate to Connectivity → Inbound Routes and click the button to “+ Add Inbound Route” as shown in Figure 2.A.

Screenshot_2025-03-11_15-37-29.png
Figure 2.A: Add Inbound Route

Choose your number

In the Inbound Routes page “General” tab as seen in Figure 2.B, Pick a number not already in use on your system that is unreachable via any known telco route to your system eg. a Hollywood number like 555-2368 (Or choose something that looks like your extension but has extra digits in the front eg. 10001234).

Then change Set Destination to Terminate Call - Hangup. You may also want to enter a Description in the first entry box at the top.

Figure 2.B: Adding Inbound Route that terminates immediately.

Connect route to scheme

Click the Other tab as shown in Figure 2.C and set Enable Superfecta Lookup to Yes and select the new CID Superfecta Scheme PseudoEmailFecta that you made above in Step 1 PBX GUI - Superfecta Extensions | Step 1: Add new CID Superfecta Scheme focused on email notification 📧

Figure 2.C: Enabling Superfecta and choosing the new Superfecta Scheme.

 

Step 3: Add CUSTOM Extension to Dial the new Inbound Route using Local channels

Navigate to Applications → Extensions. Instead of standard extension using default PJSIP technology, you need to Add New Custom Extension per Figure 3.A.

Screenshot_2025-03-15_13-55-24.png
Figure 3.A: Add New Custom Extension.

Enter the pseudo Inbound Route number you chose above in Step 2 PBX GUI - Superfecta Extensions | Choose your number per Figure 3.B.

Screenshot_2025-03-15_12-49-00.png
Figure 3.B: New CUSTOM Extension 5552368.

Local channel dial string

Click on the Advanced tab and enter the Local channel information per Figure 3.C. DO NOT ASSIGN A DID ON THIS TAB. Enter only the Dial string by substituting your number, for example:

Local/5552368@ext-did

The “Local/” part before the number and the “@ext-did” part after the number are very important.

The “Local/” part is specifying the Local channel technology. This is a part of Asterisk that lets you connect to your dial plan and is used in a number of areas of FreePBX.

The “@ext-did” is the context (section) of the dial plan that you are connecting to. This specific context is used by external direct inward dial numbers AKA phone numbers from the phone company that external people call to reach your PBX from their own phones.

Screenshot_2025-03-15_12-50-49.png
Figure 3.C: Local dial string format in Advanced tab of new CUSTOM Extension.

Assigning a DID here would result in a continuous loop of your dial plan. Such loops can lock-up your PBX and require a hard restart.

This idea of using CUSTOM extensions to dial your external numbers in a single-loop-back manner could also be useful if you want to “intercept” some calls to the PSTN and redirect them to your own PBX services.

 

Step 4: Add a Find Me/Follow Me entry to any extensions that you want notifications about

Enable Find Me/Follow Me on an existing extension that you want to get email about whenever that phone is ringing per Figure 4.A. Be sure to include the extension number itself if you still want it to ring (which you probably do!) Adjust the other settings to your liking.

Screenshot_2025-03-15_12-53-56.png
Figure 4.A: First line in Follow-Me List shows the new 5552368 pseudo CUSTOM extension.

If you set Initial Ring Time to 0, then you’ll get notified immediately when the call comes in to the extension.

Step 5: Test your work

Make some test calls. Check your emails.

 

Method II: Extend Existing Extension Dial Line

Largely the same process as Method I, this option might be a little quicker to setup but take more time to manage long term. It also avoids Find Me Follow Me so you’ll always be notified immediately when the calls come in (which may or may not be what you want.)

Step 1: Same as Method I Step 1

PBX GUI - Superfecta Extensions | Step 1: Add new CID Superfecta Scheme focused on email notification 📧

Step 2: Same as Method I Step 2

PBX GUI - Superfecta Extensions | Step 2: Add pseudo Inbound Route that triggers CID Superfecta then immediately ...

Step 3: Overload the Dial line for an existing extension

Hold on tight! Almost there!

You will be setting up a parallel dial of both the existing extension and the pseudo inbound route. No Find Me/Follow Me is required; however, this is kind of how FMFM works internally, using parallel dials, if you care to read the generated dial plan of such things.

First, choose the existing extension you want to be notified about. Navigate to the Advanced tab for the extension.

Enter the Local channel dial information as an additional argument to the standard Dial line for the extension as shown below in Figure II. Enter only the Dial string by substituting your number, for example:

PJSIP/111&Local/5552368@ext-did

The “PJSIP/111” part is the first leg of the call and (probably) the existing direct dial of extension 111.

The “&” part means that two separate legs will be dialed in parallel.

The “Local/5552368@ext-did” part is the second leg and very similar to Method I Step 3 PBX GUI - Superfecta Extensions | Local channel dial string

Screenshot_2025-03-15_10-37-58.png
Figure II: Parallel dial of existing extension and pseudo inbound route.

Step 4: Test your work

Make some test calls. Check your emails.

 

Conclusion

Please test your setup thoroughly by:

Dialing through multiple normal call flows
Opening your email spam/junk folders for any notifications
Looking at Busy Line Field (BLF) lights on phones during test calls
Review your Scribes, CDRs, CEL reports, etc., because subtle changes in dial lines can make big changes in how calls are logged
Revisiting the system in a day or two to proactively address any issues