The follow is intended as a guide to configuring Noojee Receptionist to work with Trixbox and any Free PBX based Asterisk system such as Elastix.
This guide is based on Trixbox 2.8.0.3, Asterisk 1.6.0.10 and Noojee Receptionist 3.0.5.
In order to get Noojee Receptionist (NJ Receptionist or NJR for short) running with Trixbox you need to perform the following tasks:
- Enable the Asterisk Management API (AMI)
- Add the NJ Receptionist dialplan as a custom extensions
- Install NJ Receptionist
- Create an inbound trunk to route calls to NJ Receptionists custom extension.
AMIStart by configuring the asterisk manager API (AMI).
Edit manager_custom.conf and create a manager account for NJ Receptionist to use.
From the Trixbox menu select: PBX | Config File Editor
Find the entry for 'manager_custom.conf'
Click the link to open the file for editing and paste the following code into the file.
You will need to
change the password and the permit statement. The password will be used when you install nJ Receptionist. The IP address in the permit= statement should be modified to match the IP address of the receptionist PC. You can generally leave the subnet mask alone (that's the 255.255.255.0 bit). If you have multiple receptionist PC's then you need to add a permit= line for each PC.
Trixbox manager_custom.conf[NJReception]
secret=yourpasswordhere
permit=10.10.10.0/255.255.255.0
read = system,call,log,verbose,command,agent,user,dialplan,hud
write = system,call,log,verbose,command,agent,user,originate,hud
Elastix manager_custom.conf[NJReception]
secret=yourpasswordhere
permit=10.10.10.0/255.255.255.0
read = system,call,log,verbose,command,agent,user,dialplan
write = system,call,log,verbose,command,agent,user,originate
Once you have entered the above changes click the 'Update' button at the bottom of the page to apply the changes.
Note: You must restart NJ Receptionist whenever you change the manager settings as the settings won't take affect until NJ Receptionist reconnects on start up. You may also have to force asterisk to reload the manager details by doing a 'manager reload' from the Asterisk CLI. If you are having problems dialing from NJR then try running the following from the Trixbox command line.
sudo asterisk -r
manager reload
manager show user NJReception
The last line will show you the current status of the NJ Reception user.
Install the dial planNoojee Receptionist requires a small custom dialplan to be installed into Trixbox to facilitate some of NJR's operations.
Trixbox requires all custom dialplan to be placed into the file /etc/asterisk/extensions_custom.conf.
The default install of Trixbox will already have some entries in extensions_custom.conf. Simply append the following dialplan after the existing content.
From the Trixbox menu select: PBX | Config File Editor
Find the entry for 'extensions_custom.conf'
Click the link to open the file for editing and paste the following code into the file.
[custom-trc]
; Handles inbound calls. NJR monitors this extension for calls.
exten => trc-inbound,1,Answer()
exten => trc-inbound,n,Ringing()
;exten => trc-inbound,n,StartMusicOnHold() ; enable if you want users to hear MOH whilst waiting for receptionist
exten => trc-inbound,n(start),Wait(3)
exten => trc-inbound,n,GotoIf($["${trc-running}" = ""]?return)
exten => trc-inbound,n,Wait(5)
exten => trc-inbound,n,Goto(trc-inbound,start)
exten => trc-inbound,n(return),Set(TRCSTATUS=FAILURE)
exten => trc-inbound,n,Return()
; Calls are moved to this extension when a transfer is to be performed.
exten => trc-transfer,1,Answer()
exten => trc-transfer,n(start),Dial(${dest},60,r)
exten => trc-transfer,n,Wait(10)
exten => trc-transfer,n,Goto(start)
; Play music on hold to the caller.
exten => trc-music,1,Answer()
exten => trc-music,n(start),Musiconhold()
exten => trc-music,n,Wait(30)
exten => trc-music,n,Goto(start)
; Drop the caller into a meetme room. Normally used for attended transfers.
exten => trc-meetme,1,Answer()
exten => trc-meetme,n,meetme(${room},${options})
exten => trc-meetme,n,Hangup()
; Put the caller on hold
exten => trc-hold,1,Answer()
exten => trc-hold,n(start),Ringing()
exten => trc-hold,n,Wait(30)
exten => trc-hold,n,Goto(start)
; Transfer the caller to the mailbox selected by the receptionist.
exten => trc-voicemail,1,Answer()
exten => trc-voicemail,n,Voicemail(${mailbox})
exten => trc-voicemail,n,Hangup()
; Park the call
exten => trc-park,1,Answer()
exten => trc-park,n,ParkAndAnnounce(pbx-transfer:PARKED|60||custom-trc,trc-inbound,1)
exten => trc-park,n,Hangup()
; Allows user to do a manual transfer after reception does an assisted transfer to them
; Enter 1 to start a transfer and then the extension no. to transfer the call to.
exten => 1,1,Read(dest)
exten => 1,n,UserEvent(meetmetransfer,data: ${trc-managedChannel}&${dest})
exten => 1,n,Wait(2)
exten => 1,n,Hangup()
exten => t,1,Verbose(timeout on manual transfer)
exten => t,n,Playback(beep)
exten => t,n,goto (1,1)
You now need to include the 'custom-trc' into the 'from-internal-custom' context.
At the top of extensions_custom.conf you should find the following line:
[from-internal-custom]
Just below this line add the required include as follows:
[from-internal-custom]
include=>custom-trc
Once you have entered the above changes click the 'Update' button at the bottom of the page to apply the changes.
Install Noojee ReceptionistWe are now ready to install Noojee Receptionist. As you run the configuration wizard which is launched by the installer click the Test button whenever prompted to ensure that everything is working.
Start by running the Noojee Receptionist install following all of the instructions except for:
* Do not click the 'Add Extensions' button as we have already added the extensions above.
* The last page where it instructs you to copy/print the dial plan snippets, as we have already done this.
Use the following values when prompted:
Asterisk Host Name: <the ip address of your trixbox server>
Asterisk Username: NJReception (as it appears in the square brackets from the manager_custom.conf file above)
Asterisk Password: <the value you entered in the secret= from the manager_custom.conf file above>
Inbound Extension: trc-inbound
Context: custom-trc
Internal Call Context: from-internal
Transfer Context: from-internal
------------------------- WARNING WARNING WARNING ------------------------------------
The following changes when applied will immediately start routing calls to Noojee Receptionist.
We advise that you do this out of hours.
------------------------- WARNING WARNING WARNING ------------------------------------
The last part of the work required is to direct the external calls to Noojee Receptionist.
Note: in older version of Trixbox you may need to Install the 'Miscellaneous Destinations' module and use a miscellaneous destination. Custom Destinations are now built in and have replaced Miscellaneous destinations.
Select PBX | PBX Settings
On the left hand 'sub tab' panel select the 'Tools' panel.
Select 'Custom Destination' from the Tools list.
Add a new Custom Destination with the following values.
Custom Destination: custom-trc,trc-inbound,1
Destination Quick Pick: <leave>
Description: Routes incoming calls to Noojee Receptionist
Now create a new Inbound Route (or modify an existing one) to route calls to the above Custom Destination:
Select PBX | PBX Setting.
Select the 'Setup' tab and then the 'Inbound Routes' option from the Setup list.
Click the 'Add incoming Route' button on the far right hand side.
Enter the following values for the route:
Description: route calls to Noojee Receptionist
DID Number: < the main number that calls for reception come in on>
Select the 'Custom Destination' radio button and select 'Route calls to NJ Reception' from the drop list.
Click the 'Submit' button to save the changes.
Note: the next action will update asterisk and calls will immediately start ringing on the receptionist phone!!
Save the changes and then click the infamous orange 'Apply Configuration Changes' link at the top of the page.
You are now ready to make a call into Noojee Receptionist. From an external phone (e.g. your Mobile/Cell phone) call into the above DID. The call should appear in Noojee Receptionist and you should be able to answer it by hitting the 'Enter' key on the numeric keypad (make certain that you have Num lock Off!).
Good luck.
Author