Notify application module for the Asterisk PBX

©2005,2006,2007 Sven Slezak <sunny at mezzo.net>

Asterisk Notify is an Asterisk module which can be configured to send notifications over the network to announce the callers name and telephone number to a desktop PC.

The syntax for Notify in extensions.conf is as follows:

Notify(<callers phone number>|<callers name>|<called extension>/<hostname or ip>[:port(default:40000)])

Example:

exten => s,1000,Notify(${CALLERID(num)}|${CALLERID(name)}|${EXTEN}/sunnybook)
exten => s,1001,Notify(${CALLERID(num)}|${CALLERID(name)}|${EXTEN}/windfeebook) 
;                                      ^                 ^
;                                   the 2 pipes are nescesarry. they don't mean 'OR'.

note: the variable names in Asterisk 1.2 were CALLERIDNUM and CALLERIDNAME

The Unix client sample source code is included in the app_notify package.

Compile:

Download (see below) and unpack the package: 

tar -xzf app_notify-release.tgz
in the app_notify directory run: 
make install
Restart Asterisk or load the application module with: 
load app_notify.so
done! 
show application Notify
should print the description.

Changes and Download:

Mac version included in Asterisk PBX for Mac OS X
2.0rc1 - new version for Asterisk 1.4 (thanks to Ronny Reinertsen)
1.0 - release. MacOSX, FreeBSD, Linux support
1.0rc2 - changed gethostbyname handling
1.0rc1 - changes for Asterisk 1.2
0.9 - initial release

Mac OS-X Client

The Mac OS-X client says the callers name and pops up a transparent Window with the name, number and picture of the calling person. It uses the lokal Address Book to lookup the information.

screenshot
If you have Growl installed you can select the Growl view plug-in in the preference pane. though the built-in viewer shows bigger pictures.
AppleScript support enables you to create your own actions for a telephone call. Included are an iCal and Address Book AppleScript. The iCal script adds an event to the Asterisk calendar and the Address Book script adds unknown telephone numbers into the Asterisk group.
To activate your own AppleScripts put them into /Library/Application Support/AsteriskNotifier/Scripts in your home directory.

Additionally an Address Book dialer is included in the package. You can enable it in the preference pane. You will have to configure a manager account in the Asterisk PBX.

The client uses Bonjour (aka. Rendezvous, aka. Zeroconf) to find Asterisk servers in the network automatically. (not necessary though)
The Bonjour support for Asterisk can be added with res_bonjour

Download and installation

Download MacOSX Client 1.1 Leopard version. (Novembet 4. 2007)
To install simply double klick asterisk.prefPane.
Before installing a new version please stop the old version first.

additional notifier scripts:

To install put into /Library/Application Support/AsteriskNotifier/Scripts.

For the included AddressBook Dialer to work you need to add some configurations to Asterisk.
Include dialer_extensions.conf into you dialplan (extensions.conf): 

#include dialer_extensions.conf
Additionally you have to add an user to the manager.conf file: 
[dialer]
secret = i_dont_say
deny = 0.0.0.0/0.0.0.0
permit = 127.0.0.1/255.255.255.0
permit = 192.168.1.0/255.255.255.0
read = system,call,log,verbose,command,agent,user
write = system,call,log,verbose,command,agent,user

Windows Client using SNARL

Wim van Ommen has written a very nice interface for app_notify which uses SNARL a fancy notification system for Windows by Full Phat Products.
What Growl for Mac is SNARL for Windows.

Download and installation

Download and install SNARL first.
Than Download and unpack the NotifierServer and run 

asterisk_notifier.exe
After pressing CTRL-F10 you should see the NotifierServer registered as a SNARL Plug-in.

gastify a gnome Linux client

Jan Penschuck has written a very nice gnome client for app_notify.

Website and Download

gastify.googlepages.com 






	 \ | /
	- :-) -
	 / | \