HooDaHek version 0.7
Caller ID and Notification System for Asterisk

Copyright (C)2005
Nathan E. Pralle
http://www.nathanpralle.com/hoodahek/

OVERVIEW
HooDaHek (hoo-dah-hek, as in 'who-the-heck?') is a collection of Asterisk AGI scripts,
CGI scripts, and MySQL tables intended to implement your own in-house Caller ID
database and notification services.

FEATURES

• Alter the CallerID as a phone call comes in via a database — give a real name to the call instead of what the telco thinks it should be.
• Track how many times someone has called and when, even if they don't leave a message.
• Be notified of incoming calls, instantly, via:
  • AOL Instant Messenger (AIM)
  • Microsoft Instant Messenger (MSN)
  • Jabber
  • SMS (Text-messaging via cellphone and other devices)
  • Email (to any address, anywhere)
• Query the database to find a particular person's name, phone number, or the last calls that were made

WHY HOODAHEK?
I wrote these scripts originally to enable my household phone system to identify
who was calling, be able to modify and specify my own custom CallerID labels,
and to have the phone system alert us in various ways. (IM, email, SMS, etc.)

HooDaHek is also very useful for practical applications — I can avoid
telemarketers and headhunters, as well as the occasional call for money. <g>
I can make sure I answer my parental units or in-laws, and see
when friends have called that don't like leaving messages (grr...)
I have also been told that it is VERY handy when you are setting up a
MeetMe conference call and don't want to sit there waiting for the other
people to connect — you can instead wait for HooDaHek to alert you that
someone has called in.

NEW AS OF VERSION 0.7
HOODAHEKBOT:

• Added in Jabber support.
• Added in SMS support for US Cellular, Midwest Wireless, Verizon, and AT&T phones.
• Added in email support. You can now have notifications emailed anywhere. Handy for EmailToSMS gateways and/or pager alerts.
• Added a command, "last", to HooDaHekBot's vocabulary. The "last" command, when typed with no parameters, will show you the last incoming phone call. When typed like, "last:X", where "X" is a number, it'll show you the last X calls. IE: "last:10" will show you the last 10 calls.
• Fixed a bug with the Month being off on the call notification.
• Added signal handling for proper cleanup on exit.
• Added in massive debugging and logging for AIM connections as well as more error checking for disconnects, etc.
• Changed the sorting of the results of the "name:" and "phone:" commands to be sorted by alpha and number.
• Redid the entire configuration section of hoodahekbot.pl because it was long and incomprehensible.

HOODAHEK_DBHANDLE:

• Switched from interfacing with the 'mail' command to using SMTP to notify of a new addition to the database.
• Formatted the phone number now in notifications. Changed the wording and subject slightly.

GENERAL:

• Changed the GRANT statement in the SQL file so it wouldn't grant permissions on anything more than the CDR database.
• Decided to release HooDaHek under the "MIT License", which allows for free redistribution and modifications, for any purpose. Knock yourself out.

---

Go back to Asterisk call notification